Radio

單選框，提供相應的用戶交互選擇項。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

子組件

無

接口

Radio(options: {value: string, group: string})

從API version 9開始，該接口支持在ArkTS卡片中使用。

參數:

參數名	參數類型	必填	參數描述
value	string	是	當前單選框的值。
group	string	是	當前單選框的所屬群組名稱，相同group的Radio只能有一個被選中。

屬性

除支持[通用屬性]外，還支持以下屬性：

名稱	參數類型	描述
checked	boolean	設置單選框的選中狀態。默認值：false 從API version 9開始，該接口支持在ArkTS卡片中使用。從API version 10開始，該屬性支持[$$]雙向綁定變量。
radioStyle10+	[RadioStyle]	設置單選框選中狀態和非選中狀態的樣式。從API version 10開始，該接口支持在ArkTS組件中使用。

事件

除支持[通用事件]外，還支持以下事件：

名稱	功能描述
onChange(callback: (isChecked: boolean) => void)	單選框選中狀態改變時觸發回調。 - isChecked為true時，表示從未選中變為選中。 - isChecked為false時，表示從選中變為未選中。從API version 9開始，該接口支持在ArkTS卡片中使用。

RadioStyle對象說明

名稱	類型	必填	默認值	描述
checkedBackgroundColor	[ResourceColor]	否	#007DFF	開啟狀態底板顏色。
uncheckedBorderColor	[ResourceColor]	否	#182431	關閉狀態描邊顏色。
indicatorColor	[ResourceColor]	否	#FFFFFF	開啟狀態內部圓餅顏色。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151344.png

示例

// xxx.ets
@Entry
@Component
struct RadioExample {
  build() {
    Flex({ direction: FlexDirection.Row, justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center }) {
      Column() {
        Text('Radio1')
        Radio({ value: 'Radio1', group: 'radioGroup' }).checked(true)
          .radioStyle({
            checkedBackgroundColor: Color.Pink
          })
          .height(50)
          .width(50)
          .onChange((isChecked: boolean) = > {
            console.log('Radio1 status is ' + isChecked)
          })
      }
      Column() {
        Text('Radio2')
        Radio({ value: 'Radio2', group: 'radioGroup' }).checked(false)
          .radioStyle({
            checkedBackgroundColor: Color.Pink
          })
          .height(50)
          .width(50)
          .onChange((isChecked: boolean) = > {
            console.log('Radio2 status is ' + isChecked)
          })
      }
      Column() {
        Text('Radio3')
        Radio({ value: 'Radio3', group: 'radioGroup' }).checked(false)
          .radioStyle({
            checkedBackgroundColor: Color.Pink
          })
          .height(50)
          .width(50)
          .onChange((isChecked: boolean) = > {
            console.log('Radio3 status is ' + isChecked)
          })
      }
    }.padding({ top: 30 })
  }
}