摘要:演示地址希望大家能給個功能期望這個目前僅實現了一些常用的功能選擇時間這話說得有點多余最大最小時間限制中英文切換其實也就星期和月份需要切換可以以形式使用,也可在瀏覽器環境中直接使用沒了。。。
前言
寫插件是很有意思,也很鍛煉人,因為這個過程中能發現許多的細節問題。在前端發展的過程中,jQuery無疑是一個重要的里程碑,圍繞著這個優秀項目也出現了很多優秀的插件可以直接使用,大大節省了開發者們的時間。jQuery最重要的作用是跨瀏覽器,而現在瀏覽器市場雖不完美,但已遠沒有從前那么慘,數據驅動視圖的思想倍受歡迎,大家開始使用前端框架取代jQuery,我個人比較喜歡Vue.js,所以想試著用Vue.js寫一個組件出來。
為了發布到npm上,所以給項目地址改名字了,但是內部代碼沒有改,使用方法比之前方便。
Demo演示: Here
GitHub地址: Here希望大家能給個star
這個datepicker目前僅實現了一些常用的功能:
選擇時間(這話說得有點多余)
最大/最小時間限制
中/英文切換(其實也就星期和月份需要切換)
可以以.vue形式使用,也可在瀏覽器環境中直接使用
沒了。。。
目錄結構萬事的第一步依然是創建項目,只是單一組件,結構并不復雜,Datepicker.vue是最重要的組件文件,dist是webpack的輸出文件夾,index.js是webpack打包的入口文件,最后是webpack的配置文件,用來對我們的庫文件進行打包用的。因此項目結構就是這樣:
. ├── Datepicker.vue ├── LICENSE ├── README.md ├── dist │?? └── vue-datepicker.js ├── index.js ├── package.json └── webpack.config.js從Datepicker.vue入手
以.vue的方式寫Vue組件是一種特殊寫法,每個Vue文件包括template, script, style三部分,template最好不要成為片段實例,所以最外層先套一層div,當做整個組件的根元素。一個datepicker一般由兩部分組成,一個用來顯示日期的input框,一個用來選擇日期的panel,因為我發現input在移動端會自動喚起鍵盤,所以沒有使用input,直接用了div模擬,通過點擊事件決定panel的顯隱。value是最終的結果,需要和父組件通信,所以將value寫成了prop,在父組件中使用value.sync="xxx",datepicker的value就和父組件的xxx雙向綁定了。
export default { data () { return { panelState: false //初始值,默認panel關閉 } }, props: { value: String } } 渲染日期列表 一個月最少是28天,如果把周日排在開頭,那么最少(1號恰好是周日)需要4行,但是每個月天數30,31居多,而且1號又不一定是周日,我索性干脆按最多的情況設計了,共6行,當月日期沒填滿的地方用上個月或下個月的日期補齊,這樣就方便計算了,而且切換月份時候panel高度不會變化。日期列表的數組需要動態計算,Vue提供了computed這個屬性,所以直接將日期列表dateList寫成計算屬性。我的方法是將日期列表固定為長度為42的數組,然后將本月,上個月,下個月的日期依次填充。
computed: { dateList () { //獲取當月的天數 let currentMonthLength = new Date(this.tmpMonth, this.tmpMonth + 1, 0).getDate() //先將當月的日期塞入dateList let dateList = Array.from({length: currentMonthLength}, (val, index) => { return { currentMonth: true, value: index + 1 } }) //獲取當月1號的星期是為了確定在1號前需要插多少天 let startDay = new Date(this.year, this.tmpMonth, 1).getDay() //確認上個月一共多少天 let previousMongthLength = new Date(this.year, this.tmpMonth, 0).getDate() } //在1號前插入上個月日期 for(let i = 0, len = startDay; i < len; i++){ dateList = [{previousMonth: true, value: previousMongthLength - i}].concat(dateList) } //補全剩余位置 for(let i = 0, item = 1; i < 42; i++, item++){ dateList[dateList.length] = {nextMonth: true, value: i} } return dateList }這里用Array.from來初始化了一個數組,傳入一個Array Like,轉化成數組,在拼接字符串時候采用了arr[arr.length]和[{}].concat(arr)這種方式,因為在JsTips上學到這樣做性能更好,文章的最后會貼出相關鏈接。
這樣,日期列表就構建好了,在template中使用v-for循環渲染出來
樣式上就可以自己發揮了,怎么喜歡怎么寫。需要注意的是循環日期可能會出現上個月或這個月的日期,我通過previuosMonth,currentMonth和nextMonth分別做了標記,對其他功能提供判斷條件。
年份和月份的列表都是差不多的道理,年份列表的初始值我直接寫在了data里,以當前年份為第一個,為了和月份保持一致,每次顯示12個,都通過v-for渲染。data () { return { yearList: Array.from({length: 12}, (value, index) => new Date().getFullYear() + index) } }選擇日期功能選擇順序是:年 -> 月 -> 日,所以我們可以通過一個狀態變量來控制panel中顯示的內容,綁定適合的函數切換顯示狀態。
選擇日期的方法就不細說了,在selectYear,selectMonth中對年份,月份變量賦值,再分別將panelType推向下一步就實現了日期選擇功能。
不過在未選擇完日期之前,你可能不希望當前年月的真實值發生變化,所以在這些方法中可先將選擇的值賦給一個臨時變量,等到seletDate的時候再一次性全部賦值。selectMonth (month) { if(this.validateMonth(month)){ return }else{ //臨時變量 this.tmpMonth = month //切換panel狀態 this.panelType = "date" } }, selectDate (date) { //validate logic above... //一次性全部賦值 this.year = tmpYear this.month = tmpMonth this.date = date.value this.value = `${this.tmpYear}-${("0" + (this.month + 1)).slice(-2)}-${("0" + this.date).slice(-2)}` //選擇完日期后,panel自動隱藏 this.panelState = false }最大/小時間限制最大/小值是需要從父組件傳遞下來的,因此應該使用props,另外,這個值可以是字符串,也應該可以是變量(比如同時存在兩個datepicker,第二個的日期不能比第一個大這種邏輯),所以應該使用Dynamically bind的方式傳值。
增加了限制條件,對于不合法的日期,其按鈕應該變為置灰狀態,我用了比較時間戳的方式來判斷日期是否合法,因為就算當前panel中的日期是跨年或是跨月的,通過日期構造函數創建時都會幫你轉換成對應的合法值,省去很多判斷的麻煩:
new Date(2015, 0, 0).getTime() === new Date(2014, 11, 31).getTime() //true new Date(2015, 12, 0).getTime() === new Date(2016, 0, 0).getTime() //true因此驗證日期是否合法的函數是這樣的:
validateDate (date) { let mon = this.tmpMonth if(date.previousMonth){ mon -= 1 }else if(date.nextMonth){ mon += 1 } if(new Date(this.tmpYear, mon, date.value).getTime() >= new Date(this.minYear, this.minMonth - 1, this.minDate).getTime() && new Date(this.tmpYear, mon, date.value).getTime() <= new Date(this.maxYear, this.maxMonth - 1, this.maxDate).getTime()){ return false } return true}
動態計算位置當頁面右側有足夠的空間顯示時,datepicker的panel會定位為相對于父元素left: 0的位置,如果沒有足夠的空間,則應該置于right: 0的位置,這一點可以通過Vue提供的動態樣式和樣式對象來實現(動態class和動態style其實只是動態props的特例),而計算位置的時刻,我放在了組件聲明周期的ready周期中,因為這時組件已經插入到DOM樹中,可以獲取style進行動態計算:
ready () { if(this.$el.parentNode.offsetWidth + this.$el.parentNode.offsetLeft - this.$el.offsetLeft <= 300){ this.coordinates = {right: "0", top: `${window.getComputedStyle(this.$el.children[0]).offsetHeight + 4}px`} }else{ this.coordinates = {left: "0", top: `${window.getComputedStyle(this.$el.children[0]).offsetHeight + 4}px`} } }為了panel的顯隱可以平滑過渡,可以使用transition做過渡動畫,這里我簡單地通過一個0.2秒的透明度過渡讓顯隱更平滑。
//less syntax .toggle{ &-transition{ transition: all ease .2s; } &-enter, &-leave{ opacity: 0; } }中英文切換這里其實也很簡單,這種多語言切換實質就是一個key根據不同的type而輸出不同的value,所以使用filter可以很容易的實現它!比如渲染星期的列表:
filters : { week (item, lang){ switch (lang) { case "en": return {0: "Su", 1: "Mo", 2: "Tu", 3: "We", 4: "Th", 5: "Fr", 6: "Sa"}[item] case "ch": return {0: "日", 1: "一", 2: "二", 3: "三", 4: "四", 5: "五", 6: "六"}[item] default: return item } } } 多種使用方式
對于一個Vue組件,如果是使用webpack + vue-loader的.vue單文件寫法,我希望這樣使用:
//App.vue如果是直接在瀏覽器中使用,那么我希望datepicker這個組件是暴露在全局下的,可以這么使用:
//index.html這里我選擇了webpack作為打包工具,使用webpack的output.library和output.linraryTarget這兩個屬性就可以把你的bundle文件作為庫文件打包。library定義了庫的名字,libraryTarget定義了你想要打包的格式,具體可以看文檔。我希望自己的庫可以通過datepicker加載到,并且打包成umd格式,因此我的webpack.config.js是這樣的:
module.exports = { entry: "./index.js", output: { path: "./dist", library: "datepicker", filename: "vue-datepicker.js", libraryTarget: "umd" }, module: { loaders: [ {test: /.vue$/, loaders: ["vue"]}, {test: /.js$/, exclude: /node_modules/, loaders: ["babel"]} ] } }打包完成的模塊就是一個umd格式的模塊啦,可以在瀏覽器中直接使用,也可以配合require.js等模塊加載器使用!
適配 Vue 2.xVue 2.0已經發布有段時間了,現在把之前的組件適配到Vue 2.0。遷移過程還是很順利的,核心API改動不大,可以借助vue-migration-helper來找出廢棄的API再逐步修改。這里只列舉一些我需要修改的API。
filter2.0中的filter只能在mustache綁定中使用,如果想在指令式綁定中綁定過濾后的值,可以選擇計算屬性。我在月份和星期的顯示中使用到了過濾器來過濾語言類型,但我之前是在指令式綁定中使用的filter,所以需要如下修改,:
//修改前 //修改后,filter傳參的方式也變了,變成了函數調用的風格移除$index和$key{{tmpMonth + 1 | month(language)}}這兩個屬性不會在v-for中被自動創建了,如需使用,要在v-for中自行聲明:
// ready 生命周期移除ready從生命周期鉤子中移除了,遷移方法很簡單,使用mounted和this.$nextTick來替換。
prop.sync棄用prop的sync棄用了,遷移方案是使用自定義事件,而且Datepicker這種input類型組件,可以使用表單輸入組件的自定義事件作為替換方案。自定義組件也可以使用v-model指令了,但是必須滿足兩個條件:
接收一個value的prop
值發生變化時,觸發一個input事件,傳入新值。
所以Datepicker的使用方式也不是
了,而是 。組件自身向父級傳值的方式也不一樣了: //1.x版本,設置了value的值會同步到父級 this.value = `${this.tmpYear}-${("0" + (this.month + 1)).slice(-2)}-${("0" + this.date).slice(-2)}` //2.x版本,需要自己觸發input事件,將新值作為參數傳遞回去 let value = `${this.tmpYear}-${("0" + (this.month + 1)).slice(-2)}-${("0" + this.date).slice(-2)}` this.$emit("input", value)總結以上就是我在寫這個datepicker時的大致思路,本身也是很簡單的事情,沒有處處展開來說,寫在這里作為自己的一個總結,如果有剛開始使用Vue的同學也希望這篇文章可以在思路上幫助到你們:P,對于各位老鳥如果有什么指點的地方我也很感謝:D,那么差不多就這樣,后面貼一些相關推薦閱讀。
推薦閱讀高效地向數組中插值
Vue.js-片段實例
Vue.js-動態綁定
Js日期對象基礎
Webpack: export bundle as library
UMD(universial Module Defination)
Migration from Vue 1.x文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。
轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/90895.html
摘要:基于日期選擇組件是一款稍微復雜的組件,其中涉及的日歷計算與顯示需要比較清晰的邏輯。 vue-datepicker - 基于Vue2.x日期選擇組件 Datepicker是一款稍微復雜的組件,其中涉及的日歷計算與顯示需要比較清晰的邏輯。 項目地址 https://github.com/watson-yan... 預覽圖 showImg(https://segmentfault.com/i...
摘要:實現代碼于文章末尾處構思頁面結構組件由輸入框和日歷面板組成,寫好頁面主體結構。輸入框點擊顯示或隱藏日歷面板方法改變布爾值控制日歷面板的顯示隱藏。同時,當組件銷毀時,也要及時清除該監聽器。 最近研究了 DatePicker 的實現原理后做了一個 vue 的 DatePicker 組件,今天帶大家一步一步實現 DatePicker 的 vue 組件。 原理 DatePicker 的原理是—...
摘要:全面配置文章系列安裝依賴修改修改 ???nuxt.js全面配置??? ???nuxt文章系列??? babel-plugin-component 安裝依賴 npm i -D babel-plugin-component // or yarn add -D babel-plugin-component 修改nuxt.config.js module.exports = { bui...
摘要:好多時候在移動端需要一個的日期選擇器,由于在應用上有可能應用各種框架庫等所以說一個無依賴的,這樣易于上層進行封裝。主要包含兩種選擇器日期和時間。 好多時候在移動端需要一個的日期選擇器,由于在應用上有可能應用各種框架庫(Vue.js, React.js, zepto.js等);所以說一個無依賴的,這樣易于上層進行封裝。直接開門見山,先來張動圖看看效果: showImg(https://s...
摘要:然則明明是定義了的,只是驗證兩個類文件的話,均未出現任何語法錯誤。打開開發者工具,勾上,觀察發生異常時的狀況,一遍又一遍,我漸漸意識到,發生這個錯誤的時候,還未能在的環境中完成注冊。 開發日歷控件的時候,對方變更了一下需求,基本上將最終產品分成兩個: 選擇連續時間段 選擇多個不連續時間 那么我們知道,對于這種大部分功能一致,只有若干函數邏輯不同的產品,最合適的就是狀態模式。于是很自...
閱讀 1580·2021-09-26 09:46
閱讀 2665·2021-09-07 09:59
閱讀 2750·2021-09-07 09:59
閱讀 1856·2019-08-30 14:20
閱讀 922·2019-08-26 13:39
閱讀 3174·2019-08-26 12:24
閱讀 771·2019-08-26 11:55
閱讀 1212·2019-08-23 16:49