大网数据广告活动
OpenHarmony 设备与应用开发

OpenHarmony 中文参考:switch

· 52CE 我爱测

# switch 开关选择器,通过开关,开启或关闭某个功能。 > **说明:** > > 该组件从API version 4 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 ## 子组件 不支持。 ## 属性 | 名称 | 类型 | 默认值 | 必填 | 描述 | | -------- | -------- | -------- | -------- | -------- | | checked | boolea

switch

开关选择器,通过开关,开启或关闭某个功能。

说明:

该组件从API version 4 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

不支持。

属性

名称 类型 默认值 必填 描述
checked boolean false 否 是否选中。true表示被选中,false表示不被选中。
id string - 否 组件的唯一标识。
style string - 否 组件的样式声明。
class string - 否 组件的样式类,用于引用样式表。
ref string - 否 用来指定指向子元素的引用信息,该引用将注册到父组件的$refs 属性对象上。

事件

名称 参数 描述
change { checked: checkedValue } 选中状态改变时触发该事件。
click - 点击动作触发该事件。
longpress - 长按动作触发该事件。
swipe5+ SwipeEvent 组件上快速滑动后触发。

样式

名称 类型 默认值 必填 描述
width <length> | <percentage>5+ - 否 设置组件自身的宽度。
未设置时组件宽度默认为0。
height <length> | <percentage>5+ - 否 设置组件自身的高度。
未设置时组件高度默认为0。
padding <length> 0 否 使用简写属性设置所有的内边距属性。
  该属性可以有1到4个值:
- 指定一个值时,该值指定四个边的内边距。
- 指定两个值时,第一个值指定上下两边的内边距,第二个指定左右两边的内边距。
- 指定三个值时,第一个指定上边的内边距,第二个指定左右两边的内边距,第三个指定下边的内边距。
- 指定四个值时分别为上、右、下、左边的内边距(顺时针顺序)。
padding-[left|top|right|bottom] <length> 0 否 设置左、上、右、下内边距属性。
margin <length> | <percentage>5+ 0 否 使用简写属性设置所有的外边距属性,该属性可以有1到4个值。
- 只有一个值时,这个值会被指定给全部的四个边。
- 两个值时,第一个值被匹配给上和下,第二个值被匹配给左和右。
- 三个值时,第一个值被匹配给上, 第二个值被匹配给左和右,第三个值被匹配给下。
- 四个值时,会依次按上、右、下、左的顺序匹配 (即顺时针顺序)。
margin-[left|top|right|bottom] <length> | <percentage>5+ 0 否 设置左、上、右、下外边距属性。
border-width <length> 0 否 使用简写属性设置元素的所有边框宽度。
border-color <color> black 否 使用简写属性设置元素的所有边框颜色。
border-radius <length> - 否 border-radius属性是设置元素的外边框圆角半径。
background-color <color> - 否 设置背景颜色。
display string flex 否 确定一个元素所产生的框的类型,可选值为:
- flex:弹性布局。
- none:不渲染此元素。
[left|top] <length> | <percentage>6+ - 否 left|top确定元素的偏移位置。
- left属性规定元素的左边缘。该属性定义了定位元素左外边距边界与其包含块左边界之间的偏移。
- top属性规定元素的顶部边缘。该属性定义了一个定位元素的上外边距边界与其包含块上边界之间的偏移。

示例


<div class="container">
  <div class="box">
    <switch checked="true" @change="switchChange"></switch>
    <text>{{title}}</text>
  </div>
</div>
/* xxx.css */
.container {
  width: 100%;
  height: 100%;
  justify-content: center;
  align-items: center;
}
.box{
  width: 18%;
  height: 25%;
  flex-direction:column;
  justify-content: center;
  align-items: center;
}
// xxx.js
  data: {
      title: 'on'
  },
  switchChange(e){
      console.info(e.checked);
      if(e.checked){
          this.title="on"
      }else{
          this.title="off"
      }
  }
}

[图示请参阅官方原文]

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。