HarmonyOS应用开发：UI框架开关选择器组件-Switch

介绍​

用于在打开和关闭状态之间进行切换。

引入​

import { IBestSwitch } from "@ibestservices/ibest-ui";

代码演示​

基础用法​

TIP

通过 IBestSwitch 组件的 value 来设置开关的状态，通过 onChange 监听状态变化。

代码如下：

IBestSwitch({
  value: true,
  onChange: value => {
    console.log("switch", value);
  },
});

禁用状态​

TIP

通过 disabled 属性来禁用开关，禁用状态下开关不可点击。

代码如下：

IBestSwitch({
  loading: true,
  disabled: true,
});

IBestSwitch({
  disabled: true,
  value: true,
});

加载状态​

TIP

通过 loading 属性来禁用开关，加载状态下开关不可点击。

代码如下：

IBestSwitch({
  loading: true,
  value: true,
});

IBestSwitch({
  loading: true,
  activeColor: "#07c160",
});

自定义大小​

TIP

通过 switchSize 属性自定义开关的大小。

代码如下：

IBestSwitch({
  value: true,
  switchSize: 40,
});

自定义按钮​

TIP

通过 nodeBuilder 插槽自定义按钮的内容。

代码如下：

import { IBestSwitch } from '@ibestservices/ibset-ui'

@Entry
@Component
struct SwitchPage {
  @State arrowDirection: 'left' | 'right' = 'left';

  @Builder Arrow(){
    Row(){
      Image($r('app.media.arrow'))
        .width('30lpx')
        .fillColor(this.arrowDirection === 'left' ? '#db3131' : '#e2e3e7')
        .rotate({
          angle: this.arrowDirection === 'left' ? 0 : -180
        }).animation({
        duration: 200,
      })
    }
  }

  build(){
    IBestSwitch({
      value: true,
      activeColor: '#db3131',
      nodeBuilder: () => this.Arrow(),
      onChange: (value) => {
        this.arrowDirection = value ? 'left' : 'right';
      }
    })
  }
}

异步控制​

TIP

当需要异步控制开关状态时，可以在 onBeforeChange 事件的回调函数中返回一个 Promise 。如果 Promise 状态为 resolve ，则按钮状态变化将继续进行；如果状态为 reject ，则将阻止按钮状态的变化。

代码如下：

IBestSwitch({
  value: true,
  onBeforeChange: () => {
    return new Promise((resolve, reject) => {
      AlertDialog.show({
        title: "提示",
        message: "确定更改状态吗",
        autoCancel: true,
        alignment: DialogAlignment.Bottom,
        offset: { dx: 0, dy: -20 },
        gridCount: 3,
        primaryButton: {
          value: "取消",
          action: () => {
            reject("");
          },
        },
        secondaryButton: {
          value: "确认",
          action: () => {
            resolve("");
          },
        },
        cancel: () => {
          reject("");
        },
      });
    });
  },
});

API​

@Props​

参数	说明	类型	默认值
value	默认是否选中 非双向绑定，如果要获取最新的值请从 onChange 回调中获取	boolean	false
disabled	是否禁用按钮	boolean	false
loading	是否显示为加载状态	boolean	false
switchSize	大小尺寸，单位 lpx，	number	52
activeColor	打开时的背景色	string	#1989fa
inactiveColor	关闭时的背景色	string	rgba(120, 120, 128, 0.16)
loadingActiveColor	打开时的 loading 颜色，默认跟随 activeColor	string
loadingInactiveColor	关闭时的 loading 颜色，默认跟随 activeColor	string

Events​

事件名	说明	事件类型
onChange	开关状态改变的回调事件	(value: boolean) => void
onBeforeChange	开关状态改变前的回调事件，接收一个 Promise 对象，如果 Promise 状态为 resolve ，则按钮状态变化将继续进行；如果状态为 reject ，则将阻止按钮状态的变化。	(value: boolean) => Promise<any>
onClickSwitch	点击开关的回调事件	(event: ClickEvent)_ => _void_

@BuilderParam 插槽​

插槽名	说明	类型
nodeBuilder	自定义按钮的内容	CustomBuilder | null

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？但是又不知道从哪里下手，而且学习时频繁踩坑，最终浪费大量时间。所以本人整理了一些比较合适的鸿蒙（HarmonyOS NEXT）学习路径和一些资料的整理供小伙伴学习

点击领取→纯血鸿蒙Next全套最新学习资料希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取~~

一、鸿蒙（HarmonyOS NEXT）最新学习路线

​

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）…等技术知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

二、HarmonyOS Next 最新全套视频教程

​

三、《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

​

四、大厂面试必问面试题

​

五、鸿蒙南向开发技术

​

六、鸿蒙APP开发必备

​

完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。