본문으로 건너뛰기

setRadioGroupValue

setRadioGroupValue

라디오 그룹의 선택값을 프로그래밍 방식으로 설정합니다.

파라미터

  • groupId (string): 라디오 그룹의 식별자
  • groupValue (string): 그룹에서 선택할 값

반환: 없음 (void)

Radio 위젯 설정

스크립트로 라디오 그룹을 제어하려면 Form에 배치된 Radio 위젯의 속성을 다음과 같이 설정해야 합니다.

속성설명
groupId같은 그룹으로 동작할 라디오 버튼들은 모두 동일한 값으로 설정합니다. setRadioGroupValue의 첫 번째 인자와 일치해야 합니다.
value각 라디오 버튼의 고유 식별자입니다. setRadioGroupValue의 두 번째 인자(groupValue)와 일치하는 라디오가 선택됩니다.
노트

groupValue 속성은 런타임에 자동으로 관리되므로 직접 설정하지 않아도 됩니다.

설정 예시

아래와 같이 3개의 Radio 위젯을 배치한다고 가정합니다.

위젯groupId 속성value 속성
Radio 1orderTypemarket
Radio 2orderTypelimit
Radio 3orderTypestop

이 상태에서 아래 스크립트를 실행하면 Radio 2(value: "limit")가 선택됩니다.

$form.setRadioGroupValue("orderType", "limit");

Example

// 주문 유형 라디오 그룹 값 설정
$form.setRadioGroupValue("orderType", "limit");
$form.setRadioGroupValue("orderType", "market");

관련

  • $form.getRadioGroupValue(groupId) — 현재 선택값 읽기