Skip to content

基础使用

通过设置一个结束日期对象 endDate 开启一个倒计时。

vue
<hi-countdown :endDate="endDate"></hi-countdown>

设置展示的数据

通过 mode 设置展示的数据。mode 为一个数组,可选的值有:dddhhhmmmsss。其中双字母表示补零,单字母不补零。

vue
<hi-countdown :endDate="endDate" :mode="['dd', 'hh', 'mm', 'ss']"></hi-countdown>
<hi-countdown :endDate="endDate" :mode="['d', 'h', 'm', 's']"></hi-countdown>

自定义分隔符

通过 separator 设置分隔符。separator 是一个对象,其属性为: dayshoursminutesseconds

vue
<hi-countdown :endDate="endDate" :separator="{ days: '日', hours: '小时', minutes: '分钟', seconds: '秒' }"></hi-countdown>

结束提示

可以通过 endText 设置倒计时结束后的提示。不设置时,倒计时结束后会显示 00天00时00分00秒 这样的文本。

vue
<hi-countdown :endDate="new Date()" endText="活动已结束~"></hi-countdown>

Props

参数说明类型默认值可选值
mode显示的数据模式Array["dd", "hh", "mm", "ss"]-
endText倒计时结束后的提示文本String--
endDate结束日期datenew Date()-
separator分隔符Object{ days: "天", hours: "时", minutes: "分", seconds: "秒" }-

Events

名称说明参数
@change倒计时改变时触发countdown: Object - 倒计时数据,其中包括剩余的天数、小时数、分钟数、秒数、是否结束等
@end倒计时结束时触发-

Slots

名称说明参数
#daysdays: Number - 剩余天数;
#hours小时hours: Number - 剩余小时数;
#minutes分钟minutes: Number - 剩余分钟数;
#secondsseconds: Number - 剩余秒数;
#daysSeparator天分隔符separator: String - 天分隔符
#hoursSeparator小时分隔符separator: String - 小时分隔符
#minutesSeparator分钟分隔符separator: String - 分钟分隔符
#secondsSeparator秒分隔符separator: String - 秒分隔符