콘텐츠로 이동
XOOPS 2.7 Docs

CSS 및 SCSS 지침

XOOPS는 SCSS 전처리를 통해 최신 CSS 표준을 따르며 유지 관리성과 성능에 중점을 둡니다.

개요

섹션 제목: “개요”

XOOPS CSS 표준은 다음을 강조합니다.

  • 조직을 위한 SCSS 전처리
  • 이름 지정을 위한 BEM 방법론
  • 모바일 우선 반응형 디자인
  • 접근성 및 의미 HTML
  • 성능 최적화

파일 구조

섹션 제목: “파일 구조”

SCSS 조직

섹션 제목: “SCSS 조직”
styles/
├── abstracts/           # Variables, mixins, functions
│   ├── _variables.scss
│   ├── _mixins.scss
│   └── _functions.scss
├── base/                # Reset, typography, defaults
│   ├── _reset.scss
│   ├── _typography.scss
│   └── _base.scss
├── components/          # Reusable components
│   ├── _button.scss
│   ├── _form.scss
│   ├── _card.scss
│   └── _navigation.scss
├── layout/              # Page layout
│   ├── _header.scss
│   ├── _footer.scss
│   ├── _sidebar.scss
│   └── _container.scss
├── pages/               # Page-specific styles
│   ├── _home.scss
│   ├── _dashboard.scss
│   └── _admin.scss
└── main.scss            # Import all files

파일 이름 지정

섹션 제목: “파일 이름 지정”
// Use lowercase with hyphens
_button.scss        // Component
_modal-dialog.scss  // Multi-word component
_colors.scss        // Variables

명명 규칙

섹션 제목: “명명 규칙”

BEM 방법론

섹션 제목: “BEM 방법론”

BEM = 블록 요소 수정자

// Block: Standalone component
.button { }


// Block__Element: Child of block
.button__text { }
.button__icon { }


// Block--Modifier: Variation of block
.button--primary { }
.button--disabled { }
.button--small { }


// Complex example
.card { }
.card__header { }
.card__body { }
.card__footer { }
.card--highlighted { }
.card--loading { }

이름 지정 모범 사례

섹션 제목: “이름 지정 모범 사례”
// ✅ Descriptive BEM naming
.form-field { }
.form-field__label { }
.form-field__input { }
.form-field--disabled { }
.form-field--error { }


// ❌ Avoid
.form-f { }                 // Too abbreviated
.form_field { }             // Use hyphens, not underscores
.formField { }              // Don't use camelCase
.form-field-2 { }           // Don't use numbers for variants
.form-field.active { }      // Use modifiers, not classes

서식 지정

섹션 제목: “서식 지정”

기본 구조

섹션 제목: “기본 구조”
.component {
  // 1. Positioning and layout
  display: flex;
  position: relative;
  top: 0;
  left: 0;


  // 2. Box model
  width: 100%;
  height: auto;
  padding: 1rem;
  margin: 0.5rem;
  border: 1px solid;


  // 3. Typography
  font-size: 1rem;
  line-height: 1.5;
  color: #333;


  // 4. Visual effects
  background: #fff;
  border-radius: 4px;
  box-shadow: none;


  // 5. Animations
  transition: all 0.3s ease;
}

간격 및 들여쓰기

섹션 제목: “간격 및 들여쓰기”
// Use 2 spaces for indentation
.component {
  padding: 1rem;


  &__child {
    margin: 0.5rem;
  }
}


// Properties on separate lines
.component {
  display: flex;        // ✅
  color: red;
  font-size: 1rem;
}


// ❌ Don't compact
.component { display: flex; color: red; }

선택자

섹션 제목: “선택자”
// One selector per line
.button,
.button-group,
.button-list {
  // ...
}


// Don't skip lines between selectors
// ✅
.component {
}


.component__element {
}


// ❌
.component {
}




.component__element {
}

변수

섹션 제목: “변수”

변수 이름 지정

섹션 제목: “변수 이름 지정”
// Use descriptive names
$color-primary: #0066cc;
$color-secondary: #666666;
$color-danger: #dc3545;


$font-base: 16px;
$font-size-small: 0.875rem;
$font-size-large: 1.25rem;


$spacing-unit: 0.5rem;
$spacing-small: 0.5rem;
$spacing-medium: 1rem;
$spacing-large: 2rem;


$border-radius-small: 2px;
$border-radius-medium: 4px;
$border-radius-large: 8px;


$transition-duration: 0.3s;
$transition-timing: ease-in-out;

가변 조직

섹션 제목: “가변 조직”
_variables.scss
// Colors
$color-primary: #0066cc;
$color-secondary: #666666;


// Typography
$font-family-base: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
$font-size-base: 1rem;
$line-height-base: 1.5;


// Spacing
$spacing-unit: 0.5rem;
$spacing-xs: $spacing-unit;
$spacing-sm: $spacing-unit * 2;
$spacing-md: $spacing-unit * 4;
$spacing-lg: $spacing-unit * 8;


// Breakpoints
$breakpoint-sm: 576px;
$breakpoint-md: 768px;
$breakpoint-lg: 992px;
$breakpoint-xl: 1200px;

색상

섹션 제목: “색상”

컬러 시스템

섹션 제목: “컬러 시스템”
// Primary palette
$color-primary: #0066cc;
$color-primary-dark: #004499;
$color-primary-light: #3399ff;


// Secondary palette
$color-secondary: #666666;
$color-secondary-dark: #333333;
$color-secondary-light: #999999;


// Semantic colors
$color-success: #28a745;
$color-warning: #ffc107;
$color-danger: #dc3545;
$color-info: #17a2b8;


// Neutral colors
$color-white: #ffffff;
$color-black: #000000;
$color-gray-100: #f8f9fa;
$color-gray-200: #e9ecef;
$color-gray-300: #dee2e6;
$color-gray-400: #ced4da;
$color-gray-500: #adb5bd;
$color-gray-600: #6c757d;
$color-gray-700: #495057;
$color-gray-800: #343a40;
$color-gray-900: #212529;


// Usage
.button {
  background-color: $color-primary;
  color: $color-white;


  &:hover {
    background-color: $color-primary-dark;
  }


  &--danger {
    background-color: $color-danger;
  }
}

타이포그래피

섹션 제목: “타이포그래피”

글꼴 선언

섹션 제목: “글꼴 선언”
// Define typography variables
$font-family-base: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
$font-family-monospace: 'Courier New', monospace;


// Font sizes
$font-size-base: 1rem;      // 16px
$font-size-small: 0.875rem; // 14px
$font-size-large: 1.25rem;  // 20px


$line-height-base: 1.5;
$line-height-tight: 1.25;
$line-height-loose: 1.75;


// Font weights
$font-weight-light: 300;
$font-weight-normal: 400;
$font-weight-semibold: 600;
$font-weight-bold: 700;

제목 계층 구조

섹션 제목: “제목 계층 구조”
h1, .h1 {
  font-size: 2rem;
  line-height: 1.2;
  font-weight: $font-weight-bold;
  margin-bottom: $spacing-lg;
}


h2, .h2 {
  font-size: 1.5rem;
  line-height: 1.3;
  font-weight: $font-weight-bold;
  margin-bottom: $spacing-md;
}


h3, .h3 {
  font-size: 1.25rem;
  line-height: 1.4;
  font-weight: $font-weight-semibold;
  margin-bottom: $spacing-md;
}


p {
  font-size: $font-size-base;
  line-height: $line-height-base;
  margin-bottom: $spacing-md;
}


small {
  font-size: $font-size-small;
}

믹스인

섹션 제목: “믹스인”

일반적인 믹스인

섹션 제목: “일반적인 믹스인”
// Responsive breakpoint mixin
@mixin respond-to($breakpoint) {
  @if $breakpoint == 'sm' {
    @media (min-width: $breakpoint-sm) { @content; }
  } @else if $breakpoint == 'md' {
    @media (min-width: $breakpoint-md) { @content; }
  } @else if $breakpoint == 'lg' {
    @media (min-width: $breakpoint-lg) { @content; }
  } @else if $breakpoint == 'xl' {
    @media (min-width: $breakpoint-xl) { @content; }
  }
}


// Usage
.component {
  font-size: 0.875rem;


  @include respond-to('md') {
    font-size: 1rem;
  }


  @include respond-to('lg') {
    font-size: 1.125rem;
  }
}


// Flexbox mixin
@mixin flex-center {
  display: flex;
  align-items: center;
  justify-content: center;
}


// Usage
.modal__overlay {
  @include flex-center;
  height: 100vh;
}


// Truncate text mixin
@mixin truncate {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}


// Usage
.breadcrumb__item {
  @include truncate;
  max-width: 200px;
}


// Clearfix mixin (legacy)
@mixin clearfix {
  &::after {
    content: '';
    display: table;
    clear: both;
  }
}

반응형 디자인

섹션 제목: “반응형 디자인”

모바일 우선 접근 방식

섹션 제목: “모바일 우선 접근 방식”
// Base styles (mobile)
.component {
  font-size: 0.875rem;
  padding: $spacing-sm;
}


// Tablets and up
@include respond-to('md') {
  .component {
    font-size: 1rem;
    padding: $spacing-md;
  }
}


// Desktops and up
@include respond-to('lg') {
  .component {
    font-size: 1.125rem;
    padding: $spacing-lg;
  }
}

중단점 시스템

섹션 제목: “중단점 시스템”
// Define breakpoints
$breakpoints: (
  'xs': 0,
  'sm': 576px,
  'md': 768px,
  'lg': 992px,
  'xl': 1200px,
  'xxl': 1400px,
);


// Flexible mixin for any breakpoint
@mixin media($breakpoint) {
  $min-width: map-get($breakpoints, $breakpoint);
  @media (min-width: $min-width) {
    @content;
  }
}


// Usage
.component {
  width: 100%;


  @include media('md') {
    width: 50%;
  }


  @include media('lg') {
    width: 33.333%;
  }
}

구성 요소

섹션 제목: “구성 요소”

버튼 구성요소

섹션 제목: “버튼 구성요소”
.button {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: $spacing-sm $spacing-md;
  border: 1px solid transparent;
  border-radius: $border-radius-medium;
  font-size: $font-size-base;
  font-weight: $font-weight-semibold;
  text-decoration: none;
  cursor: pointer;
  transition: all $transition-duration $transition-timing;


  &:hover {
    opacity: 0.9;
  }


  &:focus {
    outline: none;
    box-shadow: 0 0 0 3px rgba($color-primary, 0.25);
  }


  &:disabled {
    opacity: 0.5;
    cursor: not-allowed;
  }


  // Variants
  &--primary {
    background-color: $color-primary;
    color: $color-white;


    &:hover {
      background-color: $color-primary-dark;
    }
  }


  &--secondary {
    background-color: $color-secondary;
    color: $color-white;
  }


  &--danger {
    background-color: $color-danger;
    color: $color-white;
  }


  &--small {
    padding: $spacing-xs $spacing-sm;
    font-size: $font-size-small;
  }


  &--large {
    padding: $spacing-md $spacing-lg;
    font-size: $font-size-large;
  }


  // Icons
  &__icon {
    margin-right: 0.5em;


    &:last-child {
      margin-right: 0;
      margin-left: 0.5em;
    }
  }
}

양식 구성 요소

섹션 제목: “양식 구성 요소”
.form-group {
  margin-bottom: $spacing-lg;
}


.form-field {
  display: flex;
  flex-direction: column;


  &__label {
    font-weight: $font-weight-semibold;
    margin-bottom: 0.5rem;
    color: $color-secondary-dark;
  }


  &__input,
  &__select,
  &__textarea {
    padding: $spacing-sm;
    border: 1px solid #ddd;
    border-radius: $border-radius-medium;
    font-size: $font-size-base;
    font-family: inherit;
    transition: border-color $transition-duration;


    &:focus {
      outline: none;
      border-color: $color-primary;
      box-shadow: 0 0 0 3px rgba($color-primary, 0.1);
    }


    &:disabled {
      background-color: #f5f5f5;
      cursor: not-allowed;
    }
  }


  &__help {
    font-size: $font-size-small;
    color: $color-gray-600;
    margin-top: 0.25rem;
  }


  &--error {
    .form-field__input,
    .form-field__select {
      border-color: $color-danger;


      &:focus {
        box-shadow: 0 0 0 3px rgba($color-danger, 0.1);
      }
    }


    .form-field__error {
      color: $color-danger;
      font-size: $font-size-small;
      margin-top: 0.25rem;
    }
  }


  &--disabled {
    opacity: 0.6;
    cursor: not-allowed;
  }
}

모범 사례

섹션 제목: “모범 사례”

하세요

섹션 제목: “하세요”
  • 색상, 간격, 글꼴에 SCSS 변수 사용
  • BEM 명명 규칙을 따릅니다.
  • 모바일 우선 반응형 디자인
  • 목적에 따라 파일을 정리
  • 재사용 가능한 믹스인 작성
  • 선택기를 단순하게 유지하세요(최대 3레벨 깊이).
  • 의미론적 HTML을 사용하라
  • 특이성을 최소화
  • 복잡한 섹션에 댓글 달기

하지 마세요

섹션 제목: “하지 마세요”
  • 인라인 스타일 사용
  • !important를 사용하세요(거의 절대 안함)
  • 지나치게 구체적인 선택자를 만듭니다.
  • 스타일링을 위해 ID 선택기를 사용하세요.
  • 중첩이 너무 깊음(최대 3~4레벨)
  • 글꼴 크기는 px 사용(rem 사용)
  • 매직 넘버 생성(변수 사용)
  • 사용하지 않는 CSS는 남겨두세요
  • 접근성을 잊어라

접근성

섹션 제목: “접근성”

색상 대비

섹션 제목: “색상 대비”
// Ensure sufficient contrast
// Level AA: 4.5:1 for normal text
// Level AAA: 7:1 for normal text


.button--primary {
  background-color: $color-primary; // #0066cc
  color: $color-white;               // #ffffff
  // Contrast ratio: 8.6:1 ✅
}


.button--secondary {
  background-color: $color-gray-300; // #dee2e6
  color: $color-black;               // #000000
  // Contrast ratio: 9.3:1 ✅
}

초점 상태

섹션 제목: “초점 상태”
// Always provide focus styles
.button:focus,
.form-field__input:focus {
  outline: 3px solid $color-primary;
  outline-offset: 2px;
}

CSS를 사용한 시맨틱 HTML

섹션 제목: “CSS를 사용한 시맨틱 HTML”
// Use proper semantic structure
main {
  padding: $spacing-lg;
}


article {
  margin-bottom: $spacing-xl;
  border-bottom: 1px solid #eee;
  padding-bottom: $spacing-xl;
}


header {
  background-color: #f5f5f5;
  padding: $spacing-md;
}


nav {
  display: flex;
  gap: $spacing-md;
}

성능

섹션 제목: “성능”

최적화 선택기

섹션 제목: “최적화 선택기”
// ✅ Efficient
.button {
  // ...
}


.button--primary {
  // ...
}


// ❌ Inefficient (too specific, deep nesting)
div.container section.content article .button {
  // ...
}

다시 그리기 최소화

섹션 제목: “다시 그리기 최소화”
// Group animations
.component {
  // Change multiple properties at once
  transition: background-color 0.3s, color 0.3s, border-color 0.3s;
}


// Or use shorthand
.component {
  transition: all 0.3s ease;
}

도구

섹션 제목: “도구”

스타일린트 구성

섹션 제목: “스타일린트 구성”
{
  "extends": "stylelint-config-standard-scss",
  "rules": {
    "indentation": 2,
    "string-quotes": "single",
    "color-hex-length": "short",
    "selector-pseudo-class-no-unknown": null,
    "scss/dollar-variable-pattern": "^[a-z]"
  }
}

관련 문서

섹션 제목: “관련 문서”
  • JavaScript 표준
  • 행동강령
  • 기여 워크플로우
  • PHP 표준

#xoops #css #scss #스타일링 #코딩 표준 #모범 사례