HarmonyOS为图案密码锁提供了PatternLock控件,以九宫格图案的方式输入密码,用于密码验证场景。
PatternLock控件默认情况下,点按会出现图案锁圆点变大、变色以及圆环波纹动效;连线时会产生轨迹并触发路径上圆点的特效。
简单实现可以参考以下组件代码:
PatternLock()
.sideLength(200)
.circleRadius(9)
.pathStrokeWidth(5)
.activeColor('#707070')
.selectedColor('#707070')
.pathColor('#707070')
.backgroundColor('#F5F5F5')
.autoReset(true) 解锁效果如下图所示:

隐藏圆点与轨迹动效,主要修改点如下:
将原组件代码按上文修改后如下:
import { LengthUnit } from '@kit.ArkUI';
@Entry
@Component
struct HiddenPatternLock {
build() {
RelativeContainer() {
PatternLock()
.sideLength(280)
.circleRadius(10)
.pathStrokeWidth(0)
.regularColor('#707070')
.activeColor('#00000000')
.selectedColor('#00000000')
.pathColor('#707070')
.backgroundColor('#F5F5F5')
.autoReset(true)
.activateCircleStyle({
color: '#707070',
radius: { value: 10, unit: LengthUnit.VP },
enableWaveEffect: false
})
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
.onPatternComplete((indices: number[]) => {
let numbers = indices.map(i => i + 1).join('-');
console.info(`Selected numbers: ${numbers}`);
});
}
.height('100%')
.width('100%')
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
.backgroundColor('#F5F5F5');
}
} 在日志中会打印出选择的数字,截图如下:

Q:将所有颜色修改一致后,图案锁解锁时圆点大小仍然会有略微放大,且颜色带透明度时,会出现颜色加深问题。
A:参考解决方案步骤2,将PatternLock控件的selectedColor属性、activeColor属性设置为透明色'#00000000'即可。
Q:PatternLock的激活和选定有什么区别?
A:激活:指组件处于可接收用户输入状态,即用户可以开始绘制图案;选定:指用户在激活的PatternLock上完成了单个点的选中或完整图案的确认,是对用户操作的即时反馈。
示例代码:
import { LengthUnit } from '@kit.ArkUI';
@Entry
@Component
struct SelectedPatternLock {
build() {
RelativeContainer() {
PatternLock()
.circleRadius(6)
.pathStrokeWidth(12)
// 圆点在激活状态的填充颜色
.activeColor('rgba(0, 0, 0, 0.9)')
// 圆点在选中状态的填充颜色
.selectedColor('rgba(10, 89, 247, 1)')
.pathColor('rgba(0, 0, 0, 0.2)')
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
.activateCircleStyle({
color: 'rgba(0, 0, 0, 0.2)',
radius: { value: 10, unit: LengthUnit.VP },
enableWaveEffect: true
});
}
.height('100%')
.width('100%');
}
} 运行效果如下图所示:
