스위치
즉시 적용되는 가역적인 이진 설정을 위한 컴포넌트.
적용 범위: TeamWicked 자체 브랜드·웹사이트. 호스팅 제품의 외형은 포함하지 않습니다. 공통 동작 규칙을 재사용하며, 다른 체계의 사례는 비교 근거일 뿐 스타일 상속이 아닙니다.
한도에 가까워지면 알려드려요.
목적과 사용
즉시 적용되는 가역적인 이진 설정에 사용합니다. 결제·삭제·추가 저장이 필요한 설정에 쓰지 않습니다.
구성과 변형
고정된 설정 이름, on/off 상태, 저장 피드백. 변형의 외형은 각 제품의 기존 토큰을 사용합니다. Carbon의 크기·색·모서리·아이콘을 가져오지 않습니다.
동작 규칙
- SWT-01 MUST: 이름은 상태에 따라 뒤집지 않고 설정 자체를 설명합니다.
- SWT-02 MUST: 저장 실패 시 실제 상태를 복구하고 실패를 알립니다.
- SWT-03 MUST: 처리 중 반복 변경을 안전하게 제어합니다.
- SWT-04 SHOULD: 끄기가 되돌릴 수 없는 작업이면 별도 버튼·확인을 사용합니다.
콘텐츠 예시
좋음: ‘자동 갱신’과 현재 상태 / 피함: 현재 동작과 반대 뜻의 ‘비활성화 끄기’.
우리 구현과 연결
TeamWicked 자체 웹사이트의 토큰과 CTA를 사용합니다. vPanel·Pterodactyl·Store의 구현은 WickedHost 체계에 속하며 이 체계의 컴포넌트를 정의하지 않습니다. 실행 예제의 원본 경로는 구현 코드 탭을 확인하세요.
실물 상태와 실패 복구
| 상태 | 표현과 동작 |
|---|---|
| 꺼짐 | muted 네모 손잡이, 비강조 트랙 |
| 켜짐 | accent 테두리·손잡이, panel 배경 |
| 비활성 | 상태 보존, 대비를 낮추고 조작 제한 |
| 읽기 전용 | 상태 읽기 가능, 포커스 가능, 변경 불가 |
| 저장 중 | 중복 조작 제한, 진행 안내 |
| 저장 실패 | 이전 checked 값으로 복구, 실패 원인 안내 |
‘다음 저장 실패 재현’을 켜고 스위치를 변경하면 700ms 뒤 원래 값으로 돌아갑니다. 타이머는 컴포넌트 이탈 시 정리되며 실제 저장 요청은 없습니다.
제품별 소유 경로는 WICKEDVPS, Panel, Blesta와 소스 근거를 확인합니다. 코드 존재와 모든 사용처의 준수는 다르며, 별도 표시가 없는 제품별 준수 상태는 미검증입니다.
상태와 검증
성공·실패 롤백·연속 클릭·읽기 전용·키보드 전환을 확인합니다.
일반·hover·focus·실행 중·실패·성공·disabled·read-only 중 해당하는 상태를 기록합니다. 해당하지 않는 상태를 임의로 만들지 말고 이유를 남깁니다. 검증 체크리스트에 증거를 연결합니다.