@tarojs/components 3.5.5 → 3.5.6

package/types/Swiper.d.ts

@@ -1,34 +1,33 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction } from './common'
-
 interface SwiperProps extends StandardProps {
   /** 是否显示面板指示点
    * @default false
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   indicatorDots?: boolean
 
   /** 指示点颜色
    * @default "rgba(0, 0, 0, .3)"
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   indicatorColor?: string
 
   /** 当前选中的指示点颜色
    * @default "#000000"
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   indicatorActiveColor?: string
 
   /** 是否自动切换
    * @default false
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   autoplay?: boolean
 
   /** 当前所在滑块的 index
    * @default 0
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   current?: number
 
@@ -39,77 +38,77 @@ interface SwiperProps extends StandardProps {
 
   /** 自动切换时间间隔
    * @default 5000
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   interval?: number
 
   /** 滑动动画时长
    * @default 500
-   * @supported weapp, swan, alipay, tt, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   duration?: number
 
   /** 是否采用衔接滑动
    * @default false
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   circular?: boolean
 
   /** 滑动方向是否为纵向
    * @default false
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   vertical?: boolean
 
   /** 前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值
    * @default "0px"
-   * @supported weapp, h5, tt
+   * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   previousMargin?: string
 
   /** 后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值
    * @default "0px"
-   * @supported weapp, h5, tt
+   * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   nextMargin?: string
 
   /**
    * 当 swiper-item 的个数大于等于 2，关闭 circular 并且开启 previous-margin 或 next-margin 的时候，可以指定这个边距是否应用到第一个、最后一个元素
    * @default false
-   * @supported weapp
+   * @supported weapp, alipay, jd
    */
   snapToEdge?: boolean
 
   /** 同时显示的滑块数量
    * @default 1
-   * @supported weapp, swan, tt, h5
+   * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   displayMultipleItems?: number
 
   /** 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
    * @default false
-   * @supported weapp, swan
+   * @supported qq, jd
    */
   skipHiddenItemLayout?: boolean
 
   /** 指定 swiper 切换缓动动画类型
    * @default "default"
-   * @supported weapp, tt
+   * @supported weapp, alipay, tt, jd
    */
   easingFunction?: keyof SwiperProps.TEasingFunction
 
   /** current 改变时会触发 change 事件
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   onChange?: CommonEventFunction<SwiperProps.onChangeEventDetail>
 
   /** swiper-item 的位置发生改变时会触发 transition 事件
-   * @supported weapp, tt
+   * @supported weapp, alipay, tt, qq, jd
    */
   onTransition?: CommonEventFunction<SwiperProps.onTransitionEventDetail>
 
   /** 动画结束时会触发 animationfinish 事件
-   * @supported weapp, swan, h5, rn, tt
+   * @supported weapp, swan, tt, qq, jd, h5, rn
    */
   onAnimationFinish?: SwiperProps['onChange']
 
@@ -118,15 +117,83 @@ interface SwiperProps extends StandardProps {
    * @supported alipay
    */
   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
+
+  /** 是否停止响应用户 touchmove 操作
+   * @default false
+   * @supported swan
+   */
+  disableTouchmove?: string
+}
 declare namespace SwiperProps {
   /** 导致变更的原因 */
   interface TChangeSource {
     /** 自动播放 */
     autoplay
+
     /** 用户划动 */
     touch
+
     /** 其它原因 */
     ''
   }
@@ -135,28 +202,40 @@ declare namespace SwiperProps {
   interface TEasingFunction {
     /** 默认缓动函数 */
     default
+
     /** 线性动画 */
     linear
+
     /** 缓入动画 */
     easeInCubic
+
     /** 缓出动画 */
     easeOutCubic
+
     /** 缓入缓出动画 */
     easeInOutCubic
   }
+  interface onCommonEventDetail {
+    /** 当前所在滑块的索引 */
+    current: number
 
+    /** 导致变更的原因 */
+    source: keyof SwiperProps.TChangeSource
+  }
   interface onChangeEventDetail {
     /** 当前所在滑块的索引 */
     current: number
+
     /** 导致变更的原因 */
     source: keyof SwiperProps.TChangeSource
+
     /** SwiperItem的itemId参数值 */
     currentItemId?: string
   }
-
   interface onTransitionEventDetail {
     /** X 坐标 */
     dx: number
+
     /** Y 坐标 */
     dy: number
   }
@@ -220,5 +299,4 @@ declare namespace SwiperProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/swiper.html
  */
 declare const Swiper: ComponentType<SwiperProps>
-
 export { Swiper, SwiperProps }

package/types/SwiperItem.d.ts

@@ -1,11 +1,15 @@
 import { ComponentType } from 'react'
 import { StandardProps } from './common'
-
 interface SwiperItemProps extends StandardProps {
   /** 该 swiper-item 的标识符
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, swan, tt, jd, h5, rn
    */
   itemId?: string
+
+  /** 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
+   * @supported weapp
+   */
+  skipHiddenItemLayout?: string
 }
 
 /** 仅可放置在 swiper 组件中，宽高自动设置为100%
@@ -66,5 +70,4 @@ interface SwiperItemProps extends StandardProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/swiper-item.html
  */
 declare const SwiperItem: ComponentType<SwiperItemProps>
-
 export { SwiperItem, SwiperItemProps }

package/types/Switch.d.ts

@@ -1,33 +1,32 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
-
 interface SwitchProps extends StandardProps, FormItemProps {
   /** 是否选中
    * @default false
-   * @supported weapp, h5, rn, swan, alipay, tt
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   checked?: boolean
 
   /** 是否禁用
    * @default false
-   * @supported weapp, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, rn
    */
   disabled?: boolean
 
   /** 样式，有效值：switch, checkbox
    * @default "switch"
-   * @supported weapp, h5, rn, swan, alipay, tt
+   * @supported weapp, swan, tt, qq, jd, h5, rn
    */
   type?: 'switch' | 'checkbox'
 
   /** switch 的颜色，同 css 的 color
    * @default "#04BE02"
-   * @supported weapp, h5, rn, swan, alipay, tt
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   color?: string
 
   /** checked 改变时触发 change 事件
-   * @supported weapp, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   onChange?: CommonEventFunction<SwitchProps.onChangeEventDetail>
 
@@ -35,8 +34,24 @@ interface SwitchProps extends StandardProps, FormItemProps {
    * @supported h5
    */
   nativeProps?: Record<string, unknown>
-}
 
+  /** 组件名字，用于表单提交获取数据。
+   * @supported alipay
+   */
+  name?: string
+
+  /** 是否为受控组件，为 true 时，checked 会完全受 setData 控制。
+   * 版本要求： 基础库 1.8.0 及以上
+   * @default false
+   * @supported alipay
+   */
+  controlled?: string
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+}
 declare namespace SwitchProps {
   interface onChangeEventDetail {
     value: boolean
@@ -83,5 +98,4 @@ declare namespace SwitchProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/switch.html
  */
 declare const Switch: ComponentType<SwitchProps>
-
 export { Switch, SwitchProps }

package/types/Text.d.ts

@@ -1,10 +1,9 @@
 import { ComponentType } from 'react'
 import { StandardProps } from './common'
-
 interface TextProps extends StandardProps {
   /** 文本是否可选
    * @default false
-   * @supported weapp, swan, alipay, tt, h5, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   selectable?: boolean
 
@@ -15,24 +14,30 @@ interface TextProps extends StandardProps {
   userSelect?: boolean
 
   /** 显示连续空格
-   * @supported weapp, swan, tt
+   * @supported weapp, alipay, swan, tt, qq, jd
    */
   space?: keyof TextProps.TSpace
 
   /** 是否解码
    * @default false
-   * @supported weapp, tt
+   * @supported weapp, alipay, tt, qq, jd
    */
   decode?: boolean
-}
 
+  /** 多行省略，值须大于等于 1，表现同 css 的 -webkit-line-clamp 属性一致。
+   * @supported alipay
+   */
+  numberOfLines?: string
+}
 declare namespace TextProps {
   /** space 的合法值 */
   interface TSpace {
     /** 中文字符空格一半大小 */
     ensp
+
     /** 中文字符空格大小 */
     emsp
+
     /** 根据字体设置的空格大小 */
     nbsp
   }
@@ -124,5 +129,4 @@ declare namespace TextProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/text.html
  */
 declare const Text: ComponentType<TextProps>
-
 export { Text, TextProps }

package/types/Textarea.d.ts

@@ -1,97 +1,96 @@
 import { ComponentType } from 'react'
 import { StandardProps, CommonEventFunction, FormItemProps } from './common'
-
 interface TextareaProps extends StandardProps, FormItemProps {
   /** 输入框的内容
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   value?: string
 
   /** 输入框为空时占位符
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   placeholder?: string
 
   /** 指定 placeholder 的样式
-   * @supported weapp, tt
+   * @supported weapp, alipay, swan, tt, qq
    */
   placeholderStyle?: string
 
   /** 指定 placeholder 的样式类
    * @default "textarea-placeholder"
-   * @supported weapp, tt
+   * @supported weapp, alipay, swan, tt, qq
    */
   placeholderClass?: string
 
   /** 是否禁用
    * @default false
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   disabled?: boolean
 
   /** 最大输入长度，设置为 -1 的时候不限制最大长度
    * @default 140
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   maxlength?: number
 
   /** 自动聚焦，拉起键盘
    * @default false
-   * @supported weapp, h5
+   * @supported weapp, swan, qq, h5
    */
   autoFocus?: boolean
 
   /** 获取焦点
    * @default false
-   * @supported weapp, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, rn
    */
   focus?: boolean
 
   /** 是否自动增高，设置 autoHeight 时，style.height不生效
    * @default false
-   * @supported weapp, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, rn
    */
   autoHeight?: boolean
 
   /** 如果 Textarea 是在一个 `position:fixed` 的区域，需要显示指定属性 fixed 为 true
    * @default false
-   * @supported weapp
+   * @supported weapp, swan, qq
    */
   fixed?: boolean
 
   /** 指定光标与键盘的距离，单位 px 。取 Textarea 距离底部的距离和 cursorSpacing 指定的距离的最小值作为光标与键盘的距离
    * @default 0
-   * @supported weapp, tt
+   * @supported weapp, swan, tt, qq
    */
   cursorSpacing?: number
 
   /** 指定 focus 时的光标位置
    * @default -1
-   * @supported weapp, tt
+   * @supported weapp, swan, tt, qq
    */
   cursor?: number
 
   /** 是否显示键盘上方带有”完成“按钮那一栏
    * @default true
-   * @supported weapp, tt
+   * @supported weapp, swan, tt, qq
    */
   showConfirmBar?: boolean
 
   /** 光标起始位置，自动聚集时有效，需与 selectionEnd 搭配使用
    * @default -1
-   * @supported weapp, rn, tt
+   * @supported weapp, swan, tt, qq, rn
    */
   selectionStart?: number
 
   /** 光标结束位置，自动聚集时有效，需与 selectionStart 搭配使用
    * @default -1
-   * @supported weapp, rn, tt
+   * @supported weapp, swan, tt, qq, rn
    */
   selectionEnd?: number
 
   /** 键盘弹起时，是否自动上推页面
    * @default true
-   * @supported weapp, tt
+   * @supported weapp, swan, tt, qq
    */
   adjustPosition?: boolean
 
@@ -108,29 +107,29 @@ interface TextareaProps extends StandardProps, FormItemProps {
   disableDefaultPadding?: boolean
 
   /** 输入框聚焦时触发
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   onFocus?: CommonEventFunction<TextareaProps.onFocusEventDetail>
 
   /** 输入框失去焦点时触发
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   onBlur?: CommonEventFunction<TextareaProps.onBlurEventDetail>
 
-  /** 输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0}
-   * @supported weapp, rn, tt
+  /** 输入框行数变化时调用
+   * @supported weapp, swan, tt, qq, rn
    */
   onLineChange?: CommonEventFunction<TextareaProps.onLineChangeEventDetail>
 
-  /** 当键盘输入时，触发 input 事件，event.detail = {value, cursor, keyCode}
+  /** 当键盘输入时，触发 input 事件
    *
    * **onInput 处理函数的返回值并不会反映到 textarea 上**
-   * @supported weapp, h5, rn, tt
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   onInput?: CommonEventFunction<TextareaProps.onInputEventDetail>
 
-  /** 点击完成时， 触发 confirm 事件，event.detail = {value: value}
-   * @supported weapp, rn, tt
+  /** 点击完成时， 触发 confirm 事件
+   * @supported weapp, alipay, swan, tt, qq, rn
    */
   onConfirm?: CommonEventFunction<TextareaProps.onConfirmEventDetail>
 
@@ -143,18 +142,51 @@ interface TextareaProps extends StandardProps, FormItemProps {
    * @supported h5
    */
   nativeProps?: Record<string, unknown>
-}
 
+  /** 设置键盘右下角按钮的文字
+   * @supported weapp, alipay, swan, tt
+   */
+  confirmType?: 'send' | 'search' | 'next' | 'go' | 'done' | 'return'
+
+  /** 点击键盘右下角按钮时是否保持键盘不收起
+   * @supported weapp, swan, tt
+   */
+  confirmHold?: string
+
+  /** 组件名字，用于表单提交获取数据。
+   * @supported alipay
+   */
+  name?: string
+
+  /** 是否渲染字数统计功能（是否删除默认计数器/是否显示字数统计）。
+   * 版本要求： 基础库 1.8.0 及以上
+   * @supported alipay
+   */
+  showCount?: string
+
+  /** 是否为受控组件。为 true 时，value 内容会完全受 setData 控制。
+   * 版本要求： 基础库 1.8.0 及以上
+   * @supported alipay
+   */
+  controlled?: string
+
+  /** 无障碍访问，（属性）元素的额外描述
+   * @supported qq
+   */
+  ariaLabel?: string
+}
 declare namespace TextareaProps {
   interface onFocusEventDetail {
     /** 输入值 */
     value: string
+
     /** 键盘高度 */
     height: number
   }
   interface onBlurEventDetail {
     /** 输入值 */
     value: string
+
     /** 光标位置 */
     cursor: number
   }
@@ -166,8 +198,10 @@ declare namespace TextareaProps {
   interface onInputEventDetail {
     /** 输入值 */
     value: string
+
     /** 光标位置 */
     cursor: number
+
     /** 键值 */
     keyCode: number
   }
@@ -178,6 +212,7 @@ declare namespace TextareaProps {
   interface onKeyboardHeightChangeEventDetail {
     /** 键盘高度 */
     height: number
+
     /** 持续时间 */
     duration: number
   }
@@ -219,6 +254,4 @@ declare namespace TextareaProps {
  * @see https://developers.weixin.qq.com/miniprogram/dev/component/textarea.html
  */
 declare const Textarea: ComponentType<TextareaProps>
-
 export { Textarea, TextareaProps }
-