TeamWicked Design System / 컴포넌트

스위치

즉시 적용되는 가역적인 이진 설정을 위한 컴포넌트.

적용 범위: TeamWicked 자체 브랜드·웹사이트. 호스팅 제품의 외형은 포함하지 않습니다. 공통 동작 규칙을 재사용하며, 다른 체계의 사례는 비교 근거일 뿐 스타일 상속이 아닙니다.

실행형 예제
사용량 알림

한도에 가까워지면 알려드려요.

켜짐
스위치를 눌러 저장과 상태 변화를 확인하세요.
꺼짐
켜짐
비활성 · 꺼짐
비활성 · 켜짐
읽기 전용
저장 중
TeamWicked 자체 스위치 · 문서 예제예시 데이터 · API 미연결

목적과 사용

즉시 적용되는 가역적인 이진 설정에 사용합니다. 결제·삭제·추가 저장이 필요한 설정에 쓰지 않습니다.

구성과 변형

고정된 설정 이름, 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 중 해당하는 상태를 기록합니다. 해당하지 않는 상태를 임의로 만들지 말고 이유를 남깁니다. 검증 체크리스트에 증거를 연결합니다.

출처와 적용 범위

원본 확인 범위와 운영 적용 여부를 구분합니다. 실행형 예제의 동작 확인은 모든 운영 화면의 접근성 검증을 의미하지 않습니다.

Markdown 원본 다운로드