uniapp中uview组件库丰富的CountDown 倒计时使用方法

简介: uniapp中uview组件库丰富的CountDown 倒计时使用方法

该组件一般使用于某个活动的截止时间上,通过数字的变化,给用户明确的时间感受,提示用户进行某一个行为操作。

#平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 头条小程序 QQ小程序

#基本使用

  • 通过timestamp参数设置倒计时间,单位为
<template>
  <u-count-down :timestamp="timestamp"></u-count-down>
</template>
 
<script>
  export default {
    data() {
      timestamp: 86400,
    }
  }
</script>

#设置是否显示天,时,分,秒

说明:参数的配置原则应该是"自右向左"的,设置了"时",它右边的"分"和"秒"也应该设置为true

  • show-daysshow-hoursshow-minutesshow-seconds等参数默认为true,分别对应是否显示倒计时的"天","时","分","秒"。

该示例表示只显示倒计时的分和秒

<u-count-down :timestamp="86400" :show-days="false" :show-hours="false"></u-count-down>

#倒计时分隔符

通过配置separator参数为colon或者zh来区分分隔符。separator-size配置分隔符的大小,单位rpx。separator-color配置分隔符的颜色 separator可选值如下:

  • colon(默认)时显示为冒号,如:23:14:51
  • zh时显示为中文,如:23时14分51秒
<u-count-down :timestamp="86400" separator="colon" separator-size="28" separator-color="#606266"></u-count-down>

#倒计时样式

  • 通过color设置倒计数字的颜色
  • font-size设置倒计数字的大小,重申一次:uView中,所有font-sizewidthheightpaddingmargin等props参数 的单位默认都是rpx,特别说明除外(极少数场景会要求px单位)。关于rpx单位的说明,请参考uni官方文档:尺寸单位(opens new window)
  • show-border参数设置倒计数字是否添加边框,border-color参数设置边框的颜色
<u-count-down :timestamp="86400" :show-border="true" font-size="28" color="#606266" border-color="#909399"></u-count-down>

#倒计时执行的时机

通过autoplay配置倒计时是否在组件的mounted生命周期进行初始化(在timestamp有值前提下),如果设置autoplayfalse,就需要手动通过 refs的形式通知倒计时开始执行,调用的是组件内部的start()方法

<template>
  <u-count-down ref="uCountDown" :timestamp="86400" :autoplay="false"></u-count-down>
</template>
 
<script>
  export default {
    onLoad() {
      setTimeout(() => {
        this.$refs.uCountDown.start();
      }, 2000)
    }
  }
</script>

#如何获取当前倒计的秒数

有时候我们可会需要记录当前剩余的秒数,并在某个时机重新触发,可以通过如下两个方式实现:

  • 监听change事件,在回调中获得当前剩余的秒数
  • 通过ref调用,获取内部的seconds参数即为当前剩余的秒数
<template>
  <u-count-down ref="uCountDown" :timestamp="timestamp" @change="change"></u-count-down>
</template>
 
<script>
  export default {
    data() {
      return {
        timestamp: 86400
      }
    },
    methods: {
      // 事件触发,每秒一次
      change(timestamp) {
        console.log(timestamp);
      },
      // ref形式获取内部的值
      getSeconds() {
        console.log(this.$refs.uCountDown.seconds);
      }
    }
  }
</script>

#API

#Props

参数 说明 类型 默认值 可选值
timestamp 倒计时,单位为秒 String | Number 0 -
autoplay 是否自动开始倒计时,如果为false,需手动调用开始方法。见上方说明 Boolean true false
separator 分隔符,colon为英文冒号,zh为中文 String colon zh
separator-size 分隔符的字体大小,单位rpx String | Number 30 -
separator-color 分隔符的颜色 String #303133 -
font-size 倒计时字体大小,单位rpx String | Number 30 -
show-border 是否显示倒计时数字的边框 Boolean false true
border-color 数字边框的颜色 String #303133 -
bg-color 倒计时数字的背景颜色 String #ffffff -
color 倒计时数字的颜色 String #303133 -
height 数字高度值(宽度等同此值),设置边框时看情况是否需要设置此值,单位rpx String auto -
show-days 是否显示倒计时的"天"部分 Boolean true false
show-hours 是否显示倒计时的"时"部分 Boolean true false
show-minutes 是否显示倒计时的"分"部分 Boolean true false
show-seconds 是否显示倒计时的"秒"部分 Boolean true false
hide-zero-day 1.4.4 当"天"的部分为0时,隐藏该字段 Boolean true false

#Events

事件名 说明 回调参数
end 倒计时结束 -
change 倒计过程中,每秒触发一次 timestamp: 当前剩余的倒计秒数

#Methods

需要通过ref获取倒计时组件才能调用,见上方"倒计时执行的时机"说明

名称 说明
start 开始倒计时


相关文章
|
3月前
|
小程序 前端开发 JavaScript
在线课堂+工具组件小程序uniapp移动端源码
在线课堂+工具组件小程序uniapp移动端源码
77 0
在线课堂+工具组件小程序uniapp移动端源码
|
4月前
|
数据可视化 大数据 API
低代码可视化开发-uniapp新闻跑马灯组件-代码生成器
低代码可视化开发-uniapp新闻跑马灯组件-代码生成器
205 2
|
4月前
|
存储 API 数据库
uniapp APP自动更新组件
uniapp APP自动更新组件
146 1
|
4月前
|
移动开发 编解码 数据可视化
低代码可视化-uniapp SliderRange区间组件-代码生成器
SliderRange区间组件是一种用户界面元素,允许用户通过拖动滑块选择数值范围。组件支持微信小程序、H5和App,具有高度可定制性、响应式设计和多种事件处理功能。适用于价格筛选、音量调节等场景。代码实现包括滑动区域、滑块、事件处理等部分,支持可视化配置步长、颜色等属性。使用时需注意选择合适步长、提供清晰标签和考虑无障碍设计。
101 0
|
7月前
|
JavaScript Java 测试技术
基于SpringBoot+Vue+uniapp的房屋租赁App的详细设计和实现(源码+lw+部署文档+讲解等)
基于SpringBoot+Vue+uniapp的房屋租赁App的详细设计和实现(源码+lw+部署文档+讲解等)
161 7
基于SpringBoot+Vue+uniapp的房屋租赁App的详细设计和实现(源码+lw+部署文档+讲解等)
|
7月前
|
JavaScript Java 测试技术
基于SpringBoot+Vue+uniapp的汉服交易小程序的详细设计和实现(源码+lw+部署文档+讲解等)
基于SpringBoot+Vue+uniapp的汉服交易小程序的详细设计和实现(源码+lw+部署文档+讲解等)
91 7
|
7月前
|
JavaScript Java 测试技术
基于SpringBoot+Vue+uniapp的宠物医院微信小程序的详细设计和实现(源码+lw+部署文档+讲解等)
基于SpringBoot+Vue+uniapp的宠物医院微信小程序的详细设计和实现(源码+lw+部署文档+讲解等)
117 7
|
7月前
|
JavaScript Java 测试技术
基于SpringBoot+Vue+uniapp的武汉市公交路线查询系统的详细设计和实现(源码+lw+部署文档+讲解等)
基于SpringBoot+Vue+uniapp的武汉市公交路线查询系统的详细设计和实现(源码+lw+部署文档+讲解等)
140 7
|
7月前
|
JavaScript Java 测试技术
基于SpringBoot+Vue+uniapp的旅游攻略系统的详细设计和实现(源码+lw+部署文档+讲解等)
基于SpringBoot+Vue+uniapp的旅游攻略系统的详细设计和实现(源码+lw+部署文档+讲解等)
150 7
|
7月前
|
JavaScript Java 测试技术
基于SpringBoot+Vue+uniapp的成人教育APP的详细设计和实现(源码+lw+部署文档+讲解等)
基于SpringBoot+Vue+uniapp的成人教育APP的详细设计和实现(源码+lw+部署文档+讲解等)
117 7

热门文章

最新文章