접두사 참조 표
이 문서는
SLUR UI System에서 사용하는 클래스 접두사를
구조 범위 기준으로 빠르게 확인하기 위한 참조 문서입니다.
접두사는 네이밍 장식이 아니라,
UI 구조의 책임을 드러내기 위한 표식입니다.
접두사 사용 기본 원칙
Section titled “접두사 사용 기본 원칙”- 접두사는 구조 범위를 나타냅니다.
- 같은 구조 범위를 의미하는 접두사는 중첩될 수 없습니다.
- 내부 요소와 수정자는 단독으로 사용하지 않습니다.
- 접두사만 보고도 구조 범위를 판단할 수 있어야 합니다.
접두사 참조 표
Section titled “접두사 참조 표”| 접두사 | 의미 | 구조 범위 | 단독 사용 |
|---|---|---|---|
| (없음) | 컴포넌트 블록 | 컴포넌트 | 가능 |
layout_ | 레이아웃 블록 | 전역 레이아웃 | 가능 |
page_ | 페이지 블록 | 페이지 | 가능 |
i_ | 내부 요소 | 컴포넌트 내부 | 불가 |
p_ | 페이지 전용 내부 요소 | 페이지 내부 | 불가 |
l_ | 레이아웃 전용 내부 요소 | 레이아웃 내부 | 불가 |
m_ | 수정자 | 상태 / 변형 | 불가 |
popup_ | 팝업 블록 | 팝업 / 모달 | 가능 |
구조 중첩 관련 주의 사항
Section titled “구조 중첩 관련 주의 사항”layout_안에layout_은 중첩될 수 없습니다.page_안에page_는 중첩될 수 없습니다.- 컴포넌트 내부에 컴포넌트는 중첩될 수 없습니다.
- 서로 다른 구조 범위 간에는 조합만 허용됩니다.
접두사가 겹치는 구조는
SLUR UI System 기준에서 구조 설계 오류로 판단합니다.
참조 문서 활용 방법
Section titled “참조 문서 활용 방법”이 문서는
규칙 설명이 아닌 판단 기준 확인용 문서입니다.
- 네이밍이 헷갈릴 때
- 코드 리뷰 시 구조 범위를 확인할 때
- 중첩 구조 문제를 점검할 때
다른 문서에서 접두사 기준이 필요할 경우,
이 문서를 최종 기준으로 사용합니다.