功能完善的小程序日歷組件的實現(xiàn)
小程序日歷組件
日歷組件，表單組件絕逼是前端開發(fā)的一個噩夢，尤其要做好一個旅游項目的日歷，變態(tài)需求特別多，要在小程序中實現(xiàn)攜程app的日歷，還要兼顧性能問題。
- 自定義橫向/縱向日歷
- 自定義區(qū)間大小
- 自定義日期內(nèi)容
- 指定節(jié)假日
- 支持跨月顯示
難點
- 懶加載保證渲染性能
- 通過配置實現(xiàn)縱向日歷和橫向日歷
- 陽歷節(jié)日與農(nóng)歷節(jié)日與節(jié)氣
- 交互，尤其是區(qū)域選擇的交互
示例代碼
https://github.com/webkixi/aotoo-xquery => pages/calendar
配置說明
wxml
<ui-calendar dataSource="{{config}}" />js
基本用法
const Pager = require('../../components/aotoo/core/index')
Pager({
data: {
config: {
$$id: 'calendar',
mode: 1, // 縱向日歷
type: 'range', // 區(qū)域選擇
tap: 'onTap', // page響應事件
total: 365, // 定義從今天開始一年事件
rangeCount: 28, // 區(qū)選區(qū)間28天
festival: true, // 開啟節(jié)假日顯示
value: ['2019-12-24', '2020-01-05'], // 默認值
methods: {
// 響應 tap事件
onTap(e, param, inst) {
if (param.range === 'start') {
inst.update({dot: [{title: '入住'}]})
}
if (param.range === 'end') {
inst.update({dot: [{title: '離店'}]})
setTimeout(() => {
Pager.alert('離店，跳回頁面')
}, 1000);
}
console.log(param);
}
}
}
}
})$$id
{String} 配置實例的Id
mode
{Number} 設置日歷的展示模式，1=縱向日歷 2=橫向日歷
type
{Number} single=單選日歷， range=選擇區(qū)間， multiple=多選日歷
total
{Number} 設置日歷從今天開始起需要跨多少天，如 180天，或者365天
start
{String} 設置起始日期，如：'2020-06-05'
date
{Object|Function} 定義附加日期內(nèi)容
disable
{Boolean} 設置全局無效，所有日期均不能交互，權重低于單個日期設置的disable
rangeCount
{Number} 當type === 'range'時，rangeCount為區(qū)間大小，意味著區(qū)間允許選擇多少天
rangeMode
{Number} 當正在做日期區(qū)間選擇時，是否允許顯示angeCount之外的日期 1=顯示， 2=不顯示
tap
{String} 響應日期元素的tap事件
value
{Array} 默認選中的日期，允許數(shù)組為空，如果type='single'則應該設置如['2020-06-05']，type='range'應該設置如['2020-06-03', '2020-06-05'], type='multiple'時，數(shù)組允許多值
data
{Array} 該數(shù)據(jù)會自動計算日期跨度數(shù)量(允許跨年設置)，如果設置了該數(shù)據(jù)，則total無效，如設置為['2019-11-05', '2021-11-05']，自動計算日期為730天
festival
{Boolean|Array} 設置日歷假期顯示，支持顯示指定假期
toolbox
{Object} 日歷的擴展配置，允許設置一些高級功能，如日歷是否允許跨月，特殊的range算法等等
toolbox.header
{Boolean} 是否顯示日歷的頭部，一般用于橫向日歷時為true
toolbox.monthHeader
{Boolean} 是否顯示日歷的月頭部，一般在縱向日歷時為true
toolbox.rangeEdge
{Function} 默認值null，type='range'時，自定義range選擇算法
toolbox.discontinue
{Boolean} 默認false，當日歷有data數(shù)組構建時，缺少數(shù)據(jù)的月份會被忽略
如何設置
設置橫向、縱向日歷
let calenderConfig = {
$$id: 'calendar',
mode: 2, // 1，縱向日歷 2，橫向日歷
type: 'single', // single：單選 range: 區(qū)間選擇 multiple：多選
tap: 'onTap', // 回調(diào)事件
total: 180, // 所有日期選擇天數(shù)
methods: { // 響應方法
onTap(e, param, inst) {
console.log(param);
}
}
}設置區(qū)間選擇日歷
該示例配置為仿攜程的功能設置
let calendarConfig = {
$$id: 'calendar', //實例id
mode: 1, // 縱向日歷
type: 'range', // 區(qū)間選擇日歷
tap: 'onTap', // tap響應方法
total: 365, // 指定日歷從今天開始總天數(shù)
rangeCount: 28, // 區(qū)間范圍
rangeMode: 1, // 區(qū)間選擇是否隱藏非區(qū)間的月份
festival: true, // 是否顯示節(jié)假日
value: ['2020-04-03', '2020-04-09'], // 默認值
methods: {
// 定義響應方法
onTap(e, param, inst) {
if (param.range === 'start') { // 第一次點擊時
inst.update({dot: [{title: '入住'}]})
}
if (param.range === 'end') { // 第二次點擊時
inst.update({dot: [{title: '離店'}]})
}
console.log(param);
}
}
}設置多選日歷
支持選中多個日期
let calenderConfig = {
$$id: 'calendar',
mode: 2,
type: 'multiple', // single：單選 range: 區(qū)間選擇 multiple：多選
tap: 'onTap', // 回調(diào)事件
total: 180, // 所有日期選擇天數(shù)
value: ['2020-04-03', '2020-04-09', '2020-04-10'],
methods: { // 響應方法
onTap(e, param, inst) {
console.log(param);
}
}
}據(jù)已知日期自動構建
此例中total無效，由兩個給定的日期構建了三個月的日歷
let calenderConfig = {
$$id: 'calendar',
mode: 2, // 1，縱向日歷 2，橫向日歷
type: 'single', // single：單選 range: 區(qū)間選擇 multiple：多選
tap: 'onTap', // 回調(diào)事件
total: 180, // 所有日期選擇天數(shù)，此例中無效
data: [{"date":"2020-04-03"}, {"date":"2020-06-03"}],
methods: { // 響應方法
onTap(e, param, inst) {
console.log(param);
}
}
},根據(jù)已知日期自動構建，忽略無數(shù)據(jù)月份
此例中total無效， 由兩個給定的日期構建了三個月的日歷
let calenderConfig = {
$$id: 'calendar',
mode: 2, // 1，縱向日歷 2，橫向日歷
type: 'single', // single：單選 range: 區(qū)間選擇 multiple：多選
tap: 'onTap', // 回調(diào)事件
total: 180, // 所有日期選擇天數(shù)，此例中無效
data: [{"date":"2020-04-03"}, {"date":"2020-06-03"}],
toolbox: {
discontinue: true // 允許構建跨月日歷
},
methods: { // 響應方法
onTap(e, param, inst) {
console.log(param);
}
}
},構建節(jié)假日日歷
允許指定節(jié)假日，指定節(jié)假日內(nèi)容
festival: true
顯示所有組件自帶節(jié)日
festival: ['元旦節(jié)', '情人節(jié)', '勞動節(jié)', '冬至']
顯示指定假日
festival: [{title: '春節(jié)', content: {dot: ['新年好']}}]
顯示指定節(jié)日，并附加內(nèi)容
let calenderConfig = {
$$id: 'calendar',
mode: 1, // 1，縱向日歷 2，橫向日歷
type: 'single', // single：單選 range: 區(qū)間選擇 multiple：多選
tap: 'onTap', // 回調(diào)事件
data: [{"date":"2020-09-03"}, {"date":"2020-12-28"}],
festival: ['教師節(jié)', '圣誕節(jié)'],
toolbox: {
discontinue: true // 允許忽略無數(shù)據(jù)月份
},
methods: { // 響應方法
onTap(e, param, inst) {
console.log(param);
}
}
},自定義日期內(nèi)容
自定義日期內(nèi)容有兩種方法
在data數(shù)據(jù)配置中加入'dot'數(shù)組屬性
config.data = [{date: '2020-03-03', content: {dot: ['內(nèi)容']}}] 在date屬性中配置
// 配置所有日期的附加內(nèi)容
config.date = {dot: ['自定義內(nèi)容']}
// 指定日期內(nèi)容配置
config.date = function(param){
// 通過param的屬性寫邏輯 param.date, param.year, param.month, param.day ...
if (param.date === '2020-8-13') {
param.dot = ['附加內(nèi)容']
return param
}
}設置示例
let calenderConfig = {
$$id: 'calendar',
mode: 2, // 1，縱向日歷 2，橫向日歷
type: 'single', // single：單選 range: 區(qū)間選擇 multiple：多選
tap: 'onTap', // 回調(diào)事件
date: function(param){
if (param.month === 12 && param.day === 26) {
param.dot = ['誕辰']
return param
}
if (param.month === 9 && param.day === 10) {
param.dot = [
{title: '生日', itemStyle: 'font-size: 11px; color: blue;'},
{title: '騙你的', itemStyle: 'font-size: 11px; color: #666'},
]
return param
}
if (param.month === 9 && param.day === 20) {
param.dot = [
{title: '無效日期', itemStyle: 'font-size: 12px; color: red;'},
{title: '不能交互', itemStyle: 'font-size: 12px; color: #666;'},
]
param.disable = true
return param
}
},
toolbox: {
discontinue: true
},
data: [{"date":"2020-09-03"}, {"date":"2020-12-28"}],
methods: { // 響應方法
onTap(e, param, inst) {
console.log(param);
}
}
},示例小程序
到此這篇關于功能完善的小程序日歷組件的實現(xiàn)的文章就介紹到這了,更多相關小程序日歷組件內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
優(yōu)化javascript的執(zhí)行效率一些方法總結
本文為大家介紹下優(yōu)化javascript的執(zhí)行效率一些方法，個人感覺還不錯，感興趣的朋友可以了解下2013-12-12
微信小程序在其他頁面監(jiān)聽globalData中值的變化
這篇文章主要給大家介紹了關于微信小程序如何在其他頁面監(jiān)聽globalData中值的變化的相關資料，文中通過示例代碼介紹的非常詳細，對大家學習或者使用微信小程序具有一定的參考學習價值，需要的朋友們下面來一起學習學習吧2019-07-07
js如何調(diào)用qq互聯(lián)api實現(xiàn)第三方登錄
這篇文章主要介紹了js如何調(diào)用qq互聯(lián)api實現(xiàn)第三方登錄,需要的朋友可以參考下2014-03-03
這篇文章主要介紹了JavaScript中的變量提升和函數(shù)提升，在js中對變量進行操作后打印值經(jīng)常會出現(xiàn)undefined的現(xiàn)象。其實原因是因為js中有一個叫做變量提升的功能2022-07-07
js 聲明數(shù)組和向數(shù)組中添加對象變量的簡單實例
下面小編就為大家?guī)硪黄猨s 聲明數(shù)組和向數(shù)組中添加對象變量的簡單實例。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2016-07-07
在日常開發(fā)中，經(jīng)常遇到針對字符串的替換、截取，知識點比較碎容易混淆，所以本文為大家整理了一下相關的知識點，希望對大家有所幫助2023-05-05
這篇文章主要介紹了 JavaScript 深層克隆對象的相關資料,并附實例代碼，幫助大家學習參考這部分知識，需要的朋友可以參考下2016-11-11
分步解析JavaScript實現(xiàn)tab選項卡自動切換功能
這篇文章主要分步解析JavaScript實現(xiàn)tab選項卡自動切換功能代碼，具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-01-01
js實現(xiàn)刷新頁面后回到記錄時滾動條的位置【兩種方案可選】
本文主要介紹了頁面的div中有滾動條，js實現(xiàn)刷新頁面后回到記錄時滾動條的位置的兩種方案，需要的朋友可以看下2016-12-12
這篇文章主要介紹了用js編寫的簡單的計算器代碼程序，非常具有實用性,感興趣的小伙伴可以參考下2015-08-08