@tarojs/components 3.6.2-canary.1 → 3.6.2-canary.2

package/types/Swiper.d.ts

@@ -6,183 +6,151 @@ interface SwiperProps extends StandardProps {
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   indicatorDots?: boolean
-
   /** 指示点颜色
    * @default "rgba(0, 0, 0, .3)"
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   indicatorColor?: string
-
   /** 当前选中的指示点颜色
    * @default "#000000"
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   indicatorActiveColor?: string
-
   /** 是否自动切换
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   autoplay?: boolean
-
   /** 当前所在滑块的 index
    * @default 0
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   current?: number
-
   /** 当前所在滑块的 item-id ，不能与 current 被同时指定
    * @default ""
    */
   currentItemId?: string
-
   /** 自动切换时间间隔
    * @default 5000
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   interval?: number
-
   /** 滑动动画时长
    * @default 500
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   duration?: number
-
   /** 是否采用衔接滑动
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   circular?: boolean
-
   /** 滑动方向是否为纵向
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   vertical?: boolean
-
   /** 前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值
    * @default "0px"
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   previousMargin?: string
-
   /** 后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值
    * @default "0px"
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   nextMargin?: string
-
   /**
    * 当 swiper-item 的个数大于等于 2，关闭 circular 并且开启 previous-margin 或 next-margin 的时候，可以指定这个边距是否应用到第一个、最后一个元素
    * @default false
    * @supported weapp, alipay
    */
   snapToEdge?: boolean
-
   /** 同时显示的滑块数量
    * @default 1
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   displayMultipleItems?: number
-
   /** 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
    * @default false
    * @supported qq, jd
    */
   skipHiddenItemLayout?: boolean
-
   /** 指定 swiper 切换缓动动画类型
    * @default "default"
    * @supported weapp, alipay, tt, jd
    */
   easingFunction?: keyof SwiperProps.TEasingFunction
-
   /** 是否禁止用户 touch 操作
    * @default false
    * @supported alipay
    */
   disableTouch?: boolean
-
   /** 是否启用缩放
    * @default false
    * @supported h5
    */
   zoom?: boolean
-
   /** 是否开启全屏
    * @default false
    * @supported h5
    */
   full?: boolean
-
   /** swiper-item 可见时的 class。
    * @supported alipay
    */
   activeClass?: string
-
   /** acceleration 设置为 {{true}} 时且处于滑动过程中，中间若干屏处于可见时的 class。
    * @supported alipay
    */
   changingClass?: string
-
   /** 当开启时，会根据滑动速度，连续滑动多屏。
    * @default false
    * @supported alipay
    */
   acceleration?: string
-
   /** 是否禁用代码变动触发 swiper 切换时使用动画。
    * @default false
    * @supported alipay
    */
   disableProgrammaticAnimation?: string
-
   /** 滑动距离阈值，当滑动距离超过阈值时进行 swiper-item 切换。
    * @supported alipay
    */
   swipeRatio?: string
-
   /** 滑动综合速度阈值，当超过阈值时进行 swiper-item 切换，数值越小越敏感。
    * @supported alipay
    */
   swipeSpeed?: string
-
   /** 计算用户手势时所依赖的滑动角度。角度根据 touchstart 事件和首次 touchmove 事件的坐标计算得出。数值越小越对用户的滑动方向准确度要求越高。
    * @supported alipay
    */
   touchAngle?: string
-
   /** 自动以指定滑块的高度为整个容器的高度。当 vertical 为 true 时，默认不调整。可选值为：
    * @supported alipay
    */
   adjustHeight?: 'first' | 'current' | 'highest' | 'none'
-
   /** vertical 为 true 时强制使 adjust-height 生效。
    * @supported alipay
    */
   adjustVerticalHeight?: string
-
   /** 是否停止响应用户 touchmove 操作
    * @default false
    * @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
    */
   onTransition?: CommonEventFunction<SwiperProps.onTransitionEventDetail>
-
   /** 动画结束时会触发 animationfinish 事件
    * @supported weapp, swan, tt, qq, jd, h5, rn
    */
   onAnimationFinish?: SwiperProps['onChange']
-
   /** 动画结束时会触发 animationEnd 事件
    * @supported alipay
    */
@@ -193,57 +161,45 @@ declare namespace SwiperProps {
   interface TChangeSource {
     /** 自动播放 */
     autoplay
-
     /** 用户划动 */
     touch
-
     /** 其它原因 */
     ''
   }
-
   /** 指定 swiper 切换缓动动画类型 */
   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
   }
 }
-
 /** 滑块视图容器。其中只可放置 swiper-item 组件，否则会导致未定义的行为。
  * > 不要为 `SwiperItem` 设置 **style** 属性，可以通过 class 设置样式。[7147](https://github.com/NervJS/taro/issues/7147)
  * @classification viewContainer

package/types/SwiperItem.d.ts

@@ -5,14 +5,12 @@ interface SwiperItemProps extends StandardProps {
    * @supported weapp, swan, tt, jd, h5, rn
    */
   itemId?: string
-
   /** 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
    * @default false
    * @supported weapp
    */
   skipHiddenItemLayout?: boolean
 }
-
 /** 仅可放置在 swiper 组件中，宽高自动设置为100%
  * > 不要为 `SwiperItem` 设置 **style** 属性，可以通过 class 设置样式。[7147](https://github.com/NervJS/taro/issues/7147)
  * @classification viewContainer

package/types/Switch.d.ts

@@ -6,48 +6,40 @@ interface SwitchProps extends StandardProps, FormItemProps {
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   checked?: boolean
-
   /** 是否禁用
    * @default false
-   * @supported weapp, alipay, swan, tt, qq, rn
+   * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   disabled?: boolean
-
   /** 样式，有效值：switch, checkbox
    * @default "switch"
    * @supported weapp, swan, tt, qq, jd, h5, rn
    */
   type?: 'switch' | 'checkbox'
-
   /** switch 的颜色，同 css 的 color
    * @default "#04BE02"
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   color?: string
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @supported h5
    */
   nativeProps?: Record<string, unknown>
-
   /** 组件名字，用于表单提交获取数据。
    * @supported alipay
    */
   name?: string
-
   /** 是否为受控组件，为 true 时，checked 会完全受 setData 控制。
    * @default false
    * @supported alipay
    */
   controlled?: string
-
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
-
   /** checked 改变时触发 change 事件
-   * @supported weapp, alipay, swan, tt, qq, jd, rn
+   * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   onChange?: CommonEventFunction<SwitchProps.onChangeEventDetail>
 }
@@ -56,7 +48,6 @@ declare namespace SwitchProps {
     value: boolean
   }
 }
-
 /** 开关选择器
  * @classification forms
  * @example_react

package/types/TabItem.d.ts

@@ -6,26 +6,22 @@ interface TabItemProps extends StandardProps {
    * @default 无
    */
   label?: string
-
   /** tab-item 对应的 name 值
    * @supported swan
    * @default 无
    */
   name?: string
-
   /** 徽标类型 badge-type 分为圆点“dot”和文本“text”，不设置 badge-type 则不显示徽标
    * @supported swan
    * @default 无
    */
   badgeType?: string
-
   /** badge-type 为 text 的时候，徽标内的数字，为空时badge-type="text"不生效
    * @supported swan
    * @default 无
    */
   badgeText?: string
 }
-
 /** 标签栏子项
  * @classification navig
  * @supported swan

package/types/Tabs.d.ts

@@ -6,49 +6,41 @@ interface TabsProps extends StandardProps {
    * @default "#fff"
    */
   tabsBackgroundColor?: string
-
   /** tabs 激活 tab-item 文字颜色
    * @supported swan
    * @default "#000"
    */
   tabsActiveTextColor?: string
-
   /** tabs 非激活 tab-item 文字颜色
    * @supported swan
    * @default "#666"
    */
   tabsInactiveTextColor?: string
-
   /** tabs 激活 tab-item 下划线颜色
    * @supported swan
    * @default "#333"
    */
   tabsUnderlineColor?: string
-
   /** 仅用于普通标签栏组件，当前激活 tab-item 的对应的 name 值，须搭配 bindtabchange 一起使用。
    * @supported swan
    * @default 无
    */
   activeName?: string
-
   /** 仅用于可寻址标签栏组件，当前 tab 所改变的 url query 中参数 key，需要通过 tabs 修改页面 url 的时候设置。
    * @supported swan
    * @default 无
    */
   urlQueryName?: string
-
   /** 当前 tabs 视图中最多容纳的 tab-item 数量，低于此数量均分排列，超出此数量划屏。默认五个，开发者可根据业务需求调整
    * @supported swan
    * @default 5
    */
   maxTabItemAmount?: number
-
   /** tab 被点击的回调，可以在 e.detail.name 中取到当前点击的 tab-item 对应的 name 值
    * @supported swan
    */
   onTabChange?: CommonEventFunction
 }
-
 /** 标签栏
  * @classification navig
  * @supported swan

package/types/Text.d.ts

@@ -6,24 +6,20 @@ interface TextProps extends StandardProps {
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   selectable?: boolean
-
   /** 文本是否可选，该属性会使文本节点显示为 inline-block
    * @default false
    * @supported weapp
    */
   userSelect?: boolean
-
   /** 显示连续空格
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   space?: keyof TextProps.TSpace
-
   /** 是否解码
    * @default false
    * @supported weapp, alipay, tt, qq, jd
    */
   decode?: boolean
-
   /** 多行省略，值须大于等于 1，表现同 css 的 -webkit-line-clamp 属性一致。
    * @supported alipay
    */
@@ -34,15 +30,12 @@ declare namespace TextProps {
   interface TSpace {
     /** 中文字符空格一半大小 */
     ensp
-
     /** 中文字符空格大小 */
     emsp
-
     /** 根据字体设置的空格大小 */
     nbsp
   }
 }
-
 /** 文本
  * @classification base
  * @supported weapp, alipay, swan, tt, qq, jd, h5, rn

package/types/Textarea.d.ts

@@ -5,169 +5,139 @@ interface TextareaProps extends StandardProps, FormItemProps {
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   value?: string
-
   /** 输入框为空时占位符
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   placeholder?: string
-
   /** 指定 placeholder 的样式
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   placeholderStyle?: string
-
   /** 指定 placeholder 的样式类
    * @default "textarea-placeholder"
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   placeholderClass?: string
-
   /** 是否禁用
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   disabled?: boolean
-
   /** 最大输入长度，设置为 -1 的时候不限制最大长度
    * @default 140
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   maxlength?: number
-
   /** 自动聚焦，拉起键盘
    * @default false
    * @supported weapp, swan, qq, jd, h5
    */
   autoFocus?: boolean
-
   /** 获取焦点
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   focus?: boolean
-
   /** 是否自动增高，设置 autoHeight 时，style.height不生效
    * @default false
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   autoHeight?: boolean
-
   /** 如果 Textarea 是在一个 `position:fixed` 的区域，需要显示指定属性 fixed 为 true
    * @default false
    * @supported weapp, swan, qq, jd
    */
   fixed?: boolean
-
   /** 指定光标与键盘的距离，单位 px 。取 Textarea 距离底部的距离和 cursorSpacing 指定的距离的最小值作为光标与键盘的距离
    * @default 0
    * @supported weapp, swan, tt, qq, jd
    */
   cursorSpacing?: number
-
   /** 指定 focus 时的光标位置
    * @default -1
    * @supported weapp, swan, tt, qq, jd
    */
   cursor?: number
-
   /** 是否显示键盘上方带有”完成“按钮那一栏
    * @default true
    * @supported weapp, swan, tt, qq, jd
    */
   showConfirmBar?: boolean
-
   /** 光标起始位置，自动聚集时有效，需与 selectionEnd 搭配使用
    * @default -1
    * @supported weapp, swan, tt, qq, jd, rn
    */
   selectionStart?: number
-
   /** 光标结束位置，自动聚集时有效，需与 selectionStart 搭配使用
    * @default -1
    * @supported weapp, swan, tt, qq, jd, rn
    */
   selectionEnd?: number
-
   /** 键盘弹起时，是否自动上推页面
    * @default true
    * @supported weapp, swan, tt, qq, jd
    */
   adjustPosition?: boolean
-
   /** focus 时，点击页面的时候不收起键盘
    * @default false
    * @supported weapp, tt
    */
   holdKeyboard?: boolean
-
   /** 是否去掉 iOS 下的默认内边距
    * @default false
    * @supported weapp, tt
    */
   disableDefaultPadding?: boolean
-
   /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上
    * @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
-
   /** 是否渲染字数统计功能（是否删除默认计数器/是否显示字数统计）。
    * @supported alipay
    */
   showCount?: string
-
   /** 是否为受控组件。为 true 时，value 内容会完全受 setData 控制。
    * @supported alipay
    */
   controlled?: string
-
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
-
   /** 输入框聚焦时触发
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   onFocus?: CommonEventFunction<TextareaProps.onFocusEventDetail>
-
   /** 输入框失去焦点时触发
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   onBlur?: CommonEventFunction<TextareaProps.onBlurEventDetail>
-
   /** 输入框行数变化时调用
    * @supported weapp, swan, tt, qq, jd, rn
    */
   onLineChange?: CommonEventFunction<TextareaProps.onLineChangeEventDetail>
-
   /** 当键盘输入时，触发 input 事件
    *
    * **onInput 处理函数的返回值并不会反映到 textarea 上**
    * @supported weapp, alipay, swan, tt, qq, jd, h5, rn
    */
   onInput?: CommonEventFunction<TextareaProps.onInputEventDetail>
-
   /** 点击完成时， 触发 confirm 事件
    * @supported weapp, alipay, swan, tt, qq, jd, rn
    */
   onConfirm?: CommonEventFunction<TextareaProps.onConfirmEventDetail>
-
   /** 键盘高度发生变化的时候触发此事件
    * @supported weapp
    */
@@ -177,14 +147,12 @@ declare namespace TextareaProps {
   interface onFocusEventDetail {
     /** 输入值 */
     value: string
-
     /** 键盘高度 */
     height: number
   }
   interface onBlurEventDetail {
     /** 输入值 */
     value: string
-
     /** 光标位置 */
     cursor: number
   }
@@ -196,10 +164,8 @@ declare namespace TextareaProps {
   interface onInputEventDetail {
     /** 输入值 */
     value: string
-
     /** 光标位置 */
     cursor: number
-
     /** 键值 */
     keyCode: number
   }
@@ -210,12 +176,10 @@ declare namespace TextareaProps {
   interface onKeyboardHeightChangeEventDetail {
     /** 键盘高度 */
     height: number
-
     /** 持续时间 */
     duration: number
   }
 }
-
 /** 多行输入框。该组件是原生组件，使用时请注意相关限制
  * @classification forms
  * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony