/XCX-Plugins

小程序组件

Primary LanguageJavaScript

XCX-Plugins

小程序组件

使用方法

1.声明组件

下载代码,将components文件夹拷贝至项目根目录(与app.json平级),在app.json中声明需要使用的插件,这里的声明是全局的,pages下的页面都能直接用,也可以在某一个page对应的json文件中单独声明。

{
  "pages": [
    "pages/demo/calendar"
  ],
  "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle": "black"
  },
  "usingComponents": {
    "calendar": "/components/calendar/index"
  },
  "sitemapLocation": "sitemap.json"
}

*组件的名字可以自定义,如calendar可以改成calendar666,页面内使用时保持一致即可。

2.使用组件

最简单的方式:

<calendar />

带有一些默认设置的方式

<calendar bindOnDayClick="onDayClick" days-style='{{daysStyle}}' />

3.可设置属性

  • calendar
属性名称 类型 默认值 说明
mode String normal 模式:
normal:常规;
picker: 下拉选取日期
pickerRange: 下拉选择区间
placeholder String 提示语
title String xxx年x月 日历标题,如设定值,在月份切换时需要自己设置title值
weekdays Array ['日', '一', '二', '三', '四1', '五', '六'] 如自定义,数组长度需为7
language String ZH 语言:
ZH:中文
EN:英语,不同语言,年月和星期显示不同
selectedMode String round 被选中日期背景模式:
round:圆形
square方形
showMoreDays Boolean true 是否显示非本月日期
year Number 当前年份 年份
month Number 当前月份 月份,注意:此处值从1开始,1-12
selectedDate String 当天 被选中日期,格式yyyy-MM-DD
daysStyle Array 指定日期样式数组,如:[{id: '2019-07-30',style: 'color: red;'}]会改变2019-07-30的日期颜色,此处是style,可以自由设置属性,会改变整个单元格样式
dotDays Array 指定日期显示标记点,如:[ '2019-10-30']
dotColor String red 点颜色

示例图片:

常规模式使用示例.png 自定义日期样式.png 日期范围选择.png