适用于微信小程序的日历

git地址

添加插件到自己的小程序

1、在微信小程序管理后台——设置——第三方服务,按 AppID(wx92c68dae5a8bb046)搜索到该插件并申请授权。

2、在要使用该插件的小程序 app.json 文件中引入插件声明。

"plugins": {"calendar": {"version":"1.1.3","provider":"wx92c68dae5a8bb046"}}

3、在需要使用到该插件的小程序页面的 JSON 配置文件中,做以下配置:

{"usingComponents": {"calendar":"plugin://calendar/calendar"}}

4、在相应的 HTML 页面中添加以下语句即可完成插件的嵌入。

5、添加插件后效果如图:

说明:默认的用法,将具备以下样式特点:

显示当前月份的日历;

显示日历标题、显示上下月按钮;

显示周标题,周标题默认为 en 类型,即英文字母;

不显示非当前月的日期;

不显示农历;

插件占据文档流的整块宽度,即 width:100%。

日历属性接口文档

calendar 日历

属性名类型默认值说明

yearNumber当前年份当前公历年份

monthNumber当前月份当前公历月份

dayNumber当前日期当前公历日期

start-dateString日历的起始年份格式为YYYY-MM

end-dateString日历的结束年份格式为YYYY-MM

headerBooleantrue是否显示标题

nextBooleantrue是否显示下个月按钮

prevBooleantrue是否显示上个月按钮

show-more-daysBooleanfalse是否显示非当前月的日期

weeksBooleantrue是否显示周标题

weeks-typeStringen周标题类型

days-colorArray[]设置各日期字体颜色、背景颜色

cell-sizeNumber30设置日期单元格大小

active-typeStringrounded设置日期背景形状

lunarBooleanfalse是否显示农历

注1:日历的起始年月最小为1900-01

注2:日历的结束年月最大为2099-12

注3:日期单元格大小单位为px

weeks-type有效值

值说明

en显示为:S,M,T,W,T,F,S

full-en显示为:Sun, Mon, Tue, Wed, Thu, Fri, Sat

cn显示为:日,一,二,三,四,五,六

active-type有效值

值说明

rounded显示为圆形背景

square显示为方形背景

days-color数组项构成

days-color数组的每一项为一个对象,对象有4个属性,意义如下:

属性名说明

month要标记的日期所属月份,有效值有prev(上个月),current(当前月),next(下个月)

day要标记的日期

color日期文字的颜色,格式为“#HEX”或CSS颜色名

background日期单元格的颜色,格式为“#HEX”或CSS颜色名

日历事件用法

1、监听点击下个月事件:nextMonth

(1)wxml文件

(2)js文件

Page({next:function(event) {console.log(event.detail);  }})

假设当前是2018年4月,点击下个月按钮,在控制台会打印出:

{currentMonth:5,currentYear:2018,prevMonth:4prevYear:2018}

2、监听点击上个月事件:prevMonth

(1)wxml文件

(2)js文件

Page({prev:function(event) {console.log(event.detail);  }})

假设当前是2018年4月,点击上个月按钮,在控制台会打印出:

{currentMonth:3,currentYear:2018,prevMonth:4prevYear:2018}

3、监听点击日历标题日期选择器事件:dateChange

(1)wxml文件

(2)js文件

Page({dateChange:function(event) {console.log(event.detail);  }})

假设当前是2018年4月,选择了2015年7月,在控制台会打印出:

{currentMonth:7,currentYear:2015,prevMonth:4prevYear:2018}

4、监听点击日历具体某一天的事件:dayClick

(1)wxml文件

(2)js文件

Page({dayClick:function(event) {console.log(event.detail);  }})

假设当前是2018年4月,点击了4月4日这一天,在控制台会打印出:

{background:"transparent"color:""#4a4f74""day:4lunarDay:"十九"lunarMonth:"二月"month:4year:2018}

自定义日历样式

1、修改日历背景颜色

组件本身是无背景色(透明)的,calendar-style 样式位于组件的根节点。假设要更改日历的背景色,除了在组件的父级容器设置背景色外,也可以通过该样式类进行配置来达到相应的效果。

以上图为例,想要实现图中的背景效果,在wxml文件里指定 calendar-style 的外部样式类为 calendar:

在wxss文件新增 background-color 属性更改背景颜色等:

.calendar{background-color:#eeedff;padding-top:10px;}

2、修改日历标题样式

header-style样式类位于组件的日历标题。对该组件进行配置,可以改变当前年月,上下月按钮的外观和背景。

在上面例子的基础上,我们在 wxml 文件中新增代码:

在 WXSS 文件中添加 header 样式:

.header{font-size:large;/*修改了标题文字和按钮的大小*/color:#605eac;/*修改了标题文字和按钮的颜色*/}

3、修改日历主面板

board-style 样式类位于日历组件的主面板,包含了周标题和日期部分。对该组件进行配置,可以改变周标题的样式和日期面板的样式。

紧跟上面的例子,我们对 wxml 文件加多一行代码。

在 wxss 文件中新增 board 样式

.board{background-color:#dddcff;color:white;}

效果如下:

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,902评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,037评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,978评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,867评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,763评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,104评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,565评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,236评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,379评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,313评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,363评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,034评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,637评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,719评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,952评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,371评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,948评论 2 341

推荐阅读更多精彩内容