VHC - 一款基于 vue3 的移動(dòng)端日期次询、時(shí)間選擇插件 功能豐富 文檔細(xì)致


文檔地址

https://hxkj.vip/calendar/

倉庫地址

其他版本

API

Props

屬性 說明 類型 默認(rèn) 是否必傳
visible 控制日歷組件的顯示或隱藏,需使用 v-model:visible Boolean false
scroll-change-date 控制滑動(dòng)的時(shí)候是否修改選中的日期 Boolean true
model 日歷組件以哪種形式展示。inline:內(nèi)聯(lián)的方式。dialog:彈窗的方式 String inline
default-datetime 指定默認(rèn)時(shí)間窄坦。 Date 當(dāng)前時(shí)間
min-date 指定日歷最小日期范圍,設(shè)置之后只能在該范圍內(nèi)滑動(dòng)日歷凳寺。 Date --
max-date 指定日歷最大日期范圍鸭津,設(shè)置之后只能在該范圍內(nèi)滑動(dòng)日歷。 Date --
format 確認(rèn)日期時(shí)肠缨,回調(diào)事件返回的日期格式逆趋。如“YY/MM/DD hh:mm” 、“YY 年 MM 月第 DD 天晒奕,當(dāng)前時(shí)間 hh 時(shí) mm 分”闻书、“MM DD,YY at hh:mm F” String YY/MM/DD hh:mm
week-start 以星期幾作為日歷每一周的起始星期∧曰郏可選['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'] String sunday
picker-type 選擇器類型 datetime:日期+時(shí)間 date:日期 time:時(shí)間 String datetime
show-today-button 是否顯示返回今日按鈕 Boolean true
show-week-view 是否以周視圖展示組件 Boolean false
show-arrow 是否顯示周月切換時(shí)的指示箭頭(日歷下方的小箭頭)魄眉,當(dāng) model 等于 inline 時(shí)生效 Boolean false
show-action 是否顯示日歷組件操作欄(標(biāo)題欄) Boolean true
show-not-current-month-day 是否展示日歷中的非本月日期(灰色部分日期) Boolean true
disabled-week-view 禁用周視圖(設(shè)置為 true 后,無法上下滑動(dòng)進(jìn)行周/月切換) Boolean false
disabled-date 設(shè)置日期的禁用狀態(tài)闷袒,參數(shù)為當(dāng)前日期坑律,要求返回 Boolean (禁用該日期需返回 true) Function ---
disabled-time 設(shè)置時(shí)間的禁用狀態(tài),參數(shù)為當(dāng)前日期囊骤,要求返回 Boolean (禁用該時(shí)間需返回 true) Function ---
disabled-scroll 設(shè)置日歷的禁止滑動(dòng)方向晃择。可選['left', 'right', 'up', 'down', 'horizontal', 'vertical', true, false] 也物」溃可取其一控制單個(gè)方向,其中 truefalse 控制所有方向滑蚯。 Boolean, String false
mark-date 需要被標(biāo)記的日期浪蹂,可按不同顏色不同標(biāo)記類型分組標(biāo)記(不分組默認(rèn)藍(lán)色)。如:[{color: 'red',date: ['2019/02/25']},{color: 'blue',type: 'dot',date: ['2019/01/20']},'2019/03/20'] Array []
minute-step 間隔時(shí)間。(分鐘的步長) Number 1
lang 選擇的語言版本乌逐〗呋洌可選值:['CN', 'EN'] String CN
change-year-fast 是否支持點(diǎn)擊操作欄(標(biāo)題欄)的日期區(qū)域快速切換年份 Boolean false
theme-color 用于修改日歷主題色 { 'main-color': string; 'bg-color': string; 'main-font-color': string; 'vice-font-color': string; 'disabled-bg-color': string; 'disabled-font-color': string;} ---
disabled-class-name 日期被禁用時(shí)的 className。用于修改日期被禁用時(shí)的默認(rèn)樣式 String ---
not-current-month-day-class-name 非當(dāng)前展示月份日期的 className(例如日歷前面幾天與后面幾天灰色部分)浙踢。用于修改非當(dāng)前展示月份日期的默認(rèn)樣式 String ---
checked-day-class-name 日期被選中時(shí)的 className绢慢。用于修改日期被選中時(shí)的默認(rèn)樣式 String ---
today-class-name 當(dāng)天日期的 className。用于修改當(dāng)天日期的默認(rèn)樣式 String ---
first-day-of-month-class-name 每月第一天的 className洛波。用于修改每月第一天的默認(rèn)樣式 String ---

事件 Event

事件名稱 說明 參數(shù)
change 日期改變時(shí)胰舆,觸發(fā)該事件。(返回的日期格式取決于 format 屬性) (date: 日期改變時(shí)蹬挤,選中的日期)
confirm 點(diǎn)擊確認(rèn)按鈕時(shí)缚窿,觸發(fā)該事件,dialog 模式中才有該按鈕焰扳。(返回的日期格式取決于 format 屬性) (date: 點(diǎn)擊確認(rèn)按鈕時(shí)倦零,選中的日期)
click 點(diǎn)擊日期時(shí),觸發(fā)該事件吨悍。(返回的日期格式取決于 format 屬性) (date: 當(dāng)前點(diǎn)擊的日期)
touchstart 日歷滑動(dòng) start 事件扫茅,同于原生該事件。 (event: touch 事件)
touchmove 日歷滑動(dòng) move 事件育瓜,同于原生該事件葫隙。 (event: touch 事件)
touchend 日歷滑動(dòng) end 事件,同于原生該事件躏仇。 (event: touch 事件)
slidechange 日歷滑動(dòng)的方向恋脚。返回值:right、left焰手、up糟描、down 。 (direction: 滑動(dòng)的方向)
calendarTypeChange 日歷展示類型切換時(shí)觸發(fā)书妻。返回值:date蚓挤、month顶籽、year癣缅、yearRange 艇肴。 (type: 日歷展示面板類型)

插槽 Slot

name 說明
day 自定義日期內(nèi)容。例如可用于添加農(nóng)歷之類的崇呵。配合自定義 className 使用,效果更佳馅袁!參數(shù)為 { date, extendAttr }域慷,其中 extendAttr 參數(shù)包含 isMarked(該日期是否被標(biāo)記)、isDisabledDate(該日期是否被禁用)、isToday(該日期是否為今天)犹褒、isChecked(該日期是否被選中)抵窒、isCurrentMonthDay(該日期是否為本月日期)、isFirstDayOfMonth(該日期是否為當(dāng)月第一天)叠骑,可用于一些特殊需求
week 自定義星期內(nèi)容李皇。例如可用于自定義星期樣式等等。參數(shù)為 { week }
arrow 自定義周月切換時(shí)的指示箭頭宙枷。參數(shù)為 { show }掉房,show: 類型為 Boolen,表示當(dāng)前是否為周視圖
today 自定義 "今天" 按鈕文字內(nèi)容以及樣式
confirm 自定義 "確定" 按鈕文字內(nèi)容以及樣式
action 自定義操作欄(標(biāo)題欄)內(nèi)容以及樣式

方法 Method

方法名稱 說明
lastMonth 切換日歷到上一月
nextMonth 切換日歷到下一月
lastWeek 切換日歷到上一周
nextWeek 切換日歷到下一周
today 返回今日慰丛。當(dāng)今日被禁用時(shí)卓囚,不生效
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市诅病,隨后出現(xiàn)的幾起案子哪亿,更是在濱河造成了極大的恐慌,老刑警劉巖贤笆,帶你破解...
    沈念sama閱讀 216,843評(píng)論 6 502
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件蝇棉,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡苏潜,警方通過查閱死者的電腦和手機(jī)银萍,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,538評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來恤左,“玉大人贴唇,你說我怎么就攤上這事》纱” “怎么了戳气?”我有些...
    開封第一講書人閱讀 163,187評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長巧鸭。 經(jīng)常有香客問我瓶您,道長,這世上最難降的妖魔是什么纲仍? 我笑而不...
    開封第一講書人閱讀 58,264評(píng)論 1 292
  • 正文 為了忘掉前任呀袱,我火速辦了婚禮,結(jié)果婚禮上郑叠,老公的妹妹穿的比我還像新娘夜赵。我一直安慰自己,他們只是感情好乡革,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,289評(píng)論 6 390
  • 文/花漫 我一把揭開白布寇僧。 她就那樣靜靜地躺著摊腋,像睡著了一般。 火紅的嫁衣襯著肌膚如雪嘁傀。 梳的紋絲不亂的頭發(fā)上兴蒸,一...
    開封第一講書人閱讀 51,231評(píng)論 1 299
  • 那天,我揣著相機(jī)與錄音细办,去河邊找鬼橙凳。 笑死,一個(gè)胖子當(dāng)著我的面吹牛蟹腾,可吹牛的內(nèi)容都是我干的痕惋。 我是一名探鬼主播,決...
    沈念sama閱讀 40,116評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼娃殖,長吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼值戳!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起炉爆,我...
    開封第一講書人閱讀 38,945評(píng)論 0 275
  • 序言:老撾萬榮一對(duì)情侶失蹤堕虹,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后芬首,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體赴捞,經(jīng)...
    沈念sama閱讀 45,367評(píng)論 1 313
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,581評(píng)論 2 333
  • 正文 我和宋清朗相戀三年郁稍,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了赦政。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,754評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡耀怜,死狀恐怖恢着,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情财破,我是刑警寧澤掰派,帶...
    沈念sama閱讀 35,458評(píng)論 5 344
  • 正文 年R本政府宣布,位于F島的核電站左痢,受9級(jí)特大地震影響靡羡,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜俊性,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,068評(píng)論 3 327
  • 文/蒙蒙 一略步、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧定页,春花似錦纳像、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,692評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至宫峦,卻和暖如春岔帽,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背导绷。 一陣腳步聲響...
    開封第一講書人閱讀 32,842評(píng)論 1 269
  • 我被黑心中介騙來泰國打工犀勒, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人妥曲。 一個(gè)月前我還...
    沈念sama閱讀 47,797評(píng)論 2 369
  • 正文 我出身青樓贾费,卻偏偏與公主長得像,于是被迫代替她去往敵國和親檐盟。 傳聞我的和親對(duì)象是個(gè)殘疾皇子褂萧,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,654評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容