Comment écrire un sélecteur de date en utilisant Vue-js tutoriel-php.cn

Le rôle le plus important de jQuery est multi-navigateur. Bien que le marché des navigateurs ne soit pas parfait aujourd'hui, il est loin d'être aussi misérable qu'avant. L'idée des vues basées sur les données est très populaire. commencer à utiliser des frameworks front-end pour remplacer jQuery. Personnellement, je préfère aimer Vue.js, donc je veux essayer d'écrire un composant en utilisant Vue.js.

Afin de publier sur npm, j'ai changé le nom de l'adresse du projet, mais le code interne n'a pas été modifié et l'utilisation est plus pratique qu'avant.

Adresse GitHub : ici

Fonctions et attentes

Ce sélecteur de date n'implémente actuellement que certaines fonctions couramment utilisées :

Sélectionnez l'heure (c'est un peu redondant)
Délai maximum/minimum
Commutateur chinois/anglais (en en fait, la semaine et le mois doivent être changés)
peut être utilisé sous forme .vue, ou peut être utilisé directement dans l'environnement du navigateur
Non. . .

Structure du répertoire

La première étape consiste toujours à créer un projet. Il ne s'agit que d'un seul composant et la structure de Datepicker.vue n'est pas compliquée. le composant le plus important, dist est le dossier de sortie de webpack, index.js est le fichier d'entrée pour l'empaquetage du webpack, et enfin est le fichier de configuration du webpack, qui est utilisé pour empaqueter nos fichiers de bibliothèque. La structure du projet est donc la suivante :

.
├── Datepicker.vue
├── LICENSE
├── README.md
├── dist
│ └── vue-datepicker.js
├── index.js
├── package.json
└── webpack.config.js

Copier après la connexion

Commencer avec Datepicker.vue

L'écriture de composants Vue au format .vue est une tâche particulière En termes d'écriture, chaque fichier Vue comprend trois parties : le modèle, le script et le style. Il est préférable que le modèle ne devienne pas une instance de fragment, de sorte que la couche la plus externe est d'abord recouverte d'une couche de p, qui est utilisée comme élément racine de. l'ensemble du composant. Un sélecteur de date se compose généralement de deux parties, une zone de saisie utilisée pour afficher la date et un panneau utilisé pour sélectionner la date. Parce que j'ai trouvé que la saisie évoquerait automatiquement le clavier du terminal mobile, je n'ai pas utilisé de saisie et j'ai directement utilisé p. simulation, en cliquant sur L'événement détermine la visibilité du panneau. La valeur est le résultat final et doit communiquer avec le composant parent, donc la valeur est écrite comme prop et value.sync="xxx" est utilisée dans le composant parent. La valeur du sélecteur de date est liée de manière bidirectionnelle au xxx du. composant parent.

<template>
 <p class="date-picker">
  <p class="input" v-text="value" @click="panelState = !panelState">
 </p>
 <p class="date-panel" v-show="panelState">
 </p>
</template>

<scrip>
 export default {
  data () {
   return {
    panelState: false //初始值，默认panel关闭
   }
  },
  props: {
   value: String
  }
 }
</script>

Copier après la connexion

Liste des dates de rendu

Un mois compte au moins 28 jours. Si le dimanche est prévu au début, alors le minimum est de 28 jours. (1er Il se trouve que c'est dimanche) nécessite 4 lignes, mais le nombre de jours dans chaque mois est de 30, 31 est la majorité, et le 1er n'est pas forcément dimanche, donc je l'ai simplement conçu en fonction de la situation la plus courante, avec un total de 6 lignes, et les jours du mois en cours n'ont pas été renseignés. Utilisez la date du mois précédent ou du mois suivant pour terminer le calcul, ce qui facilite le calcul, et la hauteur du panneau ne changera pas lorsque le mois est commuté. Le tableau de listes de dates doit être calculé dynamiquement. Vue fournit l'attribut calculé, donc la liste de dates dateList est directement écrite comme un attribut calculé. Ma méthode consiste à fixer la liste de dates dans un tableau d'une longueur de 42, puis à la remplir avec les dates de ce mois, du mois dernier et du mois suivant dans l'ordre.

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
}

Copier après la connexion

Ici, nous utilisons Array.from pour initialiser un tableau, transmettre un Array Like, le convertir en tableau et utiliser arr[arr. . length] et [{}].concat(arr), car j'ai appris grâce à JsTips que cette méthode a de meilleures performances, et les liens pertinents seront publiés à la fin de l'article.
De cette façon, la liste de dates est construite et rendue à l'aide d'une boucle v-for dans le modèle

<ul class="date-list">
 <li v-for="item in dateList"
  v-text="item.value" 
  :class="{preMonth: item.previousMonth, nextMonth: item.nextMonth,
   selected: date === item.value && month === tmpMonth && item.currentMonth, invalid: validateDate(item)}"
  @click="selectDate(item)">
 </li>
</ul>

Copier après la connexion

Vous pouvez jouer vous-même avec le style , comment ça te plaît ? Il convient de noter que la date du cycle peut apparaître le mois dernier ou ce mois-ci. Je l'ai marquée respectivement via previuosMonth, currentMonth et nextMonth pour fournir des conditions de jugement pour d'autres fonctions.
Les listes d'année et de mois sont similaires. J'ai écrit la valeur initiale de la liste d'année directement dans les données, avec l'année en cours comme première afin d'être cohérente avec le mois, 12 sont affichés à chaque fois via v. -pour le rendu.

data () {
 return {
  yearList: Array.from({length: 12}, (value, index) => new Date().getFullYear() + index)
 }
}

Copier après la connexion

Sélectionnez la fonction date

L'ordre de sélection est : année-> mois-> a Les variables d'état sont utilisées pour contrôler le contenu affiché dans le panneau, et la fonction appropriée est destinée à changer l'état d'affichage.

<p>
 <p class="type-year" v-show="panelType === &#39;year&#39;">
  <ul class="year-list">
   <li v-for="item in yearList"
    v-text="item"
    :class="{selected: item === tmpYear, invalid: validateYear(item)}" 
    @click="selectYear(item)"
   >
   </li>
  </ul>
 </p>
 <p class="type-month" v-show="panelType === &#39;month&#39;">
  <ul class="month-list">
   <li v-for="item in monthList"
    v-text="item | month language"
    :class="{selected: $index === tmpMonth && year === tmpYear, invalid: validateMonth($index)}" 
    @click="selectMonth($index)"
   >
   </li>
  </ul>
 </p>
 <p class="type-date" v-show="panelType === &#39;date&#39;">
  <ul class="date-list">
   <li v-for="item in dateList"
    v-text="item.value" 
    track-by="$index" 
    :class="{preMonth: item.previousMonth, nextMonth: item.nextMonth,
     selected: date === item.value && month === tmpMonth && item.currentMonth, invalid: validateDate(item)}"
    @click="selectDate(item)">
   </li>
  </ul>
 </p>
</p>

Copier après la connexion

Je n'entrerai pas dans les détails sur la méthode de sélection de la date, attribuez simplement des valeurs aux variables année et mois dans selectYear et selectMonth, et puis poussez le panelType à l'étape suivante respectivement.

Cependant, vous ne souhaitez peut-être pas que la valeur réelle de l'année et du mois en cours change avant de sélectionner la date, donc dans ces méthodes, vous pouvez d'abord attribuer la valeur sélectionnée à une variable temporaire et attendre que seletDate Attribuez ensuite toutes les valeurs à la fois.

selectMonth (month) {
 if(this.validateMonth(month)){
  return
 }else{
  //临时变量
  this.tmpMonth = month
  //切换panel状态
  this.panelType = &#39;date&#39;
 }
},
selectDate (date) {
 //validate logic above...
 //一次性全部赋值
 this.year = tmpYear
 this.month = tmpMonth
 this.date = date.value
 this.value = `${this.tmpYear}-${(&#39;0&#39; + (this.month + 1)).slice(-2)}-${(&#39;0&#39; + this.date).slice(-2)}`
 //选择完日期后，panel自动隐藏
 this.panelState = false
}

Copier après la connexion

Délai maximum/minimum

La valeur maximale/minimale doit être transmise par le composant parent, les accessoires doivent donc être utilisée, De plus, cette valeur peut être une chaîne ou une variable (par exemple, s'il y a deux sélecteurs de date en même temps, la date du second ne peut pas être supérieure à la première), la valeur doit donc être transmise en utilisant Dynamiquement lier.

<datepicker :value.sync="start"></datepicker>
<!-- 现在min的值会随着start的变化而变化 -->
<datepicker :value.sync="end" :min="start" ></datepicker>

Copier après la connexion

Ajout de restrictions pour les dates illégales, le bouton doit devenir gris. J'ai utilisé la méthode de comparaison des horodatages pour déterminer si la date est légale, car même si la date est légale. La date dans le panneau actuel s'étend sur des années ou des mois, le constructeur de date vous aidera à la convertir en la valeur légale correspondante lorsque vous la créerez, vous évitant ainsi bien des problèmes de jugement :

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

Copier après la connexion

因此验证日期是否合法的函数是这样的:

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
}

Copier après la connexion

动态计算位置

当页面右侧有足够的空间显示时，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: &#39;0&#39;, top: `${window.getComputedStyle(this.$el.children[0]).offsetHeight + 4}px`}
 }else{
  this.coordinates = {left: &#39;0&#39;, top: `${window.getComputedStyle(this.$el.children[0]).offsetHeight + 4}px`}
 }
}
<!-- template中对应的动态style -->
<p :style="coordinates"></p>

Copier après la connexion

为了panel的显隐可以平滑过渡，可以使用transition做过渡动画，这里我简单地通过一个0.2秒的透明度过渡让显隐更平滑。

<p :style="this.coordinates" v-show="panelState" transition="toggle"></p>

//less syntax
.toggle{
 &-transition{
  transition: all ease .2s;
 }
 &-enter, &-leave{
  opacity: 0;
 }
}

Copier après la connexion

中英文切换

这里其实也很简单，这种多语言切换实质就是一个key根据不同的type而输出不同的value，所以使用filter可以很容易的实现它！比如渲染星期的列表:

<ul class="weeks">
  <li v-for="item in weekList" v-text="item | week language"></li>
 </ul>
 
filters : {
 week (item, lang){
  switch (lang) {
   case &#39;en&#39;:
    return {0: &#39;Su&#39;, 1: &#39;Mo&#39;, 2: &#39;Tu&#39;, 3: &#39;We&#39;, 4: &#39;Th&#39;, 5: &#39;Fr&#39;, 6: &#39;Sa&#39;}[item]
   case &#39;ch&#39;:
    return {0: &#39;日&#39;, 1: &#39;一&#39;, 2: &#39;二&#39;, 3: &#39;三&#39;, 4: &#39;四&#39;, 5: &#39;五&#39;, 6: &#39;六&#39;}[item]
   default:
    return item
  }
 }
}

Copier après la connexion

多种使用方式

对于一个Vue组件，如果是使用webpack + vue-loader的.vue单文件写法，我希望这样使用：

//App.vue
<script>
 import datepicker from &#39;path/to/datepicker.vue&#39;
 export default {
  components: { datepicker}
 }
</script>

Copier après la connexion

如果是直接在浏览器中使用，那么我希望datepicker这个组件是暴露在全局下的，可以这么使用：

//index.html
<html>
 <script src="path/to/vue.js"></script>
 <script src="path/to/datepicker.js"></script>
 <body>
  <p id="app"></p>
  <script>
   new Vue({
    el: &#39;#app&#39;,
    components: { datepicker }
   })
  </script>
 </body>
</html>

Copier après la connexion

这里我选择了webpack作为打包工具，使用webpack的output.library和output.linraryTarget这两个属性就可以把你的bundle文件作为库文件打包。library定义了库的名字，libraryTarget定义了你想要打包的格式，具体可以看文档。我希望自己的库可以通过datepicker加载到，并且打包成umd格式，因此我的webpack.config.js是这样的:

module.exports = {
 entry: &#39;./index.js&#39;,
 output: {
  path: &#39;./dist&#39;,
  library: &#39;datepicker&#39;,
  filename: &#39;vue-datepicker.js&#39;,
  libraryTarget: &#39;umd&#39;
 },
 module: {
  loaders: [
   {test: /\.vue$/, loaders: [&#39;vue&#39;]},
   {test: /\.js$/, exclude: /node_modules/, loaders: [&#39;babel&#39;]}
  ]
 }
}

Copier après la connexion

打包完成的模块就是一个umd格式的模块啦，可以在浏览器中直接使用，也可以配合require.js等模块加载器使用！

适配 Vue 2.x

Vue 2.0已经发布有段时间了，现在把之前的组件适配到Vue 2.0。迁移过程还是很顺利的，核心API改动不大，可以借助vue-migration-helper来找出废弃的API再逐步修改。这里只列举一些我需要修改的API。

filter

2.0中的filter只能在mustache绑定中使用，如果想在指令式绑定中绑定过滤后的值，可以选择计算属性。我在月份和星期的显示中使用到了过滤器来过滤语言类型，但我之前是在指令式绑定中使用的filter，所以需要如下修改，：

//修改前
<p class="month-box" @click="chType(&#39;month&#39;)" v-text="tmpMonth + 1 | month language"></p>
//修改后，filter传参的方式也变了，变成了函数调用的风格
<p class="month-box" @click="chType(&#39;month&#39;)">{{tmpMonth + 1 | month(language)}}</p>

Copier après la connexion

移除$index和$key

这两个属性不会在v-for中被自动创建了，如需使用，要在v-for中自行声明：

<li v-for="item in monthList" @click="selectMonth($index)"></li>
//
<li v-for="(item, index) in monthList" @click="selectMonth(index)"></li>

Copier après la connexion

ready 生命周期移除

ready从生命周期钩子中移除了，迁移方法很简单，使用mounted和this.$nextTick来替换。

prop.sync弃用

prop的sync弃用了，迁移方案是使用自定义事件，而且Datepicker这种input类型组件，可以使用表单输入组件的自定义事件作为替换方案。自定义组件也可以使用v-model指令了，但是必须满足两个条件：

接收一个value的prop
值发生变化时，触发一个input事件，传入新值。

所以Datepicker的使用方式也不是了，而是。组件自身向父级传值的方式也不一样了：

//1.x版本，设置了value的值会同步到父级
this.value = `${this.tmpYear}-${(&#39;0&#39; + (this.month + 1)).slice(-2)}-${(&#39;0&#39; + this.date).slice(-2)}`

//2.x版本，需要自己触发input事件，将新值作为参数传递回去
let value = `${this.tmpYear}-${(&#39;0&#39; + (this.month + 1)).slice(-2)}-${(&#39;0&#39; + this.date).slice(-2)}`
this.$emit(&#39;input&#39;, value)

Copier après la connexion