5 UI 组件-Toggle 组件

组件提供勾选框样式、状态按钮样式及开关样式。仅当ToggleType为Button时可包含子组件。

5.1 定义与参数

Toggle(options: { type: ToggleType, isOn?: boolean })

参数说明：

• type：切换类型，入Switch（开关）、Checkbox（复选框）、Button（按钮）。
• isOn：当前状态（true或false）

5.2 使用示例

一个简单的例子如下：

// xxx.ets
@Entry
@Component
struct ToggleExample {
    build() {
        Column({ space: 10 }) {
            Text('type: Switch').fontSize(12).fontColor(0xcccccc).width('90%')
            Flex({ justifyContent: FlexAlign.SpaceEvenly, alignItems: ItemAlign.Center }) {
                Toggle({ type: ToggleType.Switch, isOn: false })
                .selectedColor('#007DFF')
                .switchPointColor('#FFFFFF')
                .onChange((isOn: boolean) => {
                    console.info('Component status:' + isOn)
                })

                Toggle({ type: ToggleType.Switch, isOn: true })
                .selectedColor('#007DFF')
                .switchPointColor('#FFFFFF')
                .onChange((isOn: boolean) => {
                    console.info('Component status:' + isOn)
                })
            }

            Text('type: Checkbox').fontSize(12).fontColor(0xcccccc).width('90%')
            Flex({ justifyContent: FlexAlign.SpaceEvenly, alignItems: ItemAlign.Center }) {
                Toggle({ type: ToggleType.Checkbox, isOn: false })
                .size({ width: 20, height: 20 })
                .selectedColor('#007DFF')
                .onChange((isOn: boolean) => {
                    console.info('Component status:' + isOn)
                })

                Toggle({ type: ToggleType.Checkbox, isOn: true })
                .size({ width: 20, height: 20 })
                .selectedColor('#007DFF')
                .onChange((isOn: boolean) => {
                    console.info('Component status:' + isOn)
                })
            }

            Text('type: Button').fontSize(12).fontColor(0xcccccc).width('90%')
            Flex({ justifyContent: FlexAlign.SpaceEvenly, alignItems: ItemAlign.Center }) {
                Toggle({ type: ToggleType.Button, isOn: false }) {
                    Text('status button').fontColor('#182431').fontSize(12)
                }.width(106)
                .selectedColor('rgba(0,125,255,0.20)')
                .onChange((isOn: boolean) => {
                    console.info('Component status:' + isOn)
                })

                Toggle({ type: ToggleType.Button, isOn: true }) {
                    Text('status button').fontColor('#182431').fontSize(12)
                }.width(106)
                .selectedColor('rgba(0,125,255,0.20)')
                .onChange((isOn: boolean) => {
                    console.info('Component status:' + isOn)
                })
            }.width('100%').padding(24)
        }
    }
}