更新记录
1.0.0(2024-09-19) 下载此版本
此组件是官网组件uni-calendar为基础的升级版,用法完全跟uni-calendar用法一样,只不过是 加了开始和结束时间的展示
平台兼容性
Vue2 | Vue3 |
---|---|
√ | × |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
× | × | × | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
× | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | × | × | × |
Calendar 日历
组件名:uni-calendar 代码块:
uCalendar
日历组件
注意事项 为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。
- 本组件农历转换使用的js是 @1900-2100区间内的公历、农历互转
- 仅支持自定义组件模式
date
属性传入的应该是一个 String ,如: 2019-06-27 ,而不是 new Date()- 通过
insert
属性来确定当前的事件是 @change 还是 @confirm 。理应合并为一个事件,但是为了区分模式,现使用两个事件,这里需要注意- 弹窗模式下无法阻止后面的元素滚动,如有需要阻止,请在弹窗弹出后,手动设置滚动元素为不可滚动
安装方式
本组件符合easycom规范,HBuilderX 2.5.5
起,只需将本组件导入项目,在页面template
中即可直接使用,无需在页面中import
和注册components
。
如需通过npm
方式使用uni-ui
组件,另见文档:https://ext.dcloud.net.cn/plugin?id=55
基本用法
在 template
中使用组件
<view>
<uni-calendar
:insert="true"
:lunar="true"
:start-date="'2019-3-2'"
:end-date="'2019-5-20'"
@change="change"
/>
</view>
通过方法打开日历
需要设置 insert
为 false
<view>
<uni-calendar
ref="calendar"
:insert="false"
@confirm="confirm"
/>
<button @click="open">打开日历</button>
</view>
export default {
data() {
return {};
},
methods: {
open(){
this.$refs.calendar.open();
},
confirm(e) {
console.log(e);
}
}
};
API
Calendar Props
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
date | String | - | 自定义当前时间,默认为今天 |
lunar | Boolean | false | 显示农历 |
startDate | String | - | 日期选择范围-开始日期 |
endDate | String | - | 日期选择范围-结束日期 |
range | Boolean | false | 范围选择 |
insert | Boolean | false | 插入模式,可选值,ture:插入模式;false:弹窗模式;默认为插入模式 |
clearDate | Boolean | true | 弹窗模式是否清空上次选择内容 |
selected | Array | - | 打点,期待格式[{date: '2019-06-27', info: '签到', data: { custom: '自定义信息', name: '自定义消息头',xxx:xxx... }}] |
showMonth | Boolean | true | 是否显示月份为背景 |
Calendar Events
事件名 | 说明 | 返回值 |
---|---|---|
open | 弹出日历组件,insert :false 时生效 |
- |
组件示例
点击查看:https://hellouniapp.dcloud.net.cn/pages/extUI/calendar/calendar
此组件是官网组件uni-calendar为基础的升级版,用法完全跟uni-calendar用法一样,只不过是 加了开始和结束时间的展示