目录

禁用控制

禁用控制用于设置组件是否可交互。组件可交互状态下可以响应点击事件、触摸事件、拖拽事件、按键事件、焦点事件、鼠标事件、轴事件、悬浮事件、无障碍悬浮事件、手势事件、焦点轴事件和表冠事件；组件不可交互状态下不响应上述操作，适用于需要临时阻止用户交互的场景。

从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

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

enabled

enabled(value: boolean): T

设置组件是否可交互。当未设置enabled时，组件默认可交互。

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

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

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

参数：

参数名 类型 必填 说明
value boolean 是

值为true表示组件可交互，响应点击等操作。

值为false表示组件不可交互，不响应点击等操作。

返回值：

类型 说明
T 返回当前组件，支持链式调用。

示例

该示例通过enabled设置按钮是否可交互。

// 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 })
  }
}