@tarojs/taro 3.5.0-alpha.8 → 3.5.0-beta.1

package/types/api/ui/animation.d.ts

@@ -38,34 +38,34 @@ declare module '../../index' {
   }
 
   /** 动画对象
-   * @supported weapp, h5
+   * @supported weapp, h5, tt
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.html
    */
   interface Animation {
     /** 导出动画队列。**export 方法每次调用后会清掉之前的动画操作**。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.export.html
      */
     export(): {
       actions: TaroGeneral.IAnyObject[]
     }
     /** 表示一组动画完成。可以在一组动画中调用任意多个动画方法，一组动画中的所有动画会同时开始，一组动画完成后才会进行下一组动画。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.step.html
      */
     step(option?: Animation.StepOption): Animation
     /** 同 [transform-function matrix](https://developer.mozilla.org/en-US/docs/Web/CSS/transform-function/matrix)
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.matrix.html
      */
     matrix(a: number, b: number, c: number, d: number, tx: number, ty: number): Animation
     /** 同 [transform-function matrix3d](https://developer.mozilla.org/en-US/docs/Web/CSS/transform-function/matrix3d)
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.matrix3d.html
      */
     matrix3d(a1: number, b1: number, c1: number, d1: number, a2: number, b2: number, c2: number, d2: number, a3: number, b3: number, c3: number, d3: number, a4: number, b4: number, c4: number, d4: number): Animation
     /** 从原点顺时针旋转一个角度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotate.html
      */
     rotate(
@@ -73,7 +73,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 从 固定 轴顺时针旋转一个角度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotate3d.html
      */
     rotate3d(
@@ -87,7 +87,7 @@ declare module '../../index' {
       angle?: number,
     ): Animation
     /** 从 X 轴顺时针旋转一个角度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotateX.html
      */
     rotateX(
@@ -95,7 +95,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 从 Y 轴顺时针旋转一个角度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotateY.html
      */
     rotateY(
@@ -103,7 +103,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 从 Z 轴顺时针旋转一个角度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.rotateZ.html
      */
     rotateZ(
@@ -111,7 +111,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 缩放
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scale.html
      */
     scale(
@@ -121,7 +121,7 @@ declare module '../../index' {
       sy?: number,
     ): Animation
     /** 缩放
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scale3d.html
      */
     scale3d(
@@ -133,7 +133,7 @@ declare module '../../index' {
       sz: number,
     ): Animation
     /** 缩放 X 轴
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scaleX.html
      */
     scaleX(
@@ -141,7 +141,7 @@ declare module '../../index' {
       scale: number,
     ): Animation
     /** 缩放 Y 轴
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scaleY.html
      */
     scaleY(
@@ -149,7 +149,7 @@ declare module '../../index' {
       scale: number,
     ): Animation
     /** 缩放 Z 轴
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.scaleZ.html
      */
     scaleZ(
@@ -157,7 +157,7 @@ declare module '../../index' {
       scale: number,
     ): Animation
     /** 对 X、Y 轴坐标进行倾斜
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.skew.html
      */
     skew(
@@ -167,7 +167,7 @@ declare module '../../index' {
       ay: number,
     ): Animation
     /** 对 X 轴坐标进行倾斜
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.skewX.html
      */
     skewX(
@@ -175,7 +175,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 对 Y 轴坐标进行倾斜
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.skewY.html
      */
     skewY(
@@ -183,7 +183,7 @@ declare module '../../index' {
       angle: number,
     ): Animation
     /** 平移变换
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translate.html
      */
     translate(
@@ -193,7 +193,7 @@ declare module '../../index' {
       ty?: number,
     ): Animation
     /** 对 xyz 坐标进行平移变换
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translate3d.html
      */
     translate3d(
@@ -205,7 +205,7 @@ declare module '../../index' {
       tz?: number,
     ): Animation
     /** 对 X 轴平移
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translateX.html
      */
     translateX(
@@ -213,7 +213,7 @@ declare module '../../index' {
       translation: number,
     ): Animation
     /** 对 Y 轴平移
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translateY.html
      */
     translateY(
@@ -221,7 +221,7 @@ declare module '../../index' {
       translation: number,
     ): Animation
     /** 对 Z 轴平移
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.translateZ.html
      */
     translateZ(
@@ -229,7 +229,7 @@ declare module '../../index' {
       translation: number,
     ): Animation
     /** 设置透明度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.opacity.html
      */
     opacity(
@@ -237,7 +237,7 @@ declare module '../../index' {
       value: number,
     ): Animation
     /** 设置背景色
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.backgroundColor.html
      */
     backgroundColor(
@@ -245,7 +245,7 @@ declare module '../../index' {
       value: string,
     ): Animation
     /** 设置宽度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.width.html
      */
     width(
@@ -253,7 +253,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 设置高度
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.height.html
      */
     height(
@@ -261,7 +261,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 设置 left 值
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.left.html
      */
     left(
@@ -269,7 +269,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 设置 right 值
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.right.html
      */
     right(
@@ -277,7 +277,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 设置 top 值
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.top.html
      */
     top(
@@ -285,7 +285,7 @@ declare module '../../index' {
       value: number | string,
     ): Animation
     /** 设置 bottom 值
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/animation/Animation.bottom.html
      */
     bottom(
@@ -386,78 +386,14 @@ declare module '../../index' {
     translateY?: number | string
     /** Z 方向位移，即 CSS transform translateZ */
     translateZ?: number | string
-  }
-
-  /** @ignore */
-  interface ClearAnimationOptions {
-    /** 基点位置，即 CSS transform-origin */
-    transformOrigin?: boolean
-    /** 背景颜色，即 CSS background-color */
-    backgroundColor?: boolean
-    /** 底边位置，即 CSS bottom */
-    bottom?: boolean
-    /** 高度，即 CSS height */
-    height?: boolean
-    /** 左边位置，即 CSS left */
-    left?: boolean
-    /** 宽度，即 CSS width */
-    width?: boolean
-    /** 不透明度，即 CSS opacity */
-    opacity?: boolean
-    /** 右边位置，即 CSS right */
-    right?: boolean
-    /** 顶边位置，即 CSS top */
-    top?: boolean
-    /** 变换矩阵，即 CSS transform matrix */
-    matrix?: boolean
-    /** 三维变换矩阵，即 CSS transform matrix3d */
-    matrix3d?: boolean
-    /** 旋转，即 CSS transform rotate */
-    rotate?: boolean
-    /** 三维旋转，即 CSS transform rotate3d */
-    rotate3d?: boolean
-    /** X 方向旋转，即 CSS transform rotateX */
-    rotateX?: boolean
-    /** Y 方向旋转，即 CSS transform rotateY */
-    rotateY?: boolean
-    /** Z 方向旋转，即 CSS transform rotateZ */
-    rotateZ?: boolean
-    /** 缩放，即 CSS transform scale */
-    scale?: boolean
-    /** 三维缩放，即 CSS transform scale3d */
-    scale3d?: boolean
-    /** X 方向缩放，即 CSS transform scaleX */
-    scaleX?: boolean
-    /** Y 方向缩放，即 CSS transform scaleY */
-    scaleY?: boolean
-    /** Z 方向缩放，即 CSS transform scaleZ */
-    scaleZ?: boolean
-    /** 倾斜，即 CSS transform skew */
-    skew?: boolean
-    /** X 方向倾斜，即 CSS transform skewX */
-    skewX?: boolean
-    /** Y 方向倾斜，即 CSS transform skewY */
-    skewY?: boolean
-    /** 位移，即 CSS transform translate */
-    translate?: boolean
-    /** 三维位移，即 CSS transform translate3d */
-    translate3d?: boolean
-    /** X 方向位移，即 CSS transform translateX */
-    translateX?: boolean
-    /** Y 方向位移，即 CSS transform translateY */
-    translateY?: boolean
-    /** Z 方向位移，即 CSS transform translateZ */
-    translateZ?: boolean
-  }
-
-  /** @ignore */
-  interface ScrollTimelineKeyframe {
     composite?: 'replace' | 'add' | 'accumulate' | 'auto'
     easing?: string
-    offset?: number | null
-    [property: string]: string | number | null | undefined
+    [property: string]: any
   }
 
+  /** @ignore */
+  type ClearAnimationOptions = Record<keyof KeyFrame, boolean>
+
   /** @ignore */
   interface ScrollTimelineOption {
     /** 指定滚动元素的选择器（只支持 scroll-view），该元素滚动时会驱动动画的进度 */
@@ -474,7 +410,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 创建一个动画实例 [animation](../Animation)。调用实例的方法来描述动画。最后通过动画实例的 export 方法导出动画数据传递给组件的 animation 属性。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * var animation = Taro.createAnimation({

package/types/api/ui/interaction.d.ts

@@ -152,7 +152,7 @@ declare module '../../index' {
      * **注意**
      * - Taro.showLoading 和 Taro.showToast 同时只能显示一个
      * - Taro.showToast 应与 Taro.hideToast 配对使用
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.showToast({
@@ -169,7 +169,7 @@ declare module '../../index' {
      * **注意**
      * - Android 6.7.2 以下版本，点击取消或蒙层时，回调 fail, errMsg 为 "fail cancel"；
      * - Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗，所以尽量避免使用「取消」分支中实现业务逻辑
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.showModal({
@@ -193,7 +193,7 @@ declare module '../../index' {
      * **注意**
      * - Taro.showLoading 和 Taro.showToast 同时只能显示一个
      * - Taro.showLoading 应与 Taro.hideLoading 配对使用
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.showLoading({
@@ -212,7 +212,7 @@ declare module '../../index' {
      * **注意**
      * - Android 6.7.2 以下版本，点击取消或蒙层时，回调 fail, errMsg 为 "fail cancel"；
      * - Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗，所以尽量避免使用「取消」分支中实现业务逻辑
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.showActionSheet({
@@ -230,13 +230,13 @@ declare module '../../index' {
     showActionSheet(option: showActionSheet.Option): Promise<showActionSheet.SuccessCallbackResult>
 
     /** 隐藏消息提示框
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.hideToast.html
      */
     hideToast(option?: hideToast.Option): void
 
     /** 隐藏 loading 提示框
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.showLoading({

package/types/api/ui/menu.d.ts

@@ -21,7 +21,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 获取菜单按钮（右上角胶囊按钮）的布局位置信息。坐标信息以屏幕左上角为原点。
-     * @supported weapp
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/menu/wx.getMenuButtonBoundingClientRect.html
      */
     getMenuButtonBoundingClientRect(): getMenuButtonBoundingClientRect.Rect

package/types/api/ui/navigation-bar.d.ts

@@ -79,13 +79,13 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 在当前页面显示导航条加载动画
-     * @supported weapp, rn
+     * @supported weapp, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/navigation-bar/wx.showNavigationBarLoading.html
      */
     showNavigationBarLoading(option?: showNavigationBarLoading.Option): void
 
     /** 动态设置当前页面的标题
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.setNavigationBarTitle({
@@ -97,7 +97,7 @@ declare module '../../index' {
     setNavigationBarTitle(option: setNavigationBarTitle.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 设置页面导航条颜色
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @h5 不支持 animation 参数
      * @rn 不支持 animation 参数
      * @example
@@ -116,13 +116,13 @@ declare module '../../index' {
     setNavigationBarColor(option: setNavigationBarColor.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 在当前页面隐藏导航条加载动画
-     * @supported weapp, rn
+     * @supported weapp, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/navigation-bar/wx.hideNavigationBarLoading.html
      */
     hideNavigationBarLoading(option?: hideNavigationBarLoading.Option): void
 
     /** 隐藏返回首页按钮。微信7.0.7版本起，当用户打开的小程序最底层页面是非首页时，默认展示“返回首页”按钮，开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏。
-     * @supported weapp
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/navigation-bar/wx.hideHomeButton.html
      */
     hideHomeButton(option?: hideHomeButton.Option): Promise<TaroGeneral.CallbackResult>

package/types/api/ui/pull-down-refresh.d.ts

@@ -25,7 +25,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 停止当前页面下拉刷新。
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * onPullDownRefresh: function (){
@@ -37,7 +37,7 @@ declare module '../../index' {
     stopPullDownRefresh(option?: stopPullDownRefresh.Option): void
 
     /** 开始下拉刷新。调用后触发下拉刷新动画，效果与用户手动下拉刷新一致。
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @rn 无动画效果
      * @example
      * ```tsx

package/types/api/ui/scroll.d.ts

@@ -13,6 +13,8 @@ declare module '../../index' {
       scrollTop?: number
       /** 选择器, css selector */
       selector?: string
+      /** 偏移距离，需要和 selector 参数搭配使用，可以滚动到 selector 加偏移距离的位置，单位 px */
+      offsetTop?: number
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
     }
@@ -58,7 +60,7 @@ declare module '../../index' {
     scrollTo(object: ScrollViewContext.scrollTo.Option): void
 
     /** 滚动至指定位置
-     * @supported weapp
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/scroll/ScrollViewContext.scrollIntoView.html
      */
     scrollIntoView(
@@ -96,7 +98,7 @@ declare module '../../index' {
      *  - 后代选择器：.the-ancestor .the-descendant
      *  - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
      *  - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.pageScrollTo({

package/types/api/ui/tab-bar.d.ts

@@ -121,19 +121,19 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 显示 tabBar 某一项的右上角的红点
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.showTabBarRedDot.html
      */
     showTabBarRedDot(option: showTabBarRedDot.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 显示 tabBar
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.showTabBar.html
      */
     showTabBar(option?: showTabBar.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 动态设置 tabBar 的整体样式
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.setTabBarStyle({
@@ -148,7 +148,7 @@ declare module '../../index' {
     setTabBarStyle(option?: setTabBarStyle.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 动态设置 tabBar 某一项的内容，`2.7.0` 起图片支持临时文件和网络文件。
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.setTabBarItem({
@@ -163,7 +163,7 @@ declare module '../../index' {
     setTabBarItem(option: setTabBarItem.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 为 tabBar 某一项的右上角添加文本
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.setTabBarBadge({
@@ -176,19 +176,19 @@ declare module '../../index' {
     setTabBarBadge(option: setTabBarBadge.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 移除 tabBar 某一项右上角的文本
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.removeTabBarBadge.html
      */
     removeTabBarBadge(option: removeTabBarBadge.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 隐藏 tabBar 某一项的右上角的红点
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.hideTabBarRedDot.html
      */
     hideTabBarRedDot(option: hideTabBarRedDot.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 隐藏 tabBar
-     * @supported weapp, h5, rn
+     * @supported weapp, h5, rn, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/tab-bar/wx.hideTabBar.html
      */
     hideTabBar(option?: hideTabBar.Option): Promise<TaroGeneral.CallbackResult>