@tarojs/taro 3.5.0-canary.1 → 3.5.0

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,24 +13,92 @@ declare module '../../index' {
       scrollTop?: number
       /** 选择器, css selector */
       selector?: string
+      /** 偏移距离，需要和 selector 参数搭配使用，可以滚动到 selector 加偏移距离的位置，单位 px */
+      offsetTop?: number
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
 
+  /** 增强 ScrollView 实例，可通过 [Taro.createSelectorQuery](/docs/apis/wxml/createSelectorQuery) 的 [NodesRef.node](/docs/apis/wxml/NodesRef#node) 方法获取。 仅在 `scroll-view` 组件开启 `enhanced` 属性后生效。
+   * @supported weapp
+   * @example
+   * ```tsx
+   * Taro.createSelectorQuery()
+   *   .select('#scrollview')
+   *   .node()
+   *   .exec((res) => {
+   *     const scrollView = res[0].node;
+   *     scrollView.scrollEnabled = false;
+   *   })
+   * ```
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/scroll/ScrollViewContext.html
+   */
+  interface ScrollViewContext {
+    /** 滚动开关 */
+    scrollEnabled: boolean
+
+    /** 设置滚动边界弹性 (仅在 iOS 下生效) */
+    bounces: boolean
+
+    /** 设置是否显示滚动条 */
+    showScrollbar: boolean
+
+    /** 分页滑动开关 */
+    pagingEnabled: boolean
+
+    /** 设置滚动减速速率 */
+    fastDeceleration: boolean
+
+    /** 取消滚动惯性 (仅在 iOS 下生效) */
+    decelerationDisabled: boolean
+
+    /** 滚动至指定位置
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/scroll/ScrollViewContext.scrollTo.html
+     */
+    scrollTo(object: ScrollViewContext.scrollTo.Option): void
+
+    /** 滚动至指定位置
+     * @supported weapp, tt
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/scroll/ScrollViewContext.scrollIntoView.html
+     */
+    scrollIntoView(
+      /** 元素选择器 */
+      selector: string
+    ): void
+  }
+
+  namespace ScrollViewContext {
+    namespace scrollTo {
+      interface Option {
+        /** 顶部距离 */
+        top?: number
+        /** 左边界距离 */
+        left?: number
+        /** 初始速度 */
+        velocity?: number
+        /** 滚动动画时长 */
+        duration?: number
+        /** 是否启用滚动动画 */
+        animated?: boolean
+      }
+    }
+  }
+
   interface TaroStatic {
     /** 将页面滚动到目标位置，支持选择器和滚动距离两种方式定位
      *
      * **selector 语法**
      * selector类似于 CSS 的选择器，但仅支持下列语法。
      *
-     * + ID选择器：#the-id
-     * + class选择器（可以连续指定多个）：.a-class.another-class
-     * + 子元素选择器：.the-parent > .the-child
-     * + 后代选择器：.the-ancestor .the-descendant
-     * + 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
-     * + 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5
+     *  - ID选择器：#the-id
+     *  - class选择器（可以连续指定多个）：.a-class.another-class
+     *  - 子元素选择器：.the-parent > .the-child
+     *  - 后代选择器：.the-ancestor .the-descendant
+     *  - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
+     *  - 多选择器的并集：#a-node, .some-other-nodes
+     * @supported weapp, h5, rn, tt
      * @example
      * ```tsx
      * Taro.pageScrollTo({

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

@@ -5,12 +5,12 @@ declare module '../../index' {
     interface Option {
       /** 置顶栏文字 */
       text: string
-      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: TaroGeneral.CallbackResult) => void
-      /** 接口调用失败的回调函数 */
-      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
     }
   }
   interface TaroStatic {

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

@@ -121,19 +121,19 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 显示 tabBar 某一项的右上角的红点
-     * @supported weapp, h5
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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>

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

@@ -1,6 +1,20 @@
 import Taro from '../../index'
 
 declare module '../../index' {
+  namespace setWindowSize {
+    interface Option {
+      /** 窗口宽度，以像素为单位 */
+      width: string
+      /** 窗口高度，以像素为单位 */
+      height: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
   namespace onWindowResize {
     /** 窗口尺寸变化事件的回调函数 */
     type Callback = (result: CallbackResult) => void
@@ -23,8 +37,14 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
+    /** 设置窗口大小，该接口仅适用于 PC 平台，使用细则请参见指南
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/window/wx.setWindowSize.html
+     */
+    setWindowSize(option: setWindowSize.Option): Promise<TaroGeneral.CallbackResult>
+
     /** 监听窗口尺寸变化事件
-     * @supported weapp, h5
+     * @supported weapp, h5, rn
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/window/wx.onWindowResize.html
      */
     onWindowResize(
@@ -33,7 +53,7 @@ declare module '../../index' {
     ): void
 
     /** 取消监听窗口尺寸变化事件
-     * @supported weapp, h5
+     * @supported weapp, h5, rn
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/window/wx.offWindowResize.html
      */
     offWindowResize(

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

@@ -19,6 +19,14 @@ declare module '../../index' {
       /** 主线程/Worker 线程向当前线程发送的消息的事件的回调函数 */
       callback: Worker.OnMessageCallback,
     ): void
+    /** 监听 worker 线程被系统回收事件（当 iOS 系统资源紧张时，worker 线程存在被系统回收的可能，开发者可监听此事件并重新创建一个 worker）
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/worker/Worker.onProcessKilled.html
+     */
+    onProcessKilled(
+      /** worker 线程被系统回收事件的回调函数 */
+      callback: Worker.OnMessageCallback,
+    ): void
     /** 向主线程/Worker 线程发送的消息。
      * @supported weapp
      * @example
@@ -52,7 +60,7 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
-    /** 创建一个 Worker 线程。目前限制最多只能创建一个 Worker，创建下一个 Worker 前请先调用 [Worker.terminate](https://developers.weixin.qq.com/miniprogram/dev/api/worker/Worker.terminate.html)
+    /** 创建一个 Worker 线程。目前限制最多只能创建一个 Worker，创建下一个 Worker 前请先调用 [Worker.terminate](/docs/apis/worker/#terminate)
      * @supported weapp
      * @example
      * ```tsx

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

@@ -18,10 +18,12 @@ declare module '../../index' {
    */
   interface IntersectionObserver {
     /** 停止监听。回调函数将不再触发
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.disconnect.html
      */
     disconnect(): void
     /** 指定目标节点并开始监听相交状态变化情况
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.observe.html
      */
     observe(
@@ -31,6 +33,7 @@ declare module '../../index' {
       callback: IntersectionObserver.ObserveCallback,
     ): void
     /** 使用选择器指定一个节点，作为参照区域之一。
+     * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/IntersectionObserver.relativeTo.html
      */
     relativeTo(
@@ -40,6 +43,7 @@ declare module '../../index' {
       margins?: IntersectionObserver.RelativeToMargins,
     ): IntersectionObserver
     /** 指定页面显示区域作为参照区域之一
+     * @supported weapp, tt
      * @example
      * 下面的示例代码中，如果目标节点（用选择器 .target-class 指定）进入显示区域以下 100px 时，就会触发回调函数。
      *
@@ -175,115 +179,12 @@ declare module '../../index' {
     }) => void
   }
 
-  /** 查询节点信息的对象
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.html
-   */
-  interface SelectorQuery {
-    /** 执行所有的请求。请求结果按请求次序构成数组，在callback的第一个参数中返回。
-     * @supported weapp, h5
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.exec.html
-     */
-    exec(
-      /** 回调函数 */
-      callback?: (...args: any[]) => any,
-    ): NodesRef
-    /** 在当前页面下选择第一个匹配选择器 `selector` 的节点。返回一个 `NodesRef` 对象实例，可以用于获取节点信息。
-     *
-     * **selector 语法**
-     *
-     *
-     * selector类似于 CSS 的选择器，但仅支持下列语法。
-     *
-     * - ID选择器：#the-id
-     * - class选择器（可以连续指定多个）：.a-class.another-class
-     * - 子元素选择器：.the-parent > .the-child
-     * - 后代选择器：.the-ancestor .the-descendant
-     * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
-     * - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5
-     * @example
-     * ```tsx
-     * Taro.createSelectorQuery().select('#the-id').fields({
-     *   dataset: true,
-     *   size: true,
-     *   scrollOffset: true,
-     *   properties: ['scrollX', 'scrollY']
-     * }, function (res){
-     *   res.dataset    // 节点的dataset
-     *   res.width      // 节点的宽度
-     *   res.height     // 节点的高度
-     *   res.scrollLeft // 节点的水平滚动位置
-     *   res.scrollTop  // 节点的竖直滚动位置
-     *   res.scrollX    // 节点 scroll-x 属性的当前值
-     *   res.scrollY    // 节点 scroll-x 属性的当前值
-     * }).exec()
-     * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.select.html
-     */
-    select(
-      /** 选择器 */
-      selector: string,
-    ): NodesRef
-    /** 在当前页面下选择匹配选择器 selector 的所有节点。
-     *
-     * **selector 语法**
-     *
-     * selector类似于 CSS 的选择器，但仅支持下列语法。
-     *
-     * - ID选择器：#the-id
-     * - class选择器（可以连续指定多个）：.a-class.another-class
-     * - 子元素选择器：.the-parent > .the-child
-     * - 后代选择器：.the-ancestor .the-descendant
-     * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
-     * - 多选择器的并集：#a-node, .some-other-nodes
-     * @supported weapp, h5
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.selectAll.html
-     */
-    selectAll(
-      /** 选择器 */
-      selector: string,
-    ): NodesRef
-    /** 选择显示区域。可用于获取显示区域的尺寸、滚动位置等信息。
-     * @supported weapp, h5
-     * @example
-     * ```tsx
-     * Taro.createSelectorQuery().selectViewport().scrollOffset(function (res) {
-     *   res.id      // 节点的ID
-     *   res.dataset // 节点的dataset
-     *   res.scrollLeft // 节点的水平滚动位置
-     *   res.scrollTop  // 节点的竖直滚动位置
-     * }).exec()
-     * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.selectViewport.html
-     */
-    selectViewport(): NodesRef
-    /** 将选择器的选取范围更改为自定义组件 `component` 内。（初始时，选择器仅选取页面范围的节点，不会选取任何自定义组件中的节点）。
-     * @supported weapp, h5
-     * @example
-     * ```tsx
-     * Component({
-     *   queryMultipleNodes () {
-     *     const query = Taro.createSelectorQuery().in(this)
-     *     query.select('#the-id').boundingClientRect(function(res){
-     *       res.top // 这个组件内 #the-id 节点的上边界坐标
-     *     }).exec()
-     *   }
-     * })
-     * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.in.html
-     */
-    in(
-        /** 自定义组件实例 */
-        component: TaroGeneral.IAnyObject,
-    ): SelectorQuery
-  }
-
   /** 用于获取 `WXML` 节点信息的对象
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/NodesRef.html
    */
   interface NodesRef {
     /** 添加节点的布局位置的查询请求。相对于显示区域，以像素为单位。其功能类似于 DOM 的 `getBoundingClientRect`。返回 `NodesRef` 对应的 `SelectorQuery`。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').boundingClientRect(function(rect){
@@ -318,8 +219,8 @@ declare module '../../index' {
       /** 回调函数，在执行 `SelectorQuery.exec` 方法后，节点信息会在 `callback` 中返回。 */
       callback?: NodesRef.BoundingClientRectCallback,
     ): SelectorQuery
-    /** 添加节点的 Context 对象查询请求。目前支持 [VideoContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/VideoContext.html)、[CanvasContext](https://developers.weixin.qq.com/miniprogram/dev/api/canvas/CanvasContext.html)、[LivePlayerContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.html)、[EditorContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/editor/EditorContext.html)和 [MapContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/map/MapContext.html) 的获取。
-     * @supported weapp
+    /** 添加节点的 Context 对象查询请求。目前支持 [VideoContext](/docs/apis/media/video/VideoContext)、[CanvasContext](/docs/apis/canvas/CanvasContext)、[LivePlayerContext](/docs/apis/media/live/LivePlayerContext)、[EditorContext](/docs/apis/media/editor/EditorContext)和 [MapContext](/docs/apis/media/map/MapContext) 的获取。
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('.the-video-class').context(function (res) {
@@ -336,7 +237,7 @@ declare module '../../index' {
      *
      * **注意**
      * computedStyle 的优先级高于 size，当同时在 computedStyle 里指定了 width/height 和传入了 size: true，则优先返回 computedStyle 获取到的 width/height。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('#the-id').fields({
@@ -367,8 +268,8 @@ declare module '../../index' {
       /** 回调函数 */
       callback?: NodesRef.FieldsCallback,
     ): SelectorQuery
-    /** 获取 Node 节点实例。目前支持 [Canvas](https://developers.weixin.qq.com/miniprogram/dev/component/canvas.html) 的获取。
-     * @supported weapp
+    /** 获取 Node 节点实例。目前支持 [Canvas](/docs/components/canvas) 的获取。
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().select('.canvas').node(function(res){
@@ -382,7 +283,7 @@ declare module '../../index' {
       callback?: NodesRef.NodeCallback,
     ): SelectorQuery
     /** 添加节点的滚动位置查询请求。以像素为单位。节点必须是 `scroll-view` 或者 `viewport`，返回 `NodesRef` 对应的 `SelectorQuery`。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * Taro.createSelectorQuery().selectViewport().scrollOffset(function(res){
@@ -478,9 +379,112 @@ declare module '../../index' {
     }
   }
 
+  /** 查询节点信息的对象
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.html
+   */
+  interface SelectorQuery {
+    /** 执行所有的请求。请求结果按请求次序构成数组，在callback的第一个参数中返回。
+     * @supported weapp, h5, tt
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.exec.html
+     */
+    exec(
+      /** 回调函数 */
+      callback?: (...args: any[]) => any,
+    ): NodesRef
+    /** 将选择器的选取范围更改为自定义组件 `component` 内。（初始时，选择器仅选取页面范围的节点，不会选取任何自定义组件中的节点）。
+     * @supported weapp, h5, tt
+     * @example
+     * ```tsx
+     * Component({
+     *   queryMultipleNodes () {
+     *     const query = Taro.createSelectorQuery().in(this)
+     *     query.select('#the-id').boundingClientRect(function(res){
+     *       res.top // 这个组件内 #the-id 节点的上边界坐标
+     *     }).exec()
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.in.html
+     */
+    in(
+        /** 自定义组件实例 */
+        component: TaroGeneral.IAnyObject,
+    ): SelectorQuery
+    /** 在当前页面下选择第一个匹配选择器 `selector` 的节点。返回一个 `NodesRef` 对象实例，可以用于获取节点信息。
+     *
+     * **selector 语法**
+     *
+     *
+     * selector类似于 CSS 的选择器，但仅支持下列语法。
+     *
+     * - ID选择器：#the-id
+     * - class选择器（可以连续指定多个）：.a-class.another-class
+     * - 子元素选择器：.the-parent > .the-child
+     * - 后代选择器：.the-ancestor .the-descendant
+     * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
+     * - 多选择器的并集：#a-node, .some-other-nodes
+     * @supported weapp, h5, tt
+     * @example
+     * ```tsx
+     * Taro.createSelectorQuery().select('#the-id').fields({
+     *   dataset: true,
+     *   size: true,
+     *   scrollOffset: true,
+     *   properties: ['scrollX', 'scrollY']
+     * }, function (res){
+     *   res.dataset    // 节点的dataset
+     *   res.width      // 节点的宽度
+     *   res.height     // 节点的高度
+     *   res.scrollLeft // 节点的水平滚动位置
+     *   res.scrollTop  // 节点的竖直滚动位置
+     *   res.scrollX    // 节点 scroll-x 属性的当前值
+     *   res.scrollY    // 节点 scroll-x 属性的当前值
+     * }).exec()
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.select.html
+     */
+    select(
+      /** 选择器 */
+      selector: string,
+    ): NodesRef
+    /** 在当前页面下选择匹配选择器 selector 的所有节点。
+     *
+     * **selector 语法**
+     *
+     * selector类似于 CSS 的选择器，但仅支持下列语法。
+     *
+     * - ID选择器：#the-id
+     * - class选择器（可以连续指定多个）：.a-class.another-class
+     * - 子元素选择器：.the-parent > .the-child
+     * - 后代选择器：.the-ancestor .the-descendant
+     * - 跨自定义组件的后代选择器：.the-ancestor >>> .the-descendant
+     * - 多选择器的并集：#a-node, .some-other-nodes
+     * @supported weapp, h5, tt
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.selectAll.html
+     */
+    selectAll(
+      /** 选择器 */
+      selector: string,
+    ): NodesRef
+    /** 选择显示区域。可用于获取显示区域的尺寸、滚动位置等信息。
+     * @supported weapp, h5, tt
+     * @example
+     * ```tsx
+     * Taro.createSelectorQuery().selectViewport().scrollOffset(function (res) {
+     *   res.id      // 节点的ID
+     *   res.dataset // 节点的dataset
+     *   res.scrollLeft // 节点的水平滚动位置
+     *   res.scrollTop  // 节点的竖直滚动位置
+     * }).exec()
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/wxml/SelectorQuery.selectViewport.html
+     */
+    selectViewport(): NodesRef
+  }
+
   interface TaroStatic {
     /** 返回一个 SelectorQuery 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createSelectorQuery()` 来代替。
-     * @supported weapp, h5
+     * @supported weapp, h5, tt
      * @example
      * ```tsx
      * const query = Taro.createSelectorQuery()
@@ -496,7 +500,7 @@ declare module '../../index' {
     createSelectorQuery(): SelectorQuery
 
     /** 创建并返回一个 IntersectionObserver 对象实例。在自定义组件或包含自定义组件的页面中，应使用 `this.createIntersectionObserver([options])` 来代替。
-     * @supported weapp
+     * @supported weapp, tt
      * @example
      * ```tsx
      * const observer = Taro.createIntersectionObserver(this, { thresholds: [0], observeAll: true })