图案密码锁组件,以九宫格图案的方式输入密码,用于密码验证场景。手指在PatternLock组件区域按下时开始进入输入状态,手指离开屏幕时结束输入状态完成密码输入。
说明
该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
子组件
无
接口
PatternLock(controller?: PatternLockController)
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
controller | [PatternLockController] | 否 | 设置PatternLock组件控制器,可用于控制组件状态重置。 |
属性
除支持[通用属性]外,还支持以下属性:
sideLength
sideLength(value: Length)
设置组件的宽度和高度(宽高相同)。设置为0或负数时组件不显示。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | [Length] | 是 | 组件的宽度和高度。默认值:288vp |
circleRadius
circleRadius(value: Length)
设置宫格中圆点的半径。设置为0或负数时取默认值。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | [Length] | 是 | 宫格中圆点的半径。默认值:6vp |
backgroundColor
backgroundColor(value: ResourceColor)
设置背景颜色
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | [ResourceColor] | 是 | 背景颜色 |