钉钉小程序——JSAPI

钉钉小程序在某些原生组件及api无法实现需求的情况下，可以在钉钉微应用文档中寻求相应帮助。其中JSAPI的调用使我受益匪浅。

JSAPI为应用提供了调用原生控件的能力

1.使用方法及准备：

使用npm安装dingtalk-jsapi扩展模块，

 npm install dingtalk-jsapi --save 

在需要使用的js文件开头添加

 import * as dd from 'dingtalk-jsapi'; // 此方式为整体加载，也可按需进行加载 

进行加载

 dd 可能会和系统的dd.alert等方法冲突，所以import时尽量自定义其他名称如ee;

如下

 import * as ee from 'dingtalk-jsapi'; // 此方式为整体加载，也可按需进行加载  

2.可以使用的扩展功能

查看官方连接：https://ding-doc.dingtalk.com/doc#/dev/swk0bg

3.我用到的扩展功能的具体使用方法

（1）退出小程序

在原生api中没有找到相应的用法

然后调用了

关闭当前页面

biz.navigation.close

dd.biz.navigation.close({
    onSuccess : function(result) {
        /*result结构
        {}
        */
    },
    onFail : function(err) {}
})

在小程序首页调用该方法可以关闭小程序

注意：dd.biz.navigation.close中开头的dd最好改为import时as的自定义名称。

（2）调用第三方网页

在新窗口上打开链接

biz.util.openLink

 使用该方法后，原本显示无法跳转的网页，可以正常访问。

dd.biz.util.openLink({
    url:"http://www.dingtalk.com",//要打开链接的地址
    onSuccess : function(result) {
        /**/
    },
    onFail : function(err) {}
})

（3）更改系统返回按钮名称及功能

设置左侧导航按钮文本

biz.navigation.setLeft

dd.biz.navigation.setLeft({
    control: true,//是否控制点击事件，true 控制，false 不控制， 默认false
    text: '',//控制显示文本，空字符串表示显示默认文本
    onSuccess : function(result) {
        /*
        {}
        */
        //如果control为true，则onSuccess将在发生按钮点击事件被回调
    },
    onFail : function(err) {}
});