Skip to main content
Version: 3.x

common

StandardProps​

参数类型必填说明
idstring否组件的唯一标示, 保持整个页面唯一
classNamestring否同 class,在 React/Nerv 里一般使用 className 作为 class 的代称
styleany否组件的内联样式, 可以动态设置的内联样式
keystring or number否如果列表中项目的位置会动态改变或者有新的项目添加到列表中,
需要使用 wx:key 来指定列表中项目的唯一的标识符。
hiddenboolean否组件是否显示, 所有组件默认显示
animation{ actions: TaroGeneral.IAnyObject[]; }否动画属性
refLegacyRef<T>否引用
dangerouslySetInnerHTML{ __html: string; }否渲染 HTML
参考地址

FormItemProps​

参数类型必填说明
namestring否表单数据标识

EventProps​

参数类型必填说明
onTouchStart(event: TouchEvent) => void否手指触摸动作开始
onTouchMove(event: TouchEvent) => void否手指触摸后移动
onTouchCancel(event: TouchEvent) => void否手指触摸动作被打断,如来电提醒,弹窗
onTouchEnd(event: TouchEvent) => void否手指触摸动作结束
onClick(event: ITouchEvent) => void否手指触摸后马上离开
onLongPress(event: CommonEvent<any>) => void否手指触摸后,超过350ms再离开,如果指定了事件回调函数并触发了这个事件,tap事件将不被触发
onLongClick(event: CommonEvent<any>) => void否手指触摸后,超过350ms再离开(推荐使用 longpress 事件代替)
onTransitionEnd(event: CommonEvent<any>) => void否会在 WXSS transition 或 Taro.createAnimation 动画结束后触发
onAnimationStart(event: CommonEvent<any>) => void否会在一个 WXSS animation 动画开始时触发
onAnimationIteration(event: CommonEvent<any>) => void否会在一个 WXSS animation 一次迭代结束时触发
onAnimationEnd(event: CommonEvent<any>) => void否会在一个 WXSS animation 动画完成时触发
onTouchForceChange(event: CommonEvent<any>) => void否在支持 3D Touch 的 iPhone 设备,重按时会触发

CommonEvent​

参数类型说明
typestring事件类型
timeStampnumber事件生成时的时间戳
targetTarget触发事件的组件的一些属性值集合
currentTargetTarget当前组件的一些属性值集合
detailT额外的信息
preventDefault() => void阻止元素发生默认的行为
stopPropagation() => void阻止事件冒泡到父元素,阻止任何父事件处理程序被执行

BaseEventOrig​

参数类型说明
typestring事件类型
timeStampnumber事件生成时的时间戳
targetTarget触发事件的组件的一些属性值集合
currentTargetTarget当前组件的一些属性值集合
detailT额外的信息
preventDefault() => void阻止元素发生默认的行为
stopPropagation() => void阻止事件冒泡到父元素,阻止任何父事件处理程序被执行

BaseTouchEvent​

参数类型说明
touchesTouchDetail[]触摸事件,当前停留在屏幕中的触摸点信息的数组
changedTouchesTouchDetail[]触摸事件,当前变化的触摸点信息的数组

CanvasTouchEvent​

参数类型说明
touchesTouchDetail[]触摸事件,当前停留在屏幕中的触摸点信息的数组
changedTouchesTouchDetail[]触摸事件,当前变化的触摸点信息的数组

ITouchEvent​

参数类型说明
touchesTouchDetail[]触摸事件,当前停留在屏幕中的触摸点信息的数组
changedTouchesTouchDetail[]触摸事件,当前变化的触摸点信息的数组

CanvasTouch​

参数类型
identifiernumber
xnumber
ynumber

ITouch​

参数类型说明
identifiernumber触摸点的标识符
pageXnumber距离文档左上角的距离,文档的左上角为原点 ,横向为X轴,纵向为Y轴
pageYnumber距离文档左上角的距离,文档的左上角为原点 ,横向为X轴,纵向为Y轴
clientXnumber距离页面可显示区域(屏幕除去导航条)左上角距离,横向为X轴,纵向为Y轴
clientYnumber距离页面可显示区域(屏幕除去导航条)左上角距离,横向为X轴,纵向为Y轴

Target​

参数类型说明
idstring事件源组件的id
tagNamestring当前组件的类型
dataset{ [key: string]: any; }事件源组件上由data-开头的自定义属性组成的集合

currentTarget​

参数类型说明
idstring事件源组件的id
tagNamestring当前组件的类型
dataset{ [key: string]: any; }事件源组件上由data-开头的自定义属性组成的集合

NetStatus​

网络状态数据

参数类型必填
videoBitratenumber否
audioBitratenumber否
videoFPSstring or number否
videoGOPnumber否
netSpeednumber否
netJitternumber否
videoWidthstring or number否
videoHeightstring or number否