TeamWicked Design System / 컴포넌트
트리 탐색
파일·폴더의 다단계 계층 탐색을 위한 컴포넌트.
적용 범위: TeamWicked 자체 브랜드·웹사이트. 호스팅 제품의 외형은 포함하지 않습니다. 공통 동작 규칙을 재사용하며, 다른 체계의 사례는 비교 근거일 뿐 스타일 상속이 아닙니다.
개발 서버
plugins
폴더를 펼치고 파일을 선택하는 계층 탐색 예제입니다.
TeamWicked 웹사이트 토큰으로 구성한 동작 예제예시 데이터 · API 미연결
목적과 사용
파일·폴더의 다단계 계층 탐색에 사용합니다. 한 단계 공개에는 아코디언, 제품 기본 탐색에는 nav를 우선합니다.
구성과 변형
분기·말단, 펼침 상태, 선택/포커스, 선택적 로딩. 변형의 외형은 각 제품의 기존 토큰을 사용합니다. Carbon의 크기·색·모서리·아이콘을 가져오지 않습니다.
동작 규칙
- TREE-01 MUST: 펼침과 선택을 서로 다른 행동으로 구분합니다.
- TREE-02 MUST: 자식이 없는 것과 아직 읽지 못한 것을 구분합니다.
- TREE-03 SHOULD: 큰 트리는 필요한 범위만 읽고 기존 위치를 유지합니다.
- TREE-04 MUST: 파일/폴더 권한은 서버가 검사합니다.
콘텐츠 예시
좋음: 접근 불가 폴더를 오류로 설명 / 피함: 빈 폴더인 것처럼 표시.
우리 구현과 연결
TeamWicked 자체 웹사이트의 토큰과 CTA를 사용합니다. vPanel·Pterodactyl·Store의 구현은 WickedHost 체계에 속하며 이 체계의 컴포넌트를 정의하지 않습니다. 실행 예제의 원본 경로는 구현 코드 탭을 확인하세요.
상태와 검증
깊은 경로·지연 로드·권한 거절·이름 변경·선택 유지·키보드를 확인합니다.
일반·hover·focus·실행 중·실패·성공·disabled·read-only 중 해당하는 상태를 기록합니다. 해당하지 않는 상태를 임의로 만들지 말고 이유를 남깁니다. 검증 체크리스트에 증거를 연결합니다.