## Calendar 日历 > 代码块: `uCalendar` 日历组件 > 为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。 > - 本组件农历转换使用的js是 [@1900-2100区间内的公历、农历互转](https://github.com/jjonline/calendar.js) > - 仅支持自定义组件模式 > - `date`属性传入的应该是一个 String ,如: 2019-06-27 ,而不是 new Date() > - 通过 `insert` 属性来确定当前的事件是 @change 还是 @confirm 。理应合并为一个事件,但是为了区分模式,现使用两个事件,这里需要注意 > - 弹窗模式下无法阻止后面的元素滚动,如有需要阻止,请在弹窗弹出后,手动设置滚动元素为不可滚动 ### 安装方式 本组件符合[easycom](https://uniapp.dcloud.io/collocation/pages?id=easycom)规范,`HBuilderX 2.5.5`起,只需将本组件导入项目,在页面`template`中即可直接使用,无需在页面中`import`和注册`components`。 如需通过`npm`方式使用`uni-ui`组件,另见文档:[https://ext.dcloud.net.cn/plugin?id=55](https://ext.dcloud.net.cn/plugin?id=55) ### 基本用法 在 ``template`` 中使用组件 ```html ``` ### 通过方法打开日历 需要设置 `insert` 为 `false` ```html ``` ```javascript 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` 时生效|- |