目录

如何隐藏PatternLock控件的解锁轨迹

问题现象

HarmonyOS如何隐藏图案锁PatternLock控件的解锁轨迹。

效果预览

背景知识

HarmonyOS为图案密码锁提供了PatternLock控件,以九宫格图案的方式输入密码,用于密码验证场景。

PatternLock控件默认情况下,点按会出现图案锁圆点变大、变色以及圆环波纹动效;连线时会产生轨迹并触发路径上圆点的特效。

简单实现可以参考以下组件代码:

PatternLock()
  .sideLength(200)
  .circleRadius(9)
  .pathStrokeWidth(5)
  .activeColor('#707070')
  .selectedColor('#707070')
  .pathColor('#707070')
  .backgroundColor('#F5F5F5')
  .autoReset(true)

解锁效果如下图所示:

解决方案

隐藏圆点与轨迹动效,主要修改点如下:

  1. 为了隐藏连接线,需要将PatternLock控件的pathStrokeWidth属性设置为0或负数。
  2. 为了隐藏圆点颜色、大小变化,需要将PatternLock控件的regularColor属性、activateCircleStyle属性中options参数的color属性设置为同一颜色,并将selectedColor属性、activeColor属性设置为透明色'#00000000'。
  3. 为了隐藏圆环大小变化,需要将PatternLock控件的activateCircleStyle属性中options参数的radius属性与circleRadius属性设置为同一大小。
  4. 为了隐藏圆点动效,需要将PatternLock控件的activateCircleStyle属性中options参数的enableWaveEffect属性设置为false。

将原组件代码按上文修改后如下:

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');
  }
}

在日志中会打印出选择的数字,截图如下:

常见FAQ

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%');
  }
}

运行效果如下图所示: