@tarojs/components 3.6.2 → 3.6.4

package/types/MatchMedia.d.ts

@@ -5,38 +5,31 @@ interface MatchMediaProps extends StandardProps {
    * @supported weapp, alipay
    */
   minWidth?: number
-
   /** 页面最大宽度（ px 为单位）
    * @supported weapp, alipay
    */
   maxWidth?: number
-
   /** 页面宽度（ px 为单位）
    * @supported weapp, alipay
    */
   width?: number
-
   /** 页面最小高度（ px 为单位）
    * @supported weapp, alipay
    */
   minHeight?: number
-
   /** 页面最大高度（ px 为单位）
    * @supported weapp, alipay
    */
   maxHeight?: number
-
   /** 页面高度（ px 为单位）
    * @supported weapp, alipay
    */
   height?: number
-
   /** 屏幕方向（ landscape 或 portrait ）
    * @supported weapp, alipay
    */
   orientation?: string
 }
-
 /** media query 匹配检测节点。可以指定一组 media query 规则，满足时，这个节点才会被展示。
  * 通过这个节点可以实现“页面宽高在某个范围时才展示某个区域”这样的效果。
  * @supported weapp, alipay

package/types/MovableArea.d.ts

@@ -7,7 +7,6 @@ interface MovableAreaProps extends StandardProps {
    */
   scaleArea?: boolean
 }
-
 /** movable-view 的可移动区域
  * @classification viewContainer
  * @supported weapp, alipay, swan, tt, qq, jd, h5, rn

package/types/MovableView.d.ts

@@ -6,143 +6,117 @@ interface MovableViewProps extends Omit<StandardProps, 'animation'> {
    * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   direction?: 'all' | 'vertical' | 'horizontal' | 'none'
-
   /** movable-view 是否带有惯性
    * @default false
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   inertia?: boolean
-
   /** 超过可移动区域后，movable-view 是否还可以移动
    * @default false
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   outOfBounds?: boolean
-
   /** 定义 x 轴方向的偏移，如果 x 的值不在可移动范围内，会自动移动到可移动范围；改变 x 的值会触发动画
    * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   x?: number | string
-
   /** 定义 y 轴方向的偏移，如果 y 的值不在可移动范围内，会自动移动到可移动范围；改变 y 的值会触发动画
    * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   y?: number | string
-
   /** 阻尼系数，用于控制x或y改变时的动画和过界回弹的动画，值越大移动越快
    * @default 20
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   damping?: number
-
   /** 摩擦系数，用于控制惯性滑动的动画，值越大摩擦力越大，滑动越快停止；必须大于 0，否则会被设置成默认值
    * @default 2
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   friction?: number
-
   /** 是否禁用
    * @default false
    * @supported weapp, alipay, swan, tt, qq, h5, rn
    */
   disabled?: boolean
-
   /** 是否支持双指缩放，默认缩放手势生效区域是在 movable-view 内
    * @default false
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   scale?: boolean
-
   /** 定义缩放倍数最小值
    * @default 0.5
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   scaleMin?: number
-
   /** 定义缩放倍数最大值
    * @default 10
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   scaleMax?: number
-
   /** 定义缩放倍数，取值范围为 0.5 - 10
    * @default 1
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   scaleValue?: number
-
   /** 是否使用动画
    * @default true
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   animation?: boolean
-
   /** 拖动过程中触发的事件
    * @supported weapp, alipay, swan, tt, qq
    */
   onChange?: CommonEventFunction<MovableViewProps.onChangeEventDetail>
-
   /** 拖动结束触发的事件
    * @supported alipay
    */
   onChangeEnd?: CommonEventFunction<MovableViewProps.onChangeEventDetail>
-
   /** 开始拖动时触发
    * @supported rn
    */
   onDragStart?: CommonEventFunction
-
   /** 拖动结束时触发
    * @supported rn
    */
   onDragEnd?: CommonEventFunction
-
   /** 缩放过程中触发的事件
    * @supported weapp, alipay, swan, tt, qq, h5
    */
   onScale?: CommonEventFunction<MovableViewProps.onScaleEventDetail>
-
   /** 触摸动作开始，事件会向父节点传递。
    * @supported alipay
    */
   onTouchStart?: CommonEventFunction
-
   /** 触摸动作开始，事件仅作用于组件，不向父节点传递。
    * @supported alipay
    */
   onTouchMove?: CommonEventFunction
-
   /** 手指触摸动作结束
    * @supported alipay, h5
    * @h5 此事件的触发顺序会因为当前事件机制引起组件内外注册的事件执行顺序不正常，外部注册的事件可能会优先于内部执行，如需保证执行顺序一致，需要在回调函数中包裹 setTimeout 临时处理
    */
   onTouchEnd?: TouchEventFunction
-
   /** 触摸动作被打断，如来电提醒、弹窗。
    * @supported alipay
    */
   onTouchCancel?: CommonEventFunction
-
   /** 初次手指触摸后移动为横向的移动，如果 catch 此事件，则意味着 touchmove 事件也被 catch
    * @supported weapp, swan, tt, h5
    */
   onHTouchMove?: TouchEventFunction
-
   /** 初次手指触摸后移动为纵向的移动，如果 catch 此事件，则意味着 touchmove 事件也被 catch
    * @supported weapp, swan, tt, h5
    */
   onVTouchMove?: TouchEventFunction
-
   /** 触摸移动事件，事件仅作用于组件，不向父节点传递。
    * @supported alipay
    */
   catchTouchStart?: CommonEventFunction
-
   /** 触摸移动事件，事件仅作用于组件，不向父节点传递。
    * @supported alipay
    */
   catchTouchMove?: CommonEventFunction
-
   /** 触摸动作结束，事件仅作用于组件，不向父节点传递。
    * @supported alipay
    */
@@ -153,41 +127,32 @@ declare namespace MovableViewProps {
   interface TChangeSource {
     /** 拖动 */
     touch
-
     /** 超出移动范围 */
     'touch-out-of-bounds'
-
     /** 超出移动范围后的回弹 */
     'out-of-bounds'
-
     /** 惯性 */
     friction
-
     /** setData */
     ''
   }
   interface onChangeEventDetail {
     /** X 坐标 */
     x: number
-
     /** Y 坐标 */
     y: number
-
     /** 触发事件 */
     source: keyof MovableViewProps.TChangeSource
   }
   interface onScaleEventDetail {
     /** X 坐标 */
     x: number
-
     /** Y 坐标 */
     y: number
-
     /** 缩放比例 */
     scale: number
   }
 }
-
 /** 可移动的视图容器，在页面中可以拖拽滑动。movable-view 必须在 movable-area 组件中，并且必须是直接子节点，否则不能移动。
  * @classification viewContainer
  * @supported weapp, alipay, swan, tt, qq, h5, rn

package/types/NavigationBar.d.ts

@@ -5,35 +5,29 @@ interface NavigationBarProps extends StandardProps {
    * @supported weapp
    */
   title?: string
-
   /** 是否在导航条显示 loading 加载提示
    * @supported weapp
    */
   loading?: boolean
-
   /** 导航条前景颜色值，包括按钮、标题、状态栏的颜色，仅支持 #ffffff 和 #000000
    * @supported weapp
    */
   frontColor?: string
-
   /** 导航条背景颜色值，有效值为十六进制颜色
    * @supported weapp
    */
   backgroundColor?: string
-
   /** 改变导航栏颜色时的动画时长，默认为 0 （即没有动画效果）
    * @default 0
    * @supported weapp
    */
   colorAnimationDuration?: string
-
   /** 改变导航栏颜色时的动画方式，支持 linear 、 easeIn 、 easeOut 和 easeInOut
    * @default "linear"
    * @supported weapp
    */
   colorAnimationTimingFunc?: 'linear' | 'easeIn' | 'easeOut' | 'easeInOut'
 }
-
 /** 页面导航条配置节点，用于指定导航栏的一些属性。只能是 PageMeta 组件内的第一个节点，需要配合它一同使用。
  * 通过这个节点可以获得类似于调用 Taro.setNavigationBarTitle Taro.setNavigationBarColor 等接口调用的效果。
  * @classification navig

package/types/Navigator.d.ts

@@ -6,87 +6,71 @@ interface NavigatorProps extends StandardProps {
    * @supported weapp, swan, qq
    */
   target?: keyof NavigatorProps.Target
-
   /** 当前小程序内的跳转链接
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   url?: string
-
   /** 跳转方式
    * @default "navigate"
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   openType?: keyof NavigatorProps.OpenType
-
   /** 当 open-type 为 'navigateBack' 时有效，表示回退的层数
    * @supported weapp, swan, tt, qq, jd, h5
    */
   delta?: number
-
   /** 当 `target="miniProgram"` 时有效，要打开的小程序 appId
    * @supported weapp, swan, qq
    */
   appId?: string
-
   /** 当 `target="miniProgram"` 时有效，打开的页面路径，如果为空则打开首页
    * @supported weapp, swan, qq
    */
   path?: string
-
   /** 当 `target="miniProgram"` 时有效，需要传递给目标小程序的数据，目标小程序可在 `App.onLaunch()`，`App.onShow()` 中获取到这份数据.
    * @supported weapp, swan, qq
    */
   extraData?: object
-
   /** 当 `target="miniProgram"` 时有效，要打开的小程序版本
    * @supported weapp, swan, qq
    */
   version?: keyof NavigatorProps.Version
-
   /** 指定按下去的样式类。当 `hover-class="none"` 时，没有点击态效果
    * @default "navigator-hover"
    * @supported weapp, alipay, swan, tt, qq, jd, h5
    */
   hoverClass?: string
-
   /** 指定是否阻止本节点的祖先节点出现点击态
    * @default false
    * @supported weapp, swan, tt, qq, jd
    */
   hoverStopPropagation?: boolean
-
   /** 按住后多久出现点击态，单位毫秒
    * @default 50
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   hoverStartTime?: number
-
   /** 手指松开后点击态保留时间，单位毫秒
    * @default 600
    * @supported weapp, alipay, swan, tt, qq, jd
    */
   hoverStayTime?: number
-
   /** 当target="miniProgram"时有效，当传递该参数后，可以不传 app-id 和 path。链接可以通过【小程序菜单】->【复制链接】获取。
    * @supported weapp
    */
   shortLink?: string
-
   /** 无障碍访问，（属性）元素的额外描述
    * @supported qq
    */
   ariaLabel?: string
-
   /** 当 `target="miniProgram"` 时有效，跳转小程序成功
    * @supported weapp, swan, qq, h5
    */
   onSuccess?: CommonEventFunction
-
   /** 当 `target="miniProgram"` 时有效，跳转小程序失败
    * @supported weapp, swan, qq, h5
    */
   onFail?: CommonEventFunction
-
   /** 当 `target="miniProgram"` 时有效，跳转小程序完成
    * @supported weapp, swan, qq, h5
    */
@@ -97,45 +81,34 @@ declare namespace NavigatorProps {
   interface Target {
     /** 当前小程序 */
     self
-
     /** 其它小程序 */
     miniProgram
   }
-
   /** open-type 的合法值 */
   interface OpenType {
     /** 对应 Taro.navigateTo 或 Taro.navigateToMiniProgram 的功能 */
     navigate
-
     /** 对应 Taro.redirectTo 的功能 */
     redirect
-
     /** 对应 Taro.switchTab 的功能 */
     switchTab
-
     /** 对应 Taro.reLaunch 的功能 */
     reLaunch
-
     /** 对应 Taro.navigateBack 的功能 */
     navigateBack
-
     /** 退出小程序，`target="miniProgram"` 时生效 */
     exit
   }
-
   /** version 的合法值 */
   interface Version {
     /** 开发版 */
     develop
-
     /** 体验版 */
     trial
-
     /** 正式版，仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是正式版，则打开的小程序必定是正式版。 */
     release
   }
 }
-
 /** 页面链接
  * @classification navig
  * @supported weapp, alipay, swan, tt, qq, jd, harmony, h5

package/types/OfficialAccount.d.ts

@@ -5,7 +5,6 @@ interface OfficialAccountProps extends StandardProps {
    * @supported weapp
    */
   onLoad?: CommonEventFunction<OfficialAccountProps.Detail>
-
   /** 组件加载失败时触发
    * @supported weapp
    */
@@ -16,42 +15,31 @@ declare namespace OfficialAccountProps {
   interface Detail {
     /** 状态码 */
     status: number
-
     /** 错误信息 */
     errMsg: string
   }
-
   /** status 有效值 */
   interface Status {
     /** 网络错误 */
     '-2'
-
     /** 数据解析错误 */
     '-1'
-
     /** 加载成功 */
     0
-
     /** 小程序关注公众号功能被封禁 */
     1
-
     /** 关联公众号被封禁 */
     2
-
     /** 关联关系解除或未选中关联公众号 */
     3
-
     /** 未开启关注公众号功能 */
     4
-
     /** 场景值错误 */
     5
-
     /** 重复创建 */
     6
   }
 }
-
 /** 公众号关注组件。当用户扫小程序码打开小程序时，开发者可在小程序内配置公众号关注组件，方便用户快捷关注公众号，可嵌套在原生组件内。
  *
  * Tips

package/types/OpenData.d.ts

@@ -5,48 +5,39 @@ interface OpenDataProps extends StandardProps {
    * @supported weapp, swan, tt, qq
    */
   type: keyof OpenDataProps.Type
-
   /** 当 type="groupName" 时生效, 群id
    * @supported weapp
    */
   openGid?: string
-
   /** 当 type="user*" 时生效，以哪种语言展示 userInfo
    * @default "en"
    * @supported weapp, qq
    */
   lang?: keyof OpenDataProps.Lang
-
   /** 数据为空时的默认文案
    * @supported weapp, tt
    */
   defaultText?: string
-
   /** 用户头像为空时的默认图片，支持相对路径和网络图片路径
    * @supported weapp, tt
    */
   defaultAvatar?: string
-
   /** 当数据为空且未设置默认值时，是否显示官方默认值
    * @supported tt
    */
   useEmptyValue?: string
-
   /** 当 type=groupCloudStorage 时有效，群分享对应的 shareTicket
    * @supported qq
    */
   shareTicket?: string
-
   /** 当 type=*CloudStorage 时有效，指定要拉取的 key 列表
    * @supported qq
    */
   keyList?: string
-
   /** 当 type=*CloudStorage 时有效，从主域透传给开放数据域的数据，会自动注入到自定义开放数据域组件的 properties 中
    * @supported qq
    */
   componentData?: string
-
   /** 群名称或用户信息为空时触发
    * @supported weapp, tt, qq
    */
@@ -57,42 +48,31 @@ declare namespace OpenDataProps {
   interface Type {
     /** 拉取群名称 */
     groupName
-
     /** 用户昵称 */
     userNickName
-
     /** 用户头像 */
     userAvatarUrl
-
     /** 用户性别 */
     userGender
-
     /** 用户所在城市 */
     userCity
-
     /** 用户所在省份 */
     userProvince
-
     /** 用户所在国家 */
     userCountry
-
     /** 用户的语言 */
     userLanguage
   }
-
   /** lang 的合法值 */
   interface Lang {
     /** 英文 */
     en
-
     /** 简体中文 */
     zh_CN
-
     /** 繁体中文 */
     zh_TW
   }
 }
-
 /** 用于展示平台开放的数据
  * @classification open
  * @supported weapp, swan, tt, qq

package/types/PageContainer.d.ts

@@ -6,93 +6,76 @@ interface PageContainerProps extends StandardProps {
    * @supported weapp, alipay, rn
    */
   show?: boolean
-
   /** 动画时长，单位毫秒
    * @default 300
    * @supported weapp, alipay, rn
    */
   duration?: number
-
   /** z-index 层级
    * @default 100
    * @supported weapp, alipay
    */
   zIndex?: number
-
   /** 是否显示遮罩层
    * @default true
    * @supported weapp, alipay, rn
    */
   overlay?: boolean
-
   /** 弹出位置，可选值为 top bottom right center
    * @default bottom
    * @supported weapp, alipay, rn
    */
   position?: keyof PageContainerProps.Position
-
   /** 是否显示圆角
    * @default false
    * @supported weapp, alipay, rn
    */
   round?: boolean
-
   /** 自定义遮罩层样式
    * @supported weapp, alipay, rn
    */
   overlayStyle?: string
-
   /** 自定义弹出层样式
    * @supported weapp, alipay, rn
    */
   customStyle?: string
-
   /** 是否在下滑一段距离后关闭
    * @supported weapp, alipay
    * @default false
    */
   closeOnSlideDown?: boolean
-
   /** 进入前触发
    * @supported weapp, alipay, rn
    */
   onBeforeEnter?: CommonEventFunction
-
   /** 进入中触发
    * @supported weapp, alipay, rn
    */
   onEnter?: CommonEventFunction
-
   /** 进入后触发
    * @supported weapp, alipay, rn
    */
   onAfterEnter?: CommonEventFunction
-
   /** 离开前触发
    * @supported weapp, alipay, rn
    */
   onBeforeLeave?: CommonEventFunction
-
   /** 离开中触发
    * @supported weapp, alipay, rn
    */
   onLeave?: CommonEventFunction
-
   /** 离开后触发
    * @supported weapp, alipay, rn
    */
   onAfterLeave?: CommonEventFunction
-
   /** 点击遮罩层时触发
    * @supported weapp, alipay
    */
   onClickOverlay?: CommonEventFunction
-
   /** 进入被打断时触发（通过 a: if 打断时不会触发）。
    * @supported alipay
    */
   onEnterCancelled?: CommonEventFunction
-
   /** 离开被打断时触发（通过 a: if 打断时不会触发）。
    * @supported alipay
    */
@@ -103,18 +86,14 @@ declare namespace PageContainerProps {
   interface Position {
     /** 上方弹出 */
     top
-
     /** 下方弹出 */
     bottom
-
     /** 右边弹出 */
     right
-
     /** 中央弹出 */
     center
   }
 }
-
 /** 页面容器
  *
  * 小程序如果在页面内进行复杂的界面设计（如在页面内弹出半屏的弹窗、在页面内加载一个全屏的子页面等），用户进行返回操作会直接离开当前页面，不符合用户预期，预期应为关闭当前弹出的组件。