qrcode
扫描二维码查看 H5 演示效果
qrcode
扫描二维码查看演示效果
taro-ui, 非 taro-ui-vue3
wxapp

Calendar 日历


该组件提供日历选择功能(包括范围选择)

注意目前 h5 和 小程序 实现的方案不一致 可能导致效果不同 和 部分 API 无法使用 具体效果请看 h5 上的展示

使用指南

在 Taro 文件中引入组件

import { AtCalendar } from 'taro-ui-vue3'

组件依赖的样式文件(仅按需引用时需要)

@import "taro-ui-vue3/dist/style/components/calendar.scss";

一般用法

<AtCalendar />

跳转到指定日期

<AtCalendar currentDate="2018/11/11" />

指定最小日期和最大日期

<AtCalendar minDate="2018/1/1" maxDate="2018/10/1" />

标记时间

<AtCalendar :marks="[ { value: '2018/11/11' } ]" />

禁止滑动

<AtCalendar :isSwiper="false" />

垂直滑动

<AtCalendar isVertical />

范围选择

<AtCalendar isMultiSelect currentDate="{start: '2018/10/28', end: '2018/11/11'}"/>

有效时间组

<AtCalendar :validDates="[ { value: '2020/01/01' } ]" />

AtCalendar 参数

type DateArg = string | number | Date

interface SelectDate {
  end?: DateArg
  start: DateArg
}
参数说明类型默认值
currentDate当前的时间DateArg | SelectDateDate.now()
minDate最小的可选时间DateArg-
maxDate最大的可选时间DateArg-
isSwiper是否可以滑动booleantrue
marks需要标记的时间Array<{'{ value: DateArg }'}>[]
validDates需要标记的有效时间Array<{'{ value: DateArg }'}>[]
format日期格式stringYYYY-MM-DD
monthFormat月份格式stringYYYY年MM月
hideArrow是否隐藏箭头booleanfalse
isVertical是否垂直滑动booleanfalse
isMultiSelect是否范围选择booleanfalse

AtCalendar 事件

参数说明类型默认值
onClickPreMonth点击箭头去上一个月的时候触发() => void-
onClickNextMonth点击箭头去下一个月的时候触发() => void-
onDayClick点击日期时候触发(item: {'{ value: string }'}) => void-
onDayLongClick长按日期时触发(item: {'{ value: string }'}) => void-
onMonthChange月份改变时触发(value: string) => void-
onSelectDate选中日期时候触发(value: SelectDate) => void-