Dingtalk-jsapi NPM

钉钉多端统一jsapi

此jsApi支持运行于android, ios, pc，钉钉小程序环境，且保持开发体验一致。

安装

dingtalk-jsapi 现在可从 npm 上安装.

npm install dingtalk-jsapi

推荐使用npm包形式按需引入

新的特性

除了兼容现钉钉开放平台提供的jsapi的特性，还支持以下下特性

支持返回原生Promise
支持模块化引入api，模块化引入平台
支持dd.checkJsApi, 用于检测当前环境是否支持此jsApi
提供dd.on, dd.off来绑定事件，用于同一绑定事件，替代document.addEventListener,document.removeEventListener
添加dd.env来读取当前环境变量
支持typescript的接口定义，接口定义还在持续添加中，如有纰漏欢迎反馈

使用介绍

1. 按需引入

整体调用

import * as dd from 'dingtalk-jsapi';
dd.device.notification.alert({
    message: "亲爱的",
    title: "提示",//可传空
    buttonName: "收到",
}).then(() => {
    //成功即相当于 onSuccess
}, () => {
    //失败即相当于 onFail
});

按需调用

import 'dingtalk-jsapi/entry/mobile'; // 只引入移动端（支持小程序）
// import 'dingtalk-jsapi/entry/union'; // 如果你想要在此代码在PC端和移动端都执行，那你可以如此引入
import alert from 'dingtalk-jsapi/api/device/notification/alert'; // 按需引入方法

alert({
    message: "亲爱的",
    title: "提示",//可传空
    buttonName: "收到",
}).then(() => {
    //成功即相当于 onSuccess
}, () => {
    //失败即相当于 onFail
});

dd.ready优化

旧版本pc调用接口

//首先你鉴权需要权限
dd.config({
    agentId: '', // 必填，微应用ID
    corpId: '',//必填，企业ID
    timeStamp: , // 必填，生成签名的时间戳
    nonceStr: '', // 必填，生成签名的随机串
    signature: '', // 必填，签名
    type:0/1,   //选填，0表示微应用的jsapi，1表示服务窗的jsapi，不填默认为0。该参数从dingtalk.js的0.8.3版本开始支持
    jsApiList:[
        'biz.contact.choose',
    ],
});

//然后因为鉴权是异步的，所以你的方法需要包括在dd.ready, config校验完成后的钩子
dd.ready(() => {
    dd.device.notification.alert({
        message: "亲爱的",
        title: "提示",//可传空
        buttonName: "收到",
    }).then(() => {
        //成功即相当于 onSuccess
    }, () => {
        //失败即相当于 onFail
    });
})

新版本pc调用接口

dd.config({
    agentId: '', // 必填，微应用ID
    corpId: '',//必填，企业ID
    timeStamp: , // 必填，生成签名的时间戳
    nonceStr: '', // 必填，生成签名的随机串
    signature: '', // 必填，签名
    type:0/1,   //选填，0表示微应用的jsapi，1表示服务窗的jsapi，不填默认为0。该参数从dingtalk.js的0.8.3版本开始支持
    jsApiList:[
        'device.notification.alert',
    ],
});

// 优化后不再需要包括dd.ready，接口自动延后执行
dd.device.notification.alert({
    message: "亲爱的",
    title: "提示",//可传空
    buttonName: "收到",
}).then(() => {
    //成功即相当于 onSuccess
}, () => {
    //失败即相当于 onFail
});

反馈渠道

亲爱的开发者，为了更好的提高服务效率和问题沉淀，在开发过程中如果遇到问题，可以有以下方式获取技术支持：【推荐】登录开发者后台，https://open-dev.dingtalk.com，在右下角有“在线帮助”（人工客服时间：工作日10:00~12:00，14:00~18:00, 19:00~21:00）

最终解释权归阿里巴巴钉钉事业部所有。

promise-polyfill

@titaui/pc feedback-ui srm-ui-m lst_front_mobile_refact @bingoit/workbench-ui @infinitebrahmanuniverse/nolb-din uwell-dd-auth mtjj mtjjn @everything-registry/sub-chunk-1481 td_sdk sz-login table-set wl-design-mobile vurpress-ui-ionic xm-dev-helper template-admin-react vue-components-pgh @rossroma/xbb-front-sdk @rtarojs/router jh-delvery-server jufubao-base lcdp-app-engine venyuan-uniapp-ts venyuan-uniapp-v3 string-public-design string-public-design-3 string-framework string-framework-v3 uic-lib tinymcec @alifd/chat @alizw/tesseract @aligov/gov-h5-rate-rax-sdk @aliedu/app-release-opt @aliedu/autologin @aliedu/cube-student-manage @aliedu/freelogin @aliedu/scanlogin @aliedu/student-active-4mobile @aliedu/user-center @chaoswise/utils yccw-common youzu-dingding-permission yzgl2.0 unv-ic-lib @feizheng/next-dd-promisfy-all @dtdreamedu/freelogin @goocan/goocan-ui @lingxiteam/engine-mobile @lingxiteam/engine-mobile-1 @newpearl/mui @ecomaping/admin-antd @mjcloud/jsapi @jxstjh/auth-client @qse/edu-login @restcloud-npm/rc-lowcode-component mos-test-ui-ionic midway-lib operating-config-mobile nti-package-application nti-package-scaffold nti-package-wangdi scan-login-mf nbugs-mobile-image-viewer plugin-webpack risen-mpm-design rlj-utils smart-lib-sso sk-jsapi gk-comment-demo gk-comments-h5 ibiz-ui-ionic ibz-ui-ionic hdkj-mue heroeyes-platform-sdk investment-gzjg investment-gzjg-simple lk-login-comp levitation-3 lczmicroapp @tq-prism3/prism-h5 @vnxjs/router @vnmfjs/router @yccw/common @zhusgtest/runtime-core @zhusgtest/security @tarojs/router ayoh-dingtalk apc-render-form apply-clients-zhenhua chaos-sso-login chaos-sso-util ddconfig dingtalk-design-libs dingtalk-design-mobile dgykits ding-helper dingtalk-service-window-libs dingtalk-worktab-plugin-script

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

6 months ago

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago

7 years ago