钉钉扫条形码学习2

调用钉钉扫一扫

调用biz.util.scan扫条形码或二维码。
安装包:

npm install dingtalk-jsapi --save

引用:

import * as dd from "dingtalk-jsapi";

函数调用:

dd.biz.util.scan({
    type: String , // type 为 all、qrCode、barCode,默认是all。
    onSuccess: function(data) {
    //onSuccess将在扫码成功之后回调
      /* data结构
        { 'text': String}
      */
    },
   onFail : function(err) {
   }
})

在这里插入图片描述
安装一下工具吧会更方便一些:

npm i dingtalk-design-cli@latest -g
ding init

2021/6/25


在使用上面的函数调用的时候发现了问题,不能够调用无法使能,最后经过排查发现上面的是使用的H5的开发调用函数,所以在这里换成小程序里的调用接口:

dd.scan({
  type: 'qr',
  success: (res) => {
    dd.alert({ title: res.code });
  },
});

在这里插入图片描述
在调用成功后success返回值:
在这里插入图片描述
如果错误,错误码为:
在这里插入图片描述
推荐一个钉钉提供的API地址
然后就可以开始,这个是.axml文件

<view class="form-row-label">姓名</view>
<view class="form-row-content">
<input class="input" onInput="bindKeyInput" placeholder="请填入姓名" />
</view>

<view class="form-row-label">工号</view>
<view class="form-row-content">
<input class="input" onInput="bindKeyInput" placeholder="请填入工号" />
</view>

<view class="form-row-label">号码1</view>
<view class="form-row-content">
<input type='text' value='{{scanCodeMsg1}}'></input>
</view>
<form onSubmit="scanCode">
<button type="primary" onTap="scan1">扫码1</button>

<view class="form-row-label">号码2</view>
<view class="form-row-content">
<input type='text' value='{{scanCodeMsg2}}'></input>
</view>
<form onSubmit="scanCode">
<button type="primary" onTap="scan2">扫码2</button>

<view class="form-row-label">号码3</view>
<view class="form-row-content">
<input type='text' value='{{scanCodeMsg3}}'></input>
</view>
<form onSubmit="scanCode">
<button type="primary" onTap="scan3">扫码3</button>

在.js文件中有:

//import * as dd from "dingtalk-jsapi";



Page({
data: {
  scanMsg1: "",
  scanMsg2: "",
  scanMsg3: "",
  focus: false,
  inputValue: ''
},


bindButtonTap() {
    // blur 事件和这个冲突
  setTimeout(() => {
    this.onFocus();
  }, 100);
},


onFocus() {
  this.setData({
    focus: true,
  });
},


onBlur() {
  this.setData({
    focus: false,
  });
},


bindKeyInput(e) {
  this.setData({
    inputValue: e.detail.value,
  });
},


bindHideKeyboard(e) {
  if (e.detail.value === '123') {
    // 收起键盘
    dd.hideKeyboard();
  }
},


handleSearch(e) {
  console.log('search', e.detail.value);
  this.setData({
    search: e.detail.value,
  });
},


doneSearch() {
  console.log('doneSearch', this.data.search);
  dd.hideKeyboard();
},


clearSearch() {
  console.log('clear search', this.data.search);
  this.setData({
    search: '',
  });
},


  
scan1() {
  var that = this;
  dd.scan({
    type: 'qr',
    success: (res) => {
      dd.alert({ title: res.code });
      that.setData({scanCodeMsg1: res.code});
    }
  });
},

scan2() {
  var that = this;
  dd.scan({
    type: 'qr',
    success: (res) => {
      dd.alert({ title: res.code });
      that.setData({scanCodeMsg2: res.code});
    }
  });
},

scan3() {
  var that = this;
  dd.scan({
    type: 'qr',
    success: (res) => {
      dd.alert({ title: res.code });
      that.setData({scanCodeMsg3: res.code});
    }
  });
}  



})

.json文件中:

{
    "defaultTitle": "Scan"
}

全局.js文件:

App({
  onLaunch(options) {
    // 第一次打开
    // options.query == {number:1}
    console.log('getSystemInfoSync', dd.getSystemInfoSync());
    console.log('SDKVersion', dd.SDKVersion);
  },
  onShow(options) {
    // 从后台被 scheme 重新打开
    // options.query == {number:1}
    console.log('App Show');
  },
  onHide() {
    console.log('App Hide');
  },

});

全局.json文件:

{
  "pages": [
    "pages/index/index"
  ],
  "window": {
    "defaultTitle": "扫码输入",
    "titleBarColor":"#F5F5F",
    "pullRefresh":false,
    "allowsBounceVertical":"YES",
    "supportColorScheme":["light"]
  },
  "tabBar": {
    "textColor": "#404040",
    "selectedColor": "#108ee9",
    "backgroundColor": "#F5F5F9"
  },
  "debug": true
}

最后能够得到:
在这里插入图片描述
2021/6/28

发布调试

现在出现了一个问题,API接口没弄好,在发布之后没办法连接到服务器
重新来配置一下后台程序:

git clone https://github.com/opendingtalk/eapp-corp-quick-start-java.git

这个下载下来比较慢,耐心一些:
在这里插入图片描述
打开src/main/java/com/config/Constant.java文件,提供步骤一中已创建应用的AppKey和AppSecret。然后启动一下文件最后配置成功。

云配置

想要把input的内容同步到服务器的数据库中,下一步就需要了解云函数这个内容。云函数(FaaS)是一段运行在云端的、轻量的、无关联的、并且可重用的代码。无需管理服务器,只需编写和上传代码,即可获得对应的数据结果。使用云函数可以使企业和开发者不需要担心服务器或底层运维设施,可以更专注代码和业务本身,也可以使代码进一步解耦,增加其重用性。

在客户端只需依赖mpserverless-sdk,在应用的上下文中进行简单的鉴权配置,即可调用云函数。云函数的入参只有一个ctx对象,该对象可获取调用的云函数时传入的参数,也可获取小程序serverless服务空间的云数据库,云存储等服务。

//云函数定义在index.js中,此文件为云函数的入口文件
module.exports = ctx => {
    const args = ctx.args;
    return {
        "text": args.hello, 
    };
};

数据库

数据存储服务是基于MongoDB托管在云端的数据库,数据以JSON格式存储。小程序Serverless服务使用的是MongoDB,以JSON格式存储数据。数据库中的每条记录都是一个JSON格式的对象,一个数据库可以包含多个集合(相当于关系型数据库中的表),每个集合可看做一个JSON数组。
在这里插入图片描述
留个坑?以后补上


2021/6/29

小程序页面配置

小程序页面介绍

Page代表应用的一个页面,负责页面展示和交互。每个页面对应一个子目录,一般有多少个页面,就有多少个子目录。它也是一个构造函数,用来生成页面实例。每个小程序页面一般包含四个文件,如下表所示。
在这里插入图片描述
选用一个index的page:
index.js注册页面并在初始化时提供数据。

Page({
  data: {
    title: 'Dingtalk',
    array: [{user: 'gitfight'}, {user: 'test'}]
  }
})

index.axml根据以上提供的数据渲染页面内容。

<view>{{title}}</view>
<view>{{array[0].user}}</view>

index.axml中定义交互行为时,需要指定在页面脚本里面定义的响应函数。

<view onTap="handleTap">click me</view>

index.js中定义handleTap方法。

Page({
  handleTap() {
    console.log('yo! view tap!')
  }
})

index.axml中页面内容若要重新渲染,需在页面脚本里面调用this.setData方法。

<view>{{text}}</view>
<button onTap="changeText"> Change normal data </button>

index.js中定义changeText方法。

Page({
  data: {
    text: 'init data',
  },
  changeText() {
    this.setData({
      text: 'changed data'
    })
  },
})

上面代码中,changeText方法里面调用this.setData方法,会将页面进行重新渲染。

注册小程序页面

Page() 接受一个 object 作为参数,该参数用来指定页面的初始数据、生命周期函数、事件处理函数等。

//index.js
Page({
  data: {
    title: "Dingtalk"
  },
  onLoad(query) {
    // 页面加载
  },
  onReady() {
    // 页面加载完成
  },
  onShow() {
    // 页面显示
  },
  onHide() {
    // 页面隐藏
  },
  onUnload() {
    // 页面被关闭
  },
  onTitleClick() {
    // 标题被点击
  },
  onPullDownRefresh() {
    // 页面被下拉
  },
  onReachBottom() {
    // 页面被拉到底部
  },
  onShareAppMessage() {
   // 返回自定义分享信息
  },
  viewTap() {
    // 事件处理
    this.setData({
      text: 'Set data for update.'
    })
  },
  go() {
    // 带参数的跳转,从 page/index 的 onLoad 函数的 query 中读取 xx
    dd.navigateTo({url:'/page/index?xx=1'})
  },
  customData: {
    hi: 'Dingtalk'
  }
})

Page()方法的参数说明如下:
在这里插入图片描述
data是页面第一次渲染使用的初始数据。

.axml文件

<view>{{text}}</view>
<view>{{array[0].msg}}</view>

.js文件

Page({
  data: {
    text: 'DingTalk',
    array: [{msg: '1'}, {msg: '2'}]
  }
})

生命周期方法
在这里插入图片描述
事件处理函数
在这里插入图片描述
Page.prototype.setData()

setData函数用于将数据从逻辑层发送到视图层,同时改变对应的this.data的值。setData接受一个对象作为参数。对象的键名key可以非常灵活,以数据路径的形式给出,如 array[2].message、a.b.c.d,并且不需要在this.data中预先定义。直接修改this.data无效,无法改变页面的状态,还会造成数据不一致。需要避免一次设置过多的数据。

<view>{{text}}</view>
<button onTap="changeTitle"> Change normal data </button>
<view>{{array[0].text}}</view>
<button onTap="changeArray"> Change Array data </button>
<view>{{object.text}}</view>
<button onTap="changePlanetColor"> Change Object data </button>
<view>{{newField.text}}</view>
<button onTap="addNewKey"> Add new data </button>
Page({
  data: {
    text: 'test',
    array: [{text: 'a'}],
    object: {
      text: 'blue'
    }
  },
  changeTitle() {
    // 错误!不要直接去修改 data 里的数据
    // this.data.text = 'changed data'  
    
    // 正确
    this.setData({
      text: 'ha'
    })
  },
  changeArray() {
    // 可以直接使用数据路径来修改数据
    this.setData({
      'array[0].text':'b'
    })
  },
  changePlanetColor(){
    this.setData({
      'object.text': 'red'
    });
  },
  addNewKey() {
    this.setData({
      'newField.text': 'c'
    })
  }
})

Page.prototype.$spliceData()

 $spliceData同样用于将数据从逻辑层发送到视图层,但是相比于setData,在处理长列表的时候,其具有更高的性能。$spliceData接受一个对象作为参数。

对象的键名key可以非常灵活,以数据路径的形式给出,如 array[2].message、a.b.c.d,并且不需要在this.data中预先定义。对象的value为一个数组(格式:[start, deleteCount, …items]),数组的第一个元素为操作的起始位置,第二个元素为删除的元素的个数,剩余的元素均为插入的数据。对应es5中数组的splice方法。

<!-- page.axml -->
<view class="spliceData">
  <view a:for="{{a.b}}" key="{{item}}" style="border:1px solid red">
    {{item}}
  </view>
</view>
// page.js
Page({
  data: {
    a: {
      b: [1,2,3,4]
    }
  },
  onLoad(){
    this.$spliceData({ 'a.b': [1, 0, 5, 6] })
  },
})

页面样式

每个页面中的根元素为 page,需要设置高度或者背景色时,可以使用这个元素。

page {
  background-color: #fff;
}

这里也留一个坑?下次单独学习一下acss

getCurrentPages

getCurrentPages()函数用于获取当前页面栈的实例,以数组形式按栈的顺序给出,第一个元素为首页,最后一个元素为当前页面。检测当前页面栈是否具有5层页面深度:

if(getCurrentPages().length === 5) {
  dd.redirectTo({url:'/xx'});
} else {
  dd.navigateTo({url:'/xx'});
}

不要尝试修改页面栈,会导致路由以及页面状态错误。

框架以栈的形式维护了当前的所有页面。 当发生路由切换的时候,页面栈的表现如下:
在这里插入图片描述

axml视图层

视图层概述

视图文件的后缀名是axml,定义了页面的标签结构。AXML是小程序框架设计的一套标签语言,用于描述小程序页面的结构。
AXML语法可分为五个部分:

  • 数据绑定
  • 列表渲染
  • 条件渲染
  • 模板
  • 事件

数据绑定:

<view> {{message}} </view>
// page.js
Page({
  data: {
    message: 'Hello dingtalk!'
  }
})

列表渲染:

<view a:for="{{items}}"> {{item}} </view>
// page.js
Page({
  data: {
    items: [1, 2, 3, 4, 5, 6, 7]
  }
})

条件渲染:

<view a:if="{{view == 'WEBVIEW'}}"> WEBVIEW </view>
<view a:elif="{{view == 'APP'}}"> APP </view>
<view a:else> dingtalk </view>
// page.js
Page({
  data: {
    view: 'dingtalk'
  }
})

模板:

<template name="staffName">
  <view>
    FirstName: {{firstName}}, LastName: {{lastName}}
  </view>
</template>

<template is="staffName" data="{{...staffA}}"></template>
<template is="staffName" data="{{...staffB}}"></template>
<template is="staffName" data="{{...staffC}}"></template>
// page.js
Page({
  data: {
    staffA: {firstName: 'san', lastName: 'zhang'},
    staffB: {firstName: 'si', lastName: 'li'},
    staffC: {firstName: 'wu', lastName: 'wang'},
  },
})

事件:

<view onTap="add"> {{count}} </view>
Page({
  data: {
    count: 1
  },
  add(e) {
    this.setData({
      count: this.data.count + 1
    })
  }
})

数据绑定

AXML中的动态数据均来自对应 Page 的data

简单绑定

数据绑定使用 Mustache 语法(双大括号)将变量包起来

2021/6/30


  • 作用于内容:
<view> {{ message }} </view>
Page({
  data: {
    message: 'Hello dingtalk!'
  }
})
  • 作用于组件属性(需要在双引号之内)
<view id="item-{{id}}"> </view>
Page({
  data: {
    id: 0
  }
})
  • 作用于控制属性
<view a:if="{{condition}}"> </view>
Page({
  data: {
    condition: true
  }
})
  • 作用于关键字,需要在双引号之内
<checkbox checked="{{false}}"> </checkbox>

要直接写checked=“false”,计算结果是一个字符串,转成布尔值类型后代表true

运算

  • 三元运算
<view hidden="{{flag ? true : false}}"> Hidden </view>
  • 算数运算
<view> {{a + b}} + {{c}} + d </view>
Page({
  data: {
    a: 1,
    b: 2,
    c: 3
  }
})
  • 逻辑判断
<view a:if="{{length > 5}}"> </view>
  • 字符串运算
<view>{{"hello" + name}}</view>
Page({
  data:{
    name: 'dingtalk'
  }
})
  • 数据路径运算
<view>{{object.key}} {{array[0]}}</view>
Page({
  data: {
    object: {
      key: 'Hello '
    },
    array: ['dingtalk']
  }
})

组合

  • 数组
<view a:for="{{[zero, 1, 2, 3, 4]}}"> {{item}} </view>
Page({
  data: {
    zero: 0
  }
})
  • 对象
<template is="objectCombine" data="{{foo: a, bar: b}}"></template>
Page({
  data: {
    a: 1,
    b: 2
  }
})

最终组合成的对象是 {foo: 1, bar: 2}。也可以用扩展运算符…来将一个对象展开。

<template is="objectCombine" data="{{...obj1, ...obj2, e: 5}}"></template>
Page({
  data: {
    obj1: {
      a: 1,
      b: 2
    },
    obj2: {
      c: 3,
      d: 4
    }
  }
})

条件渲染

a:if

使用 a:if="{{condition}}" 来判断是否需要渲染该代码块。

<view a:if="{{condition}}"> True </view>

<view a:if="{{length > 5}}"> 1 </view>
<view a:elif="{{length > 2}}"> 2 </view>
<view a:else> 3 </view>

block a:if

因为a:if是一个控制属性,需要将它添加到一个标签上。如果想一次性判断多个组件标签,可以使用一个 标签将多个组件包装起来,并在它的上边使用a:if来控制属性。

<block a:if="{{true}}">
  <view> view1 </view>
  <view> view2 </view>
</block>

列表渲染

a:for

在组件上使用a:for属性可以绑定一个数组,然后就可以使用数组中各项的数据重复渲染该组件。默认数组的当前项的下标变量名默认为index,数组当前项的变量名默认为item。

<view a:for="{{array}}">
  {{index}}: {{item.message}}
</view>
Page({
  data: {
    array: [{
      message: 'foo',
    }, {
      message: 'bar'
    }]
  }
})

使用a:for-item可以指定数组当前元素的变量名。使用a:for-index可以指定数组当前下标的变量名。

<view a:for="{{array}}" a:for-index="idx" a:for-item="itemName">
  {{idx}}: {{itemName.message}}
</view>

a:for也可以嵌套,下边是一个九九乘法表。

<view a:for="{{[1, 2, 3, 4, 5, 6, 7, 8, 9]}}" a:for-item="i">
  <view a:for="{{[1, 2, 3, 4, 5, 6, 7, 8, 9]}}" a:for-item="j">
    <view a:if="{{i <= j}}">
      {{i}} * {{j}} = {{i * j}}
    </view>
  </view>
</view>

block a:for

<block a:for="{{[1, 2, 3]}}">
  <view> {{index}}: </view>
  <view> {{item}} </view>
</block>

a:key

如果列表中项目的位置会动态改变或者有新的项目添加到列表中,同时希望列表中的项目保持自己的特征和状态(比如 <input/> 中的输入内容,<switch/> 的选中状态),需要使用 a:key 来指定列表中项目的唯一的标识符。a:key的值以两种形式来提供。

  • 字符串,代表在for循环的array中item的某个属性。该属性的值需要是列表中唯一的字符串或数字,并且不能动态的改变。
  • 保留关键字*this,代表在for循环中的item本身,表示需要item本身是唯一的字符串或者数字,比如当数据改变触发渲染层重新执行渲染的时候,会校正带有key的组件,框架会确保他们重新被排序,而不是重新创建,确保使组件保持自身的状态,并且提高列表渲染时的效率。
<view class="container">
  <view a:for="{{list}}" a:key="*this">
    <view onTap="bringToFront" data-value="{{item}}">
    {{item}}: click to bring to front
    </view>
  </view>
</view>
Page({
  data:{
    list:['1', '2', '3', '4'],
  },
  bringToFront(e) {
    const { value } = e.target.dataset;
    const list = this.data.list.concat();
    const index = list.indexOf(value);
    if (index !== -1) {
      list.splice(index, 1);
      list.unshift(value);
      this.setData({ list });
    }
  }
});

key

<view class="container">
  <view a:for="{{list}}" key="{{item}}">
    <view onTap="bringToFront" data-value="{{item}}">
    {{item}}: click to bring to front
    </view>
  </view>
</view>
Page({
  data:{
    list:['1', '2', '3', '4'],
  },
  bringToFront(e) {
    const { value } = e.target.dataset;
    const list = this.data.list.concat();
    const index = list.indexOf(value);
    if (index !== -1) {
      list.splice(index, 1);
      list.unshift(value);
      this.setData({ list });
    }
  }
});

同时可以利用 key 来防止组件的复用

<input a:if="{{name}}" placeholder="Enter your username">
<input a:else placeholder="Enter your email address">

当你输入 name 然后切换到 email 时,当前输入值会保留,如果不想保留,可以加 key。

<input key="name" a:if="{{name}}" placeholder="Enter your username">
<input key="email" a:else placeholder="Enter your email address">

引用

import

.axml中定义了一个叫item的template

<!-- item.axml -->
<template name="item">
  <text>{{text}}</text>
</template>

.axml中引用.axml,就可以使用item模板。

<import src="./item.axml"/>
<template is="item" data="{{text: 'forbar'}}"/>

import有作用域的概念,只会import目标文件中定义的template。比如,C import B,B import A,在C中可以使用B定义的template,在B中可以使用A定义的template,但是C不能使用A中定义的template。

<!-- A.axml -->
<template name="A">
  <text> A template </text>
</template>
<!-- B.axml -->
<import src="./a.axml"/>
<template name="B">
  <text> B template </text>
</template>
<!-- C.axml -->
<import src="./b.axml"/>
<template is="A"/>  <!-- Error! Can not use tempalte when not import A. -->
<template is="B"/>

include

include可以将目标文件除了的整个代码引入,相当于是拷贝到include位置。

<!-- index.axml -->
<include src="./header.axml"/>
<view> body </view>
<include src="./footer.axml"/>
<!-- header.axml -->
<view> header </view>
<!-- footer.axml -->
<view> footer </view>

模板

AXML提供模板(template),可以在模板中定义代码片段,在不同的地方调用。此处 template 区别于 slot

slot留一个?

定义模板

使用name属性,作为模板的名字,然后在<template/>内定义代码片段。

<!--
  index: int
  msg: string
  time: string
-->
<template name="msgItem">
  <view>
    <text> {{index}}: {{msg}} </text>
    <text> Time: {{time}} </text>
  </view>
</template>

使用模板

使用is属性,声明需要使用的模板,然后将该模板所需要的data传入

<template is="msgItem" data="{{...item}}"/>
Page({
  data: {
    item: {
      index: 0,
      msg: 'this is a template',
      time: '2016-09-15'
    }
  }
})

is属性可以使用Mustache语法,来动态决定具体需要渲染哪个模板。

<template name="odd">
  <view> odd </view>
</template>
<template name="even">
  <view> even </view>
</template>

<block a:for="{{[1, 2, 3, 4, 5]}}">
    <template is="{{item % 2 == 0 ? 'even' : 'odd'}}"/>
</block>

模板作用域

模板拥有自己的作用域,只能用data传入的数据,但可以通过 onXX 绑定页面的逻辑处理函数。推荐用 template 方式来引入模版片段,因为 template 会指定自己的作用域,只使用data传入的数据,因此应用会对此进行优化。如果该 template 的 data 没有改变,该片段 UI 并不会重新渲染。引入路径支持从 node_modules 目录载入第三方模块.

<import src="./a.axml"/> <!-- 相对路径 -->
<import src="/a.axml"/> <!-- 项目绝对路径 -->
<import src="third-party/x.axml"/> <!-- 第三方 npm 包路径 -->

版权声明:本文为weixin_44513969原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。