Yc-alipay-miniapp NPM

components

form-page

==除webview外的页面需用此组件包含，可捕获并记录用户点击产生的formid 同时还有启动参数弹窗和getUserId返回的自动弹窗==

<!-- page.json 中-->
{
  "usingComponents": {
    "form-page": "yc-alipay-miniapp/components/form-page/form-page"
  }
}
<!-- page.axml 中-->
<form-page><!--页面主内容--></form-page>

start1和start2

==原用于投放的start1、start2页面改为组件，页面写法参考“a插件示例”项目中的/pages/start1/start1==

<!-- page.json 中-->
{
  "usingComponents": {
    "start1": "yc-alipay-miniapp/components/start1/start1",
    "start2": "yc-alipay-miniapp/components/start2/start2"
  }
}
<!-- page.axml 中-->
<start1></start1>
<start2></start2>

webview

==目前小程序中的webview功能应保持一致，后续webview页面直接使用组件，方便维护，具体使用参考“a插件示例”项目中的/pages/webview/webview==

<!-- page.json 中-->
{
  "usingComponents": {
    "webview": "yc-alipay-miniapp/components/webview/webview"
  }
}
<!-- page.axml 中-->
<webview></webview>

pages

==pages中的页面可直接在app.json中引用，后续通用页面(类似start1、webview)可直接在此开发==

// app.json
{
  "pages": [
    "node_modules/yc-alipay-miniapp/pages/webview/webview"
  ]
}

index.acss

==定义了常用的一些样式类和动画，可选择在app.acss中引入，参考“a插件示例”项目==

// app.acss
@import 'yc-alipay-miniapp/index.acss';

index.js

==index.js应与app.js结合使用，参考“a插件示例”项目==

// app.js
import alipayCommon from 'yc-alipay-miniapp';

App(Object.assign(alipayCommon, {    // 初始化App，此处定义的方法会覆盖插件同名方法
  globalData: Object.assign(alipayCommon.globalData, {    // app.js定义的globalData与插件混合，优先级高于插件
    defaultApi: 'https://zfbapi.yuchuantech.com/common',   // 默认接口，调用app.request时若没传url参数，则使用此地址，改成相应项目地址
    getUserIdApi: 'https://zfbapi.yuchuantech.com/getUserid',   // 获取uid接口，改成相应项目地址
  }),
  onLaunch(options) {    // 第一次打开
    this.globalData.scene = options.scene;
    this.globalData.launchQuery = options.query || {};
  },
  onShow(options) {   // 从后台被 scheme 重新打开
    this.globalData.onShowScene = options.scene;
  },
}));

==index.js中定义的公共方法== 方法名 | 参数 | 说明 ---|---|--- alert(content, title) | content(必填)，title(选填，默认=提示) | 强提示 showToast(content) | content(必填) | 弱提示 md5(text) | text(必填) | md5加密 getCurrentPage(pageInstance) | pageInstance(选填) | 获取当前页面信息，pageInstance没传则返回页面栈最顶部页面 createRequestSign(opt) | opt(必填) | request请求时带的签名sign，==根据各小程序需求在app.js中重写==，opt包含请求url和data(带timestamp) ==request(opt)== | opt(必填，与my.request一致) | 封装请求，会加入appId、userId等公共参数，success返回剥掉请求结果层，直接返回接口data getUserId(callback, context) | callback(选填)，context(选填) | 获取用户uid，callback选填，获取uid成功后会执行，context为callback上下文环境，若callback为箭头函数，则不需要传 saveFormId(formId) | formId(必填) | 保存formId handlePageQuery(query, pageViewId) | query(选填)，pageViewId(选填) | 处理页面onLoad和onShow时的参数，处理启动跳转及打点 recordUserTrack(opt) | opt(必填) | 用户行为打点，opt={ pages:'页面',type:'行为类型','typeId':'行为类型标识',other:'打点备注' } formatDate(date, format) | date(必填)，format(必填) | 格式化日期，date为日期对象或正确的日期字符串，format为目标格式，如yyyy-mm-dd HH:MM:SS ==goUrl(opt)== | opt(必填) | 跳转，opt至少包含actionType和url，actionType=1小程序内部跳转，actionType=2跳转其他小程序，actionType=3或4跳转任意地址，actionType=5重启小程序路径，actionType=6重定向小程序路径