@tarojs/taro 3.5.5-alpha.1 → 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-alpha.1",
+  "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-alpha.1",
-    "@tarojs/runtime": "3.5.5-alpha.1"
+    "@tarojs/api": "3.5.6",
+    "@tarojs/runtime": "3.5.6"
   },
   "peerDependenciesMeta": {
     "@types/react": {

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

@@ -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/share/index.d.ts

@@ -44,10 +44,10 @@ declare module '../../index' {
       /** 是否使用带 shareTicket 的转发[详情](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/share.html) */
       withShareTicket?: boolean
       /** QQ小程序分享功能，支持分享到QQ、QQ空间、微信好友、微信朋友圈
-      * QQ支持的值： ['qq', 'qzone', 'wechatFriends', 'wechatMoment']
-      * 微信支持：['wechatFriends', 'wechatMoment'] / ['shareAppMessage', 'shareTimeline']
-      * @supported qq/weapp
-      */
+       * @supported weapp, qq
+       * @qq QQ支持的值： ['qq', 'qzone', 'wechatFriends', 'wechatMoment']
+       * @weapp 微信支持：['wechatFriends', 'wechatMoment'] / ['shareAppMessage', 'shareTimeline']
+       */
       showShareItems?: string[]
     }
   }