@tarojs/components 3.5.6 → 3.5.7-alpha.1

package/types/RadioGroup.d.ts

@@ -1,15 +1,15 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
 interface RadioGroupProps extends StandardProps, FormItemProps {
-  /** RadioGroup 中选中项发生改变时触发 change 事件，detail = {value:[选中的radio的value的数组]}
-   * @supported weapp, alipay, swan, tt, qq, h5
-   */
-  onChange?: CommonEventFunction
-
   /** 组件名字，用于表单提交获取数据。
    * @supported alipay, tt
    */
   name?: string
+
+  /** RadioGroup 中选中项发生改变时触发 change 事件，detail = {value:[选中的radio的value的数组]}
+   * @supported weapp, alipay, swan, tt, qq, h5
+   */
+  onChange?: CommonEventFunction
 }
 declare namespace RadioGroupProps {
   interface onChangeEventDetail {

package/types/RichText.d.ts

@@ -15,6 +15,23 @@ interface RichTextProps extends StandardProps {
    */
   space?: keyof RichTextProps.TSpace
 
+  /** 富文本是否可以长按选中，可用于复制，粘贴，长按搜索等场景
+   * @default false（基础库 3.150.1 以前版本）true（基础库 3.150.1 及以后版本）
+   * @supported swan
+   */
+  selectable?: string
+
+  /** 阻止长按图片时弹起默认菜单（将该属性设置为image-menu-prevent或image-menu-prevent="true"），只在初始化时有效，不能动态变更；若不想阻止弹起默认菜单，则不需要设置此属性
+   * @default false
+   * @supported swan
+   */
+  imageMenuPrevent?: string
+
+  /** 富文本中的图片是否可点击预览。在不设置的情况下，若 rich-text 未监听点击事件，则默认开启。未显示设置 preview 时会进行点击默认预览判断，建议显示设置 preview
+   * @supported swan
+   */
+  preview?: string
+
   /** 触摸。
    * @supported alipay
    */
@@ -44,23 +61,6 @@ interface RichTextProps extends StandardProps {
    * @supported alipay
    */
   onLongtap?: CommonEventFunction
-
-  /** 富文本是否可以长按选中，可用于复制，粘贴，长按搜索等场景
-   * @default false（基础库 3.150.1 以前版本）true（基础库 3.150.1 及以后版本）
-   * @supported swan
-   */
-  selectable?: string
-
-  /** 阻止长按图片时弹起默认菜单（将该属性设置为image-menu-prevent或image-menu-prevent="true"），只在初始化时有效，不能动态变更；若不想阻止弹起默认菜单，则不需要设置此属性
-   * @default false
-   * @supported swan
-   */
-  imageMenuPrevent?: string
-
-  /** 富文本中的图片是否可点击预览。在不设置的情况下，若 rich-text 未监听点击事件，则默认开启。未显示设置 preview 时会进行点击默认预览判断，建议显示设置 preview
-   * @supported swan
-   */
-  preview?: string
 }
 
 /** 节点类型

package/types/ScrollView.d.ts

@@ -126,6 +126,38 @@ interface ScrollViewProps extends StandardProps {
    */
   fastDeceleration?: boolean
 
+  /** 当 scroll-with-animation设置为 true 时，可以设置 scroll-animation-duration 来控制动画的执行时间，单位 ms。
+   * @supported alipay
+   */
+  scrollAnimationDuration?: string
+
+  /** 纵向滚动时，当滚动到顶部或底部时，强制禁止触发页面滚动，仍然只触发 scroll-view 自身的滚动。
+   * @supported alipay
+   * @default false
+   */
+  trapScroll?: string
+
+  /** 发生滚动前，对滚动方向进行判断，当方向是顶部/左边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到顶部/左边，禁止滚动。
+   * @supported alipay
+   */
+  disableLowerScroll?: string
+
+  /** 发生滚动前，对滚动方向进行判断，当方向是底部/右边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到底部/右边，禁止滚动。
+   * @supported alipay
+   */
+  disableUpperScroll?: string
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+
+  /** 开启 passive 特性，能优化一定的滚动性能
+   * @supported weapp
+   * @default false
+   */
+  enablePassive?: string
+
   /** 滚动到顶部/左边，会触发 scrolltoupper 事件
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
@@ -164,81 +196,37 @@ interface ScrollViewProps extends StandardProps {
   /** 滑动开始事件 (同时开启 enhanced 属性后生效)
    * @supported weapp
    */
-  onDragStart?: CommonEventFunction
+  onDragStart?: CommonEventFunction<ScrollViewProps.onDragDetail>
 
   /** 滑动事件 (同时开启 enhanced 属性后生效)
    * @supported weapp
    */
-  onDragging?: CommonEventFunction
+  onDragging?: CommonEventFunction<ScrollViewProps.onDragDetail>
 
-  /** 滑动结束事件 (同时开启 enhanced 属性后生效) detail { scrollTop, scrollLeft, velocity }
+  /** 滑动结束事件 (同时开启 enhanced 属性后生效)
    * @supported weapp
    */
-  onDragend?: CommonEventFunction
-
-  /** 外部样式名。
-   * @supported alipay
-   */
-  class?: string
-
-  /** 内联样式名。
-   * @supported alipay
-   */
-  style?: string
-
-  /** 当 scroll-with-animation设置为 true 时，可以设置 scroll-animation-duration 来控制动画的执行时间，单位 ms。
-   * 版本要求： 基础库 1.9.0 及以上
-   * @supported alipay
-   */
-  scrollAnimationDuration?: string
-
-  /** 纵向滚动时，当滚动到顶部或底部时，强制禁止触发页面滚动，仍然只触发 scroll-view 自身的滚动。
-   * 默认值： false
-   * 版本要求： 基础库 1.11.2 及以上
-   * @supported alipay
-   */
-  trapScroll?: string
+  onDragEnd?: CommonEventFunction<ScrollViewProps.onDragDetail>
 
   /** 触摸动作开始。
-   * 版本要求： 基础库 1.15.0 及以上
    * @supported alipay
    */
   onTouchStart?: CommonEventFunction
 
   /** 触摸后移动。
-   * 版本要求： 基础库 1.15.0 及以上
    * @supported alipay
    */
   onTouchMove?: CommonEventFunction
 
   /** 触摸动作结束。
-   * 版本要求： 基础库 1.15.0 及以上
    * @supported alipay
    */
   onTouchEnd?: CommonEventFunction
 
   /** 触摸动作被打断，如来电提醒、弹窗。
-   * 版本要求： 基础库 1.15.0 及以上
    * @supported alipay
    */
   onTouchCancel?: CommonEventFunction
-
-  /** 发生滚动前，对滚动方向进行判断，当方向是顶部/左边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到顶部/左边，禁止滚动。
-   * 版本要求：基础库 2.6.2 及以上
-   * @supported alipay
-   */
-  disableLowerScroll?: string
-
-  /** 发生滚动前，对滚动方向进行判断，当方向是底部/右边时，如果值为 always 将始终禁止滚动，如果值为 out-of-bounds 且当前已经滚动到底部/右边，禁止滚动。
-   * 版本要求：基础库 2.6.2 及以上
-   * @supported alipay
-   */
-  disableUpperScroll?: string
-
-  /** 无障碍访问，（属性）元素的额外描述
-   * @supported qq
-   */
-  ariaLabel?: string
 }
 declare namespace ScrollViewProps {
   interface onScrollDetail {
@@ -256,6 +244,16 @@ declare namespace ScrollViewProps {
     deltaX: number
     deltaY: number
   }
+  interface onDragDetail {
+    /** 横向滚动条位置 */
+    scrollLeft: number
+
+    /** 竖向滚动条位置 */
+    scrollTop: number
+
+    /** 滚动速度 */
+    velocity: number
+  }
 }
 
 /** 可滚动视图区域。使用竖向滚动时，需要给scroll-view一个固定高度，通过 WXSS 设置 height。组件属性的长度单位默认为 px

package/types/Slider.d.ts

@@ -73,16 +73,6 @@ interface SliderProps extends StandardProps, FormItemProps {
    */
   showValue?: boolean
 
-  /** 完成一次拖动后触发的事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onChange?: CommonEventFunction<SliderProps.onChangeEventDetail>
-
-  /** 拖动过程中触发的事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onChanging?: CommonEventFunction<SliderProps.onChangeEventDetail>
-
   /** 组件名字，用于表单提交获取数据。
    * @supported alipay
    */
@@ -109,6 +99,16 @@ interface SliderProps extends StandardProps, FormItemProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 完成一次拖动后触发的事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onChange?: CommonEventFunction<SliderProps.onChangeEventDetail>
+
+  /** 拖动过程中触发的事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onChanging?: CommonEventFunction<SliderProps.onChangeEventDetail>
 }
 declare namespace SliderProps {
   interface onChangeEventDetail {

package/types/Swiper.d.ts

@@ -97,21 +97,6 @@ interface SwiperProps extends StandardProps {
    */
   easingFunction?: keyof SwiperProps.TEasingFunction
 
-  /** current 改变时会触发 change 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
-   */
-  onChange?: CommonEventFunction<SwiperProps.onChangeEventDetail>
-
-  /** swiper-item 的位置发生改变时会触发 transition 事件
-   * @supported weapp, alipay, tt, qq, jd
-   */
-  onTransition?: CommonEventFunction<SwiperProps.onTransitionEventDetail>
-
-  /** 动画结束时会触发 animationfinish 事件
-   * @supported weapp, swan, tt, qq, jd, h5, rn
-   */
-  onAnimationFinish?: SwiperProps['onChange']
-
   /** 是否禁止用户 touch 操作
    * @default false
    * @supported alipay
@@ -119,62 +104,48 @@ interface SwiperProps extends StandardProps {
   disableTouch?: boolean
 
   /** swiper-item 可见时的 class。
-   * 版本要求： 基础库 1.13.7 以及上。
    * @supported alipay
    */
   activeClass?: string
 
   /** acceleration 设置为 {{true}} 时且处于滑动过程中，中间若干屏处于可见时的 class。
-   * 版本要求： 基础库 1.13.7 以及上。
    * @supported alipay
    */
   changingClass?: string
 
   /** 当开启时，会根据滑动速度，连续滑动多屏。
-   * 版本要求： 基础库 1.13.7 及以上
    * @default false
    * @supported alipay
    */
   acceleration?: string
 
   /** 是否禁用代码变动触发 swiper 切换时使用动画。
-   * 版本要求： 基础库 1.13.7 及以上
    * @default false
    * @supported alipay
    */
   disableProgrammaticAnimation?: string
 
-  /** 动画结束时会触发 animationEnd 事件
-   * @supported alipay
-   */
-  onAnimationEnd?: CommonEventFunction<SwiperProps.onCommonEventDetail>
-
   /** 滑动距离阈值，当滑动距离超过阈值时进行 swiper-item 切换。
-   * 版本要求：基础库 1.24.11 及以上
    * @supported alipay
    */
   swipeRatio?: string
 
   /** 滑动综合速度阈值，当超过阈值时进行 swiper-item 切换，数值越小越敏感。
-   * 版本要求：基础库 1.24.11 及以上
    * @supported alipay
    */
   swipeSpeed?: string
 
   /** 计算用户手势时所依赖的滑动角度。角度根据 touchstart 事件和首次 touchmove 事件的坐标计算得出。数值越小越对用户的滑动方向准确度要求越高。
-   * 版本要求：基础库 1.24.11 及以上
    * @supported alipay
    */
   touchAngle?: string
 
   /** 自动以指定滑块的高度为整个容器的高度。当 vertical 为 true 时，默认不调整。可选值为：
-   * 版本要求：基础库 2.6.4 及以上
    * @supported alipay
    */
   adjustHeight?: 'first' | 'current' | 'highest' | 'none'
 
   /** vertical 为 true 时强制使 adjust-height 生效。
-   * 版本要求：基础库 2.6.4 及以上
    * @supported alipay
    */
   adjustVerticalHeight?: string
@@ -184,6 +155,26 @@ interface SwiperProps extends StandardProps {
    * @supported swan
    */
   disableTouchmove?: string
+
+  /** current 改变时会触发 change 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
+   */
+  onChange?: CommonEventFunction<SwiperProps.onChangeEventDetail>
+
+  /** swiper-item 的位置发生改变时会触发 transition 事件
+   * @supported weapp, alipay, tt, qq, jd
+   */
+  onTransition?: CommonEventFunction<SwiperProps.onTransitionEventDetail>
+
+  /** 动画结束时会触发 animationfinish 事件
+   * @supported weapp, swan, tt, qq, jd, h5, rn
+   */
+  onAnimationFinish?: SwiperProps['onChange']
+
+  /** 动画结束时会触发 animationEnd 事件
+   * @supported alipay
+   */
+  onAnimationEnd?: CommonEventFunction<SwiperProps.onCommonEventDetail>
 }
 declare namespace SwiperProps {
   /** 导致变更的原因 */

package/types/Switch.d.ts

@@ -25,11 +25,6 @@ interface SwitchProps extends StandardProps, FormItemProps {
    */
   color?: string
 
-  /** checked 改变时触发 change 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, rn
-   */
-  onChange?: CommonEventFunction<SwitchProps.onChangeEventDetail>
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
@@ -41,7 +36,6 @@ interface SwitchProps extends StandardProps, FormItemProps {
   name?: string
 
   /** 是否为受控组件，为 true 时，checked 会完全受 setData 控制。
-   * 版本要求： 基础库 1.8.0 及以上
    * @default false
    * @supported alipay
    */
@@ -51,6 +45,11 @@ interface SwitchProps extends StandardProps, FormItemProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** checked 改变时触发 change 事件
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
+   */
+  onChange?: CommonEventFunction<SwitchProps.onChangeEventDetail>
 }
 declare namespace SwitchProps {
   interface onChangeEventDetail {

package/types/Textarea.d.ts

@@ -106,38 +106,6 @@ interface TextareaProps extends StandardProps, FormItemProps {
    */
   disableDefaultPadding?: boolean
 
-  /** 输入框聚焦时触发
-   * @supported weapp, alipay, swan, tt, qq, h5, rn
-   */
-  onFocus?: CommonEventFunction<TextareaProps.onFocusEventDetail>
-
-  /** 输入框失去焦点时触发
-   * @supported weapp, alipay, swan, tt, qq, h5, rn
-   */
-  onBlur?: CommonEventFunction<TextareaProps.onBlurEventDetail>
-
-  /** 输入框行数变化时调用
-   * @supported weapp, swan, tt, qq, rn
-   */
-  onLineChange?: CommonEventFunction<TextareaProps.onLineChangeEventDetail>
-
-  /** 当键盘输入时，触发 input 事件
-   *
-   * **onInput 处理函数的返回值并不会反映到 textarea 上**
-   * @supported weapp, alipay, swan, tt, qq, h5, rn
-   */
-  onInput?: CommonEventFunction<TextareaProps.onInputEventDetail>
-
-  /** 点击完成时， 触发 confirm 事件
-   * @supported weapp, alipay, swan, tt, qq, rn
-   */
-  onConfirm?: CommonEventFunction<TextareaProps.onConfirmEventDetail>
-
-  /** 键盘高度发生变化的时候触发此事件
-   * @supported weapp
-   */
-  onKeyboardHeightChange?: CommonEventFunction<TextareaProps.onKeyboardHeightChangeEventDetail>
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
@@ -159,13 +127,11 @@ interface TextareaProps extends StandardProps, FormItemProps {
   name?: string
 
   /** 是否渲染字数统计功能（是否删除默认计数器/是否显示字数统计）。
-   * 版本要求： 基础库 1.8.0 及以上
    * @supported alipay
    */
   showCount?: string
 
   /** 是否为受控组件。为 true 时，value 内容会完全受 setData 控制。
-   * 版本要求： 基础库 1.8.0 及以上
    * @supported alipay
    */
   controlled?: string
@@ -174,6 +140,38 @@ interface TextareaProps extends StandardProps, FormItemProps {
    * @supported qq
    */
   ariaLabel?: string
+
+  /** 输入框聚焦时触发
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
+   */
+  onFocus?: CommonEventFunction<TextareaProps.onFocusEventDetail>
+
+  /** 输入框失去焦点时触发
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
+   */
+  onBlur?: CommonEventFunction<TextareaProps.onBlurEventDetail>
+
+  /** 输入框行数变化时调用
+   * @supported weapp, swan, tt, qq, rn
+   */
+  onLineChange?: CommonEventFunction<TextareaProps.onLineChangeEventDetail>
+
+  /** 当键盘输入时，触发 input 事件
+   *
+   * **onInput 处理函数的返回值并不会反映到 textarea 上**
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
+   */
+  onInput?: CommonEventFunction<TextareaProps.onInputEventDetail>
+
+  /** 点击完成时， 触发 confirm 事件
+   * @supported weapp, alipay, swan, tt, qq, rn
+   */
+  onConfirm?: CommonEventFunction<TextareaProps.onConfirmEventDetail>
+
+  /** 键盘高度发生变化的时候触发此事件
+   * @supported weapp
+   */
+  onKeyboardHeightChange?: CommonEventFunction<TextareaProps.onKeyboardHeightChangeEventDetail>
 }
 declare namespace TextareaProps {
   interface onFocusEventDetail {