RadioButton

위치: qml/components/control/check/RadioButton.qml

RadioButton는 레거시 API 이름에 대한 호환 별칭을 갖춘 소형 라디오 선택기입니다. 현재 기본 색상 매핑은 Figma 노드 44:630에 정렬되어 있습니다.

목적

• 결정론적 원형 표시기와 선택적 텍스트를 제공하십시오.
• state / available 별칭을 통해 하위 호환성을 유지하십시오.

API

기본 상태 API :

• checked
• enabled
• text

호환성 별칭:

• state <-> checked
• available <-> enabled

시각 API :

• indicatorSize, dotSize
• onColor, offColor
• onColorDisabled, offColorDisabled
• dotColor, dotColorDisabled

사용법

import LVRS 1.0 as LV

LV.RadioButton {
    text: "Choice A"
    checked: true
}

동작 원리

• 별칭 동기화 핸들러는 state와 checked를 미러링 상태로 유지합니다.
• 유효 색상은 enabled + checked 조합으로부터 계산됩니다.
• 기본 상태 색상 매트릭스:
  • checked + enabled : Theme.accent + 도트 Theme.textPrimary
  • checked + disabled : Theme.panelBackground12 + 도트 Theme.textSeptenary
  • unchecked + enabled: Theme.textPrimary
  • unchecked + disabled: Theme.panelBackground12
• 배경 시각 자료는 버튼과 같은 표면 스타일링을 방지하기 위해 투명하게 유지됩니다.

고급 예시: 레거시 별칭 인터옵

import LVRS 1.0 as LV

LV.RadioButton {
    text: "Legacy Option"
    state: true
    available: true
}

별칭과 정규 속성는 내부 변경 처리기에 의해 동기화된 상태를 유지합니다.

그룹화 권고

상호 배타적인 옵션 집합에 대해 ButtonGroup를 사용하십시오. 그룹화 없이, 상태 로직이 외부에 배선되지 않은 경우 여러 라디오 버튼을 동시에 확인할 수 있습니다.