开关组件

ArkUI 开发框架提供了 Toggle 组件表示开关。它和 Button组件类似，都可以添加一个子组件来实现更丰富的开关样式。

Toggle 定义介绍

interface ToggleInterface {
  (options: { type: ToggleType; isOn?: boolean }): ToggleAttribute;
}

• isOn：设置开关状态组件初始化状态。

• type：设置相应的开关状态组件。 ToggleType 定义了以下三种样式：

1. Switch：设置组件为开关样式。

简单样式如下所示:

@Entry @Component struct ToggleTest {
  build() {
    Column() {
      Toggle({type: ToggleType.Switch})
    }
    .width('100%')
    .height('100%')
  }
}

样例运行结果如下图所示：

2. Checkbox：设置开关样式为单选框样式。

简单样例如下所示：

@Entry @Component struct ToggleTest {
  build() {
    Column() {
      Toggle({type: ToggleType.Checkbox})
    }
    .width('100%')
    .height('100%')
  }
}

样例运行结果如下图所示：

3. Button：设置开关为按钮样式，如果有文本设置，则相应的文本内容会显示在按钮内部。

简单如下:

@Entry @Component struct ToggleTest {
  build() {
    Column() {
      Toggle({type: ToggleType.Button}) {
        Text('按钮样式')// 添加一个子组件
          .fontSize(20)
      }
      .size({width: 120, height: 60})
    }
    .width('100%')
    .height('100%')
    .padding(10)
  }
}

样例运行结果如下图所示：

Toggle 属性介绍

declare class ToggleAttribute extends CommonMethod<ToggleAttribute> {
  selectedColor(value: ResourceColor): ToggleAttribute;
  switchPointColor(color: ResourceColor): ToggleAttribute;
}

• selectedColor：设置组件打开状态的背景颜色。

• switchPointColor：设置 type 类型为 Switch 时的圆形滑块颜色。

简单样式如下:

@Entry @Component struct ToggleTest {
  build() {
    Column() {
      Toggle({type: ToggleType.Switch})
        .selectedColor(Color.Pink)
        .switchPointColor(Color.Brown)

      Toggle({type: ToggleType.Checkbox})
        .selectedColor(Color.Pink)
        .switchPointColor(Color.Brown)

      Toggle({type: ToggleType.Button}) {
        Text('按钮样式')// 添加一个子组件
          .fontSize(20)
      }
      .size({width: 120, height: 60})
      .selectedColor(Color.Pink)
      .switchPointColor(Color.Brown)
    }
    .width('100%')
    .height('100%')
    .padding(10)
  }
}

样例运行结果如下图所示：

Toggle 事件介绍

declare class ToggleAttribute extends CommonMethod<ToggleAttribute> {
  onChange(callback: (isOn: boolean) => void): ToggleAttribute;
}

• onChange：开关状态切换时触发该事件。

Toggle 完整样例

完整样例如下所示：

import prompt from '@ohos.prompt';

@Entry @Component struct ToggleTest {
  build() {
    Column({space: 10}) {
      Row({space: 20}) {
        Toggle({type: ToggleType.Switch})

        Toggle({type: ToggleType.Switch})
          .selectedColor(Color.Pink)
          .switchPointColor(Color.Brown)
          .onChange((isOn) => {
            prompt.showToast({
              message: "开关状态：" + isOn
            })
          })
      }

      Row({space: 20}) {
        Toggle({type: ToggleType.Checkbox})

        Toggle({type: ToggleType.Checkbox})
          .selectedColor(Color.Pink)
          .switchPointColor(Color.Brown)
          .onChange((isOn) => {
            prompt.showToast({
              message: "开关状态：" + isOn
            })
          })
      }

      Row({space: 20}) {
        Toggle({type: ToggleType.Button}) {
          Text('按钮样式')
            .fontSize(20)
        }
        .size({width: 120, height: 60})

        Toggle({type: ToggleType.Button}) {
          Text('按钮样式')// 添加一个子组件
            .fontSize(20)
        }
        .size({width: 120, height: 60})
        .selectedColor(Color.Pink)
        .switchPointColor(Color.Brown)
        .onChange((isOn) => {
          prompt.showToast({
            message: "开关状态：" + isOn
          })
        })
      }
    }
    .width('100%')
    .height('100%')
    .padding(10)
  }
}

样例运行结果如下图所示：