切换按钮(Toggle)

2024-01-25 13:14 更新

Toggle组件提供状态按钮样式,勾选框样式及开关样式,一般用于两种状态之间的切换。具体用法请参考Toggle

创建切换按钮

Toggle通过调用接口来创建,接口调用形式如下:

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

该接口用于创建切换按钮,其中ToggleType为开关类型,包括Button、Checkbox和Switch,isOn为切换按钮的状态,接口调用有以下两种形式:

  • 创建不包含子组件的Toggle。

    当ToggleType为Checkbox或者Switch时,用于创建不包含子组件的Toggle:

    1. Toggle({ type: ToggleType.Checkbox, isOn: false })
    2. Toggle({ type: ToggleType.Checkbox, isOn: true })

    1. Toggle({ type: ToggleType.Switch, isOn: false })
    2. Toggle({ type: ToggleType.Switch, isOn: true })

  • 创建包含子组件的Toggle。

    当ToggleType为Button时,只能包含一个子组件,如果子组件有文本设置,则相应的文本内容会显示在按钮内部。

    1. Toggle({ type: ToggleType.Button, isOn: false }) {
    2. Text('status button')
    3. .fontColor('#182431')
    4. .fontSize(12)
    5. }.width(100)
    6. Toggle({ type: ToggleType.Button, isOn: true }) {
    7. Text('status button')
    8. .fontColor('#182431')
    9. .fontSize(12)
    10. }.width(100)

自定义样式

  • 通过selectedColor属性设置Toggle打开选中后的背景颜色。
    1. Toggle({ type: ToggleType.Button, isOn: true }) {
    2. Text('status button')
    3. .fontColor('#182431')
    4. .fontSize(12)
    5. }.width(100).selectedColor(Color.Pink)
    6. Toggle({ type: ToggleType.Checkbox, isOn: true })
    7. .selectedColor(Color.Pink)
    8. Toggle({ type: ToggleType.Switch, isOn: true })
    9. .selectedColor(Color.Pink)

  • 通过switchPointColor属性设置Switch类型的圆形滑块颜色,仅对type为ToggleType.Switch生效。
    1. Toggle({ type: ToggleType.Switch, isOn: false })
    2. .switchPointColor(Color.Pink)
    3. Toggle({ type: ToggleType.Switch, isOn: true })
    4. .switchPointColor(Color.Pink)

添加事件

除支持通用事件外,Toggle通常用于选中和取消选中后触发某些操作,可以绑定onChange事件来响应操作后的自定义行为。

  1. Toggle({ type: ToggleType.Switch, isOn: false })
  2. .onChange((isOn: boolean) => {
  3. if(isOn) {
  4. // 需要执行的操作
  5. }
  6. })

场景示例

Toggle可用于切换蓝牙开关状态。

  1. // xxx.ets
  2. import promptAction from '@ohos.promptAction';
  3. @Entry
  4. @Component
  5. struct ToggleExample {
  6. build() {
  7. Column() {
  8. Row() {
  9. Text("Bluetooth Mode")
  10. .height(50)
  11. .fontSize(16)
  12. }
  13. Row() {
  14. Text("Bluetooth")
  15. .height(50)
  16. .padding({left: 10})
  17. .fontSize(16)
  18. .textAlign(TextAlign.Start)
  19. .backgroundColor(0xFFFFFF)
  20. Toggle({ type: ToggleType.Switch })
  21. .margin({left: 200, right: 10})
  22. .onChange((isOn: boolean) => {
  23. if(isOn) {
  24. promptAction.showToast({ message: 'Bluetooth is on.' })
  25. } else {
  26. promptAction.showToast({ message: 'Bluetooth is off.' })
  27. }
  28. })
  29. }
  30. .backgroundColor(0xFFFFFF)
  31. }
  32. .padding(10)
  33. .backgroundColor(0xDCDCDC)
  34. .width('100%')
  35. .height('100%')
  36. }
  37. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号