patternLock

来自于：开发者立即使用

概述

patternLock 提供很方便的手势解锁功能呢。只需简单的几个步骤，您就可以很快将这一实用的功能集成到您的项目中。patternLock允许您自定义解锁界面颜色参数，满足您自定义UI的要求；patternLock还封装了设置密码，解锁密码和重置密码的三个常用功能，这些您只需要简单的传入一个参数就可以了实现了，极大地节省了您的时间。

不能同时添加的模块：alarmNotification

JSON结构

  1. {
  2.     “name":"patternLock", 
  3.     "class":"PatternLock",
  4.     "methods":["addPatternLock"]
  5. }

方法

  • 添加手势锁

    addPatternLock(param, callback(ret,error));

    • param

      类型：JSON 对象

      1.   var param = {
      2.       "viewName":"main",//父视图的id
      3.       "rightColor":"#00FF00",//验证正确时界面颜色
      4.       "drawColor":"#222222",//画密码时路径颜色
      5.       "wrongColor":"#FF0000",//验证失败时界面颜色
      6.       "normalColor":"#000000",//初始化时界面颜色
      7.       "frame": "{{0,100},{320,300}}",//手势锁视图大小
      8.       "mode": "2",//手势锁的类型
      9.       "rightCode": "0123"//已有的密码
      10.   };

      详细解释：

      1.   viewName
      2.   父视图的id，将会把手势锁视图添加到该参数视图之上
      4.   rightColor ｜ drawColor ｜ wrongColor ｜ normalColor
      5.   界面自定义颜色，颜色采用16进制格式，支持3位和6位有效值
      7.   frame
      8.   手势锁视图的大小，具有固定格式:{{left,top},{width,height}}
      10.   rightCode
      11.   已有的密码，用于验证密码输入是否正确，密码为0-9数字且不能有重复
      13.   mode
      14.   手势锁的类型

      值 | 代表含义 —- | —- 0 | 解锁 1 | 设置密码 2 | 修改密码

  • callback(ret,error)

    • ret

      返回的状态

      参数类型:JSON对象

      1.   {
      2.       status //操作状态值
      3.   }

      值 | 代表含义 —- | —- 0|解锁成功 1|解锁失败 2|提示请重复输入 3|重复输入不一致 4|重复输入一致，新密码设置成功 5|修改密码验证成功 6|修改密码验证失败

    • error:

      错误对象

      类型：JSON 对象

      内部字段:

      1.   {
      2.       desc //错误的描述情况，如果参数不正确，将会直接显示具体参数错误信息
      3.   }

示例代码

  1. var patternLock = api.require('patternLock');
  2. patternLock.addPatternLock({
  3.     viewName: 'main',
  4.     rightColor: '#00FF00',
  5.     drawColor: '#222222',
  6.     wrongColor: '#FF0000',
  7.     normalColor: '#000000',
  8.     frame: '{{0,100},{320,300}}',
  9.     mode: '2',
  10.     rightCode: '0123'
  11. }, function(ret, err) {
  12.     if (ret) {
  13.         alert(JSON.stringify(ret));
  14.     } else {
  15.         alert(JSON.stringify(err));
  16.     }
  17. });

详细功能

  • 验证密码

    此时只需要设置mode为0

    1.   "mode": “0”

  • 设置密码

    此时只需要设置mode为1

    1.   "mode": “1”

  • 重置密码

    此时只需要设置mode为2

    1.   "mode": “2”

  • 设置界面颜色

    rightColor ｜ drawColor ｜ wrongColor ｜ normalColor 自定义界面颜色，颜色采用16进制格式，支持3位和6位有效值

    1.   "rightColor":"#00FF00",
    2.   "drawColor":"#222222",
    3.   "wrongColor":"#FF0000",
    4.   "normalColor":"#000000",

注意事项

  • rightCode

    rightCode为原来已有的密码，用于验证密码输入是否正确。密码应为0-9的数字且不能有重复。

补充说明

无

可用性

iOS系统

可提供的1.0.0及更高版本