harmony 鸿蒙禁用控制

2025-06-12
浏览 (5)

禁用控制

组件可交互状态下响应点击事件、触摸事件、拖拽事件、按键事件、焦点事件、鼠标事件、轴事件、悬浮事件、无障碍悬浮事件、手势事件、焦点轴事件和表冠事件。

说明：

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

禁用控制属性仅在按下时生效，交互过程中更改enabled属性无效。

enabled

enabled(value: boolean): T

设置组件是否可交互。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	boolean	是	值为true表示组件可交互，响应点击等操作。值为false表示组件不可交互，不响应点击等操作。默认值：true

返回值：

类型	说明
T	返回当前组件。

示例

该示例通过enable设置按钮可交互性。

// xxx.ets
@Entry
@Component
struct EnabledExample {

  build() {
    Flex({ justifyContent: FlexAlign.SpaceAround }) {
      // 点击时无响应
      Button('disable').enabled(false).backgroundColor(0x317aff).opacity(0.4)
      Button('enable').backgroundColor(0x317aff)
    }
    .width('100%')
    .padding({ top: 5 })
  }
}

zh-cn_image_0000001219982713