@tarojs/taro 3.5.5 → 3.5.6

package/html5.css

@@ -60,7 +60,7 @@
 
 .h5-marquee {
   display: inline-block;
-  width: fill-available;
+  width: stretch;
 }
 
 .h5-address {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.5.5",
+  "version": "3.5.6",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -21,8 +21,8 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.5.5",
-    "@tarojs/runtime": "3.5.5"
+    "@tarojs/api": "3.5.6",
+    "@tarojs/runtime": "3.5.6"
   },
   "peerDependenciesMeta": {
     "@types/react": {

package/types/api/canvas/index.d.ts

@@ -126,6 +126,21 @@ declare module '../../index' {
     }
   }
 
+  namespace createOffscreenCanvas {
+    interface Option {
+      /** 创建的离屏 canvas 类型
+       * @default: 'webgl'
+       */
+      type?: 'webgl' | '2d'
+      /** 画布高度 */
+      height?: number
+      /** 画布宽度 */
+      width?: number
+      /** 在自定义组件下，当前组件实例的 this，以操作组件内 [canvas](/docs/components/canvas) 组件 */
+      component?: TaroGeneral.IAnyObject,
+    }
+  }
+
   /** Canvas 实例，可通过 SelectorQuery 获取。
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/canvas/Canvas.html
    */
@@ -1705,8 +1720,13 @@ declare module '../../index' {
     /** 创建离屏 canvas 实例
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/canvas/wx.createOffscreenCanvas.html
+     *
+     * 有两个版本的写法：
+     *
+     * - createOffscreenCanvas(options) 从 2.16.1 起支持
+     * - createOffscreenCanvas(width, height, this) 从 2.7.0 起支持
      */
-    createOffscreenCanvas(): OffscreenCanvas
+    createOffscreenCanvas(options: createOffscreenCanvas.Option): OffscreenCanvas
 
     /** 创建 canvas 的绘图上下文 [CanvasContext](/docs/apis/canvas/CanvasContext) 对象
      *

package/types/api/location/index.d.ts

@@ -79,9 +79,9 @@ declare module '../../index' {
       /** 详细地址 */
       address: string
       /** 纬度，浮点数，范围为-90~90，负数表示南纬。使用 gcj02 国测局坐标系 */
-      latitude: string
+      latitude: number
       /** 经度，浮点数，范围为-180~180，负数表示西经。使用 gcj02 国测局坐标系 */
-      longitude: string
+      longitude: number
     }
   }
 
@@ -109,9 +109,9 @@ declare module '../../index' {
       /** 详细地址 */
       address: string
       /** 纬度，浮点数，范围为-90~90，负数表示南纬。使用 gcj02 国测局坐标系 */
-      latitude: string
+      latitude: number
       /** 经度，浮点数，范围为-180~180，负数表示西经。使用 gcj02 国测局坐标系 */
-      longitude: string
+      longitude: number
       /** 位置名称 */
       name: string
       /** 调用结果 */
@@ -202,9 +202,9 @@ declare module '../../index' {
 
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
       /** 纬度，范围为 -90~90，负数表示南纬 */
-      latitude: string
+      latitude: number
       /** 经度，范围为 -180~180，负数表示西经 */
-      longitude: string
+      longitude: number
     }
   }
 
@@ -215,7 +215,7 @@ declare module '../../index' {
      */
     stopLocationUpdate(option?: stopLocationUpdate.Option): void
 
-    /** 开启小程序进入前后台时均接收位置消息，需引导用户开启[授权](./apis/open-api/authorize/authorize.md#后台定位)。授权以后，小程序在运行中或进入后台均可接受位置消息变化。
+    /** 开启小程序进入前后台时均接收位置消息，需引导用户开启[授权](../open-api/authorize/authorize.md#后台定位)。授权以后，小程序在运行中或进入后台均可接受位置消息变化。
      *
      * **注意**
      * - 安卓微信7.0.6版本，iOS 7.0.5版本起支持该接口

package/types/api/media/image.d.ts

@@ -260,6 +260,41 @@ declare module '../../index' {
     }
   }
 
+  namespace cropImage {
+    interface Option {
+      /** 图片路径，图片的路径，支持本地路径、代码包路径 */
+      src: string
+      /** 裁剪比例 */
+      cropScale: keyof CropScale
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 剪裁后图片的临时文件路径 (本地路径) */
+      tempFilePath: string
+    }
+    interface CropScale {
+      /** 宽高比为1比1 */
+      '1:1'
+      /** 宽高比为3比4 */
+      '3:4'
+      /** 宽高比为4比3 */
+      '4:3'
+      /** 宽高比为4比5 */
+      '4:5'
+      /** 宽高比为5比4 */
+      '5:4'
+      /** 宽高比为6比19 */
+      '6:19'
+      /** 宽高比为19比6 */
+      '19:6'
+    }
+  }
+
   interface TaroStatic {
     /** 保存图片到系统相册。需要[用户授权](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html) scope.writePhotosAlbum
      * @supported weapp, rn, alipay, swan, tt
@@ -385,5 +420,23 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html
      */
     chooseImage(option: chooseImage.Option): Promise<chooseImage.SuccessCallbackResult>
+
+    /**
+     * 裁剪图片接口
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.cropImage({
+     *   src: '', // 图片路径
+     *   cropScale: '1:1', // 裁剪比例
+     *   success: function (res) {
+     *     // 返回选定照片的本地文件路径列表，tempFilePath可以作为img标签的src属性显示图片
+     *     var tempFilePaths = res.tempFilePaths
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.cropImage.html
+     */
+     cropImage(option: cropImage.Option): Promise<cropImage.SuccessCallbackResult>
   }
 }

package/types/api/navigate/index.d.ts

@@ -87,57 +87,104 @@ declare module '../../index' {
 
   namespace openBusinessView {
     /**
-     * 业务参数：需要传递给支付分的业务数据
-     * @interface ExtraData
+     * wxpayScoreEnable 业务参数
+     * @see https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter6_1_9.shtml
      */
-    interface ExtraData {
+    interface ScoreEnableExtraData {
+      /**
+       * 用于跳转到微信侧小程序授权数据,跳转到微信侧小程序传入，有效期为1小时；apply_permissions_token可以从[《商户预授权API》](https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter6_1_2.shtml)接口的返回参数中获取。
+       * 示例值：1230000109
+       * @type {string[1,2048]}
+       */
+      apply_permissions_token: string
+    }
+    /**
+     * wxpayScoreUse 业务参数
+     * @see https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter6_1_13.shtml
+     */
+    interface ScoreUsedExtraData {
+      /**
+       * 商户号：微信支付分配的商户号。
+       * 示例值：1230000109
+       * @type {string[1,32]}
+       */
+      mch_id: string
+      /**
+       * 可在【创建订单】接口的返回字段package中获取。
+       * 示例值：XXXXXXXX
+       * @type {string[1,128]}
+       */
+      package: string
+      /**
+       * 时间戳：生成签名时间戳，单位秒。
+       * 示例值：1530097563
+       * @type {string[1,32]}
+       */
+      timestamp: string
+      /**
+       * 随机字符串：生成签名随机串。由数字、大小写字母组成，长度不超过32位。
+       * 示例值：zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2
+       * @type {string[1,32]}
+       */
+      nonce_str: string
+      /**
+       * 签名方式：签名类型，仅支持HMAC-SHA256。
+       * 示例值：HMAC-SHA256
+       * @type {string[1,32]}
+       */
+      sign_type: string
+      /**
+       * 签名：使用字段mch_id、service_id、out_order_no、timestamp、nonce_str、sign_type按照签名生成算法计算得出的签名值。
+       * 示例值：029B52F67573D7E3BE74904BF9AEA
+       * @type {string[1,64]}
+       */
+      sign: string
+    }
+    /**
+     * wxpayScoreDetail 业务参数
+     * @see https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter6_1_25.shtml
+     */
+    interface ScoreDetailExtraData {
       /**
        * 商户号：微信支付分配的商户号。
        * 示例值：1230000109
        * @type {string[1,32]}
-       * @memberof ExtraData
        */
       mch_id: string
       /**
        * 服务ID
        * 示例值：88888888000011
        * @type {string[1,32]}
-       * @memberof ExtraData
        */
       service_id: string
       /**
        * 商户服务订单号：商户系统内部服务订单号（不是交易单号）。
        * 示例值：234323JKHDFE1243252
        * @type {string[1,32]}
-       * @memberof ExtraData
        */
       out_order_no: string
       /**
        * 时间戳：生成签名时间戳，单位秒。
        * 示例值：1530097563
        * @type {string[1,32]}
-       * @memberof ExtraData
        */
       timestamp: string
       /**
        * 随机字符串：生成签名随机串。由数字、大小写字母组成，长度不超过32位。
        * 示例值：zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2
        * @type {string[1,32]}
-       * @memberof ExtraData
        */
       nonce_str: string
       /**
        * 签名方式：签名类型，仅支持HMAC-SHA256。
        * 示例值：HMAC-SHA256
        * @type {string[1,32]}
-       * @memberof ExtraData
        */
       sign_type: string
       /**
        * 签名：使用字段mch_id、service_id、out_order_no、timestamp、nonce_str、sign_type按照签名生成算法计算得出的签名值。
        * 示例值：029B52F67573D7E3BE74904BF9AEA
        * @type {string[1,64]}
-       * @memberof ExtraData
        */
       sign: string
     }
@@ -149,8 +196,9 @@ declare module '../../index' {
        * @type {string[1,16]}
        * @memberof Option
        */
-      businessType: string
-      extraData: ExtraData
+      businessType: 'wxpayScoreEnable' | 'wxpayScoreUse' | 'wxpayScoreDetail' | string
+      /** 业务参数：需要传递给支付分的业务数据 */
+      extraData: ScoreEnableExtraData | ScoreUsedExtraData | ScoreDetailExtraData
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
@@ -259,7 +307,6 @@ declare module '../../index' {
      *   //引导用户升级微信版本
      * }
      * ```
-     *
      * @see https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter6_1_25.shtml
      */
     openBusinessView(option: openBusinessView.Option): Promise<TaroGeneral.CallbackResult>

package/types/api/share/index.d.ts

@@ -44,9 +44,10 @@ declare module '../../index' {
       /** 是否使用带 shareTicket 的转发[详情](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/share.html) */
       withShareTicket?: boolean
       /** QQ小程序分享功能，支持分享到QQ、QQ空间、微信好友、微信朋友圈
-      * 支持的值： ['qq', 'qzone', 'wechatFriends', 'wechatMoment']
-      * @supported qq
-      */
+       * @supported weapp, qq
+       * @qq QQ支持的值： ['qq', 'qzone', 'wechatFriends', 'wechatMoment']
+       * @weapp 微信支持：['wechatFriends', 'wechatMoment'] / ['shareAppMessage', 'shareTimeline']
+       */
       showShareItems?: string[]
     }
   }
@@ -178,7 +179,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.updateShareMenu.html
      */
-    updateShareMenu(option: updateShareMenu.Option): Promise<TaroGeneral.CallbackResult>
+    updateShareMenu (option: updateShareMenu.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 显示当前页面的转发按钮
      * @supported weapp, qq, tt
@@ -190,7 +191,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.showShareMenu.html
      */
-    showShareMenu(option: showShareMenu.Option): Promise<TaroGeneral.CallbackResult>
+    showShareMenu (option: showShareMenu.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 打开分享图片弹窗，可以将图片发送给朋友、收藏或下载
      * @supported weapp
@@ -207,7 +208,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.showShareImageMenu.html
      */
-    showShareImageMenu(option: showShareImageMenu.Option): Promise<TaroGeneral.CallbackResult>
+    showShareImageMenu (option: showShareImageMenu.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 转发视频到聊天
      * @supported weapp
@@ -242,13 +243,13 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.shareVideoMessage.html
      */
-    shareVideoMessage(option: shareVideoMessage.Option): Promise<TaroGeneral.CallbackResult>
+    shareVideoMessage (option: shareVideoMessage.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 转发文件到聊天
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.shareFileMessage.html
      */
-    shareFileMessage(option: shareFileMessage.Option): Promise<TaroGeneral.CallbackResult>
+    shareFileMessage (option: shareFileMessage.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 监听用户点击右上角菜单的「复制链接」按钮时触发的事件
      *
@@ -256,7 +257,7 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.onCopyUrl.html
      */
-    onCopyUrl(
+    onCopyUrl (
       /** 用户点击右上角菜单的「复制链接」按钮时触发的事件的回调函数 */
       callback: onCopyUrl.Callback,
     ): void
@@ -267,7 +268,7 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.offCopyUrl.html
      */
-    offCopyUrl(
+    offCopyUrl (
       /** 用户点击右上角菜单的「复制链接」按钮时触发的事件的回调函数 */
       callback: onCopyUrl.Callback,
     ): void
@@ -280,7 +281,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.hideShareMenu.html
      */
-    hideShareMenu(option?: hideShareMenu.Option): Promise<TaroGeneral.CallbackResult>
+    hideShareMenu (option?: hideShareMenu.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 获取转发详细信息
      *
@@ -297,7 +298,7 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.getShareInfo.html
      */
-    getShareInfo(option: getShareInfo.Option): Promise<getShareInfo.SuccessCallbackResult>
+    getShareInfo (option: getShareInfo.Option): Promise<getShareInfo.SuccessCallbackResult>
 
     /** 验证私密消息
      * @supported weapp
@@ -322,6 +323,6 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/share/wx.authPrivateMessage.html
      */
-    authPrivateMessage(option: authPrivateMessage.Option): Promise<authPrivateMessage.SuccessCallbackResult>
+    authPrivateMessage (option: authPrivateMessage.Option): Promise<authPrivateMessage.SuccessCallbackResult>
   }
 }