主题
Timer 计时器
从初始时间开始正向计时,可设置最大计时时间。
支持平台
以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。
| App-vue | App-nvue | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 | H5 | PC | 快手小程序 | 钉钉小程序 |
|---|---|---|---|---|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
基础用法
vue
<!-- 自动开始计时 -->
<fui-timer :maxTime="3600" />属性
| 属性 | 类型 | 说明 | 官网默认值 |
|---|---|---|---|
| value | Number / String | 初始时间,单位秒 | #333(官网表格值) |
| maxTime | Number / String | 最大计时时间,单位秒;0 表示手动结束 | 0 |
| width | Number / String | 数字框宽度,单位 rpx | 40 |
| height | Number / String | 数字框高度,单位 rpx | 40 |
| borderWidth | Number / String | 数字框边框宽度,单位 rpx | 0 |
| borderColor | String | 数字框边框颜色 | transparent |
| background | String | 数字框背景色 | transparent |
| size | Number / String | 数字字号,单位 rpx | 32 |
| color | String | 数字颜色 | #333 |
| colonSize | Number / String | 分隔符或单位字号,单位 rpx | 32 |
| colonColor | String | 分隔符或单位颜色 | #333 |
| isDays | Boolean | 是否显示天 | false |
| isHours | Boolean | 是否显示小时 | true |
| isMinutes | Boolean | 是否显示分钟 | true |
| isSeconds | Boolean | 是否显示秒 | true |
| isMs | Boolean | 是否显示毫秒 | false |
| msWidth | Number / String | 毫秒框宽度,0 为自适应,单位 rpx | 0 |
| msSize | Number / String | 毫秒字号,单位 rpx | 28 |
| msColor | String | 毫秒文字颜色,未设置时使用 color | - |
| isColon | Boolean | 是否用冒号分隔时间 | true |
| autoStart | Boolean | 是否自动开始 | true |
官网 value 默认值写为 #333,与其数值类型不符;本地源码默认值为 0,使用时请按秒传入数字。
事件
| 事件 | 说明 | 回调参数 |
|---|---|---|
| end | 计时结束 | { day, hour, minute, second, totalSeconds } |
组件实例提供 startTiming()、resetTimer() 和 endTimer();其中 endTimer() 会触发 end。
插槽
| 插槽 | 说明 |
|---|---|
| — | 官网未列出该组件的插槽 |