乐趣区

Vue渐进

jiezi

深入了解组件：

prop：

==prop 会在一个组件实例创建之前进行验证，所以实例的属性 (如 computed、data 等) 在 default 或者 validator 函数中不可用 ==

== 如果组件内部没有相应的 props 接收外部提供的特性, 则该特性会被添加到组件的根元素上 ==

传入一个对象的所有属性：==v-bind=”obj”==

prop 验证：

类型校验：type：Number|String|Object|Array|Boolean|Date|Function|Symbol|Person// 自定义类名
props:{
    propA:Number,
  propB:[String,Number],
  propC:{
    type:Number,
    required:true
  }，propD：{
    type:Object,
    default:()=>{return {...}
    }
  },
  propE:{validator:(value)=>{
      // 对 value 进行验证，返回布尔类型
      return Boolean
    }
  }
}

替换 / 合并已有特性：

对于绝大多数特性来说，从外部提供给组件的值会替换掉组件内部设置好的值（class 和 style 的值会被合并）

禁用特性继承：

如果不希望组件的根元素继承特性，则可以在组件的选项中设置 inheritAttrs:false(== 不会影响 class 和 style 的绑定 ==), 可以配合 ==$attrs== 属性(包含传入组件的所有特性) 手动为内部元素分配特性

自定义事件：

自定义事件方法：

  1. DOM 元素上使用 v -on.[事件名]=[事件回调方法]
  2. 使用 $on 定义事件：vm.$on([事件名]，[事件回调，自动接收所有入参])

触发事件方法：

  1. 触发当前实例上的事件，使用 $emit([事件名],[参数])
  2. 对自定义或传入的方法直接调用 event()或者作为回调方法

自定义组件的 v -model：

默认情况下，一个组件上的 v -model 会 == 把 value 作为 prop 且把 input 用作 event==，但是对于不同的组件可以自定义 model 达到不同的目的：

过渡 & 动画：

进入 / 离开 & 列表过渡：

单元素 / 组件的过渡：

当插入或删除包含在 transition 组件中的元素时，Vue 将会做一下处理：

  1. 自动嗅探目标元素是否应用了 CSS 过渡或动画，如果是，在恰当的时机添加 / 删除 CSS 类名
  2. 如果过渡组件提供了 JS 钩子函数，这些钩子函数将在恰当的时机被调用
  3. 如果没有找到 JS 钩子函数并且也没有检测到 CSS 过渡 / 动画，DOM 操作 (插入 / 删除) 在下一帧中立即执行
过渡的类名：
  1. ==v-enter==：定义进入过渡的开始状态。在元素被插入之前生效，在文件被插入之后的下一帧移除
  2. ==v-enter-active==：定义进入过渡生效时的状态。字啊整个进入过渡的阶段中应用，在元素被插入之前生效，在过渡 / 动画完成之后移除。可以定义进入多度的过程时间、延迟和曲线函数
  3. ==v-enter-to==：定义进入过渡的结束状态。在元素被插入的下一帧生效（与此同时 v -enter 被移除），在过渡 / 动画完成之后移除
  4. ==v-leave==：定义来开过渡的开始状态。在离开过渡被触发时立刻生效，下一帧被移除
  5. ==v-leave-active==：定义离开过渡生效时的状态。在整个离开过渡的阶段中应用，在离开过渡被触发时立刻生效，在过渡 / 动画完成之后移除。可以定义离开过渡的过程时间、延迟和曲线函数
  6. ==v-leave-to==：定义离开过渡的结束状态。在离开过渡被触发之后下一帧（与此同时 v -leave 被移除），在过渡 / 动画完成之后被移除

<transition> 没有名字时，则 ==v-== 是这些类名的前缀；如果定义 <transition name=’my-transition’>, 则 ==my-transition== 会作为这些类名的前缀

CSS 过渡 / 动画：
/* 可以设置不同的进入和离开动画 利用 CSS3 的过渡和动画定义类 */
/* 设置持续时间和动画函数 */
.slide-fade-enter-active {transition: all .3s ease;}
.slide-fade-leave-active {transition: all .8s cubic-bezier(1.0, 0.5, 0.8, 1.0);
}
.slide-fade-enter, .slide-fade-leave-to
/* .slide-fade-leave-active for below version 2.1.8 */ {transform: translateX(10px);
  opacity: 0;
}

.bounce-enter-active {animation: bounce-in .5s;}
.bounce-leave-active {animation: bounce-in .5s reverse;}
@keyframes bounce-in {
  0% {transform: scale(0);
  }
  50% {transform: scale(1.5);
  }
  100% {transform: scale(1);
  }
}
自定义过渡的类名：

可以通过以下特性自定义过渡类名：==enter-class、enter-active-calss、enter-to-class、leave-class、lave-to-class、leave-active-class==，他们的优先级高于普通的类名，对于结合 Vue 的过渡系统和第三方 CSS 动画库 (Animate.css) 十分有用

<link href="https://cdn.jsdelivr.net/npm/animate.css@3.5.1" rel="stylesheet" type="text/css">

<div id="example-3">
  <button @click="show = !show">
    Toggle render
  </button>
  <transition
    name="custom-classes-transition"
    enter-active-class="animated tada"
    leave-active-class="animated bounceOutRight"
  >
    <p v-if="show">hello</p>
  </transition>
</div>

<u> 同时设置两种过渡动效时，需使用 type 特性并设置 animation 或 transition 来明确需要 Vue 监听的类型 </u>

显性的定义过渡持续时间：

<transition :duration="1000">...</transition>
<!-- 定制进入和移出的持续时间 -->
<transition :duration="{enter: 500, leave: 800}">...</transition>
JS 钩子函数：

<u>JS 动画库：Velocity.js</u>

<transition
  v-on:before-enter="beforeEnter"
  v-on:enter="enter"
  v-on:after-enter="afterEnter"
  v-on:enter-cancelled="enterCancelled"

  v-on:before-leave="beforeLeave"
  v-on:leave="leave"
  v-on:after-leave="afterLeave"
  v-on:leave-cancelled="leaveCancelled"
>
  <!-- ... -->
</transition>

methods: {beforeEnter: function (el) {// ...},
  // 当与 CSS 结合使用时
  // 回调函数 done 是可选的
  enter: function (el, done) {
    // ...
    done()},
  afterEnter: function (el) {// ...},
  enterCancelled: function (el) {// ...},
  beforeLeave: function (el) {// ...},
  // 当与 CSS 结合使用时
  // 回调函数 done 是可选的
  leave: function (el, done) {
    // ...
    done()},
  afterLeave: function (el) {// ...},
  // leaveCancelled 只用于 v-show 中
  leaveCancelled: function (el) {// ...}
}

<u> 当只有 JS 过渡的时候，在 enter 和 leave 中必须使用 done 进行回调。否则，他们将被同步调用，过渡会立即完成 </u>

<u> 推荐对于仅适用 JS 过渡的元素添加 ==v-bindLcss=’false’==，Vue 会跳过 CSS 的检测，也避免了过程中 CSS 的影响 </u>

初始渲染过渡：

可以通过特性 ==appear== 设置节点在初始渲染的过渡

// 自定义 CSS 类名
<transition
  appear
  appear-class="custom-appear-class"
  appear-to-class="custom-appear-to-class" (2.1.8+)
  appear-active-class="custom-appear-active-class"
>
  <!-- ... -->
</transition>
// 自定义 JavaScript 钩子
<transition
  appear
  v-on:before-appear="customBeforeAppearHook"
  v-on:appear="customAppearHook"
  v-on:after-appear="customAfterAppearHook"
  v-on:appear-cancelled="customAppearCancelledHook"
>
  <!-- ... -->
</transition>

多个元素的过渡：

使用 v -if/v-show 切换多个元素；相同的标签需要 key；给在 <transition> 组件中的多个元素设置 key 是更好的实践；一些场景中，可以给一个元素设置不同的 key 来替代 v -if 和 v -else

<transition>
  <button v-bind:key="docState">
    {{buttonMessage}}
  </button>
</transition>
// ...
computed: {buttonMessage: function () {switch (this.docState) {
      case 'saved': return 'Edit'
      case 'edited': return 'Save'
      case 'editing': return 'Cancel'
    }
  }
}
过渡模式：

多个元素过渡时，它们的离开和进入会同时发生，这时需要给 <transition> 设置 mode 特性：

// in-out：新元素先进行过渡，完成之后当前元素过渡离开。// out-in：当前元素先进行过渡，完成之后新元素过渡进入。<transition name="fade" mode="out-in">
  <!-- ... the buttons ... -->
</transition>

多个组件的过渡：

多个组件的过渡不需要设置 key，只需要使用动态组件

<transition name="component-fade" mode="out-in">
  <component v-bind:is="view"></component>
</transition>

列表过渡：

不是渲染单个节点或同一时间渲染多个节点中的一个，而同时渲染整个列表时，使用 <transition-group> 组件：

  1. 不同于 <transition>，它会以一个真实的元素呈现，默认为一个 span，可以使用 tag 特性更换为其他元素
  2. 过渡模式不可用，因为不再相互切换特有的元素
  3. 内部元素总是需要提供唯一的 key 属性值
  4. CSS 过渡的类将会应用在内部的元素中，而不是这个组件 / 容器本身
列表的进入 / 离开过渡：

进入和离开的过渡使用相同的 CSS 类名

<div id="list-demo" class="demo">
  <button v-on:click="add">Add</button>
  <button v-on:click="remove">Remove</button>
  <transition-group name="list" tag="p">
    <span v-for="item in items" v-bind:key="item" class="list-item">
      {{item}}
    </span>
  </transition-group>
</div>
.list-item {
  display: inline-block;
  margin-right: 10px;
}
.list-enter-active, .list-leave-active {transition: all 1s;}
.list-enter, .list-leave-to
/* .list-leave-active for below version 2.1.8 */ {
  opacity: 0;
  transform: translateY(30px);
}
列表的排序过渡：

使用 v -move 特性，它会在元素改变定位的过程中应用；可以通过 name 属性自定义前缀，也可以通过 move-class 属性手动设置。（内部的实现，Vue 使用了一个叫 FLIP 简单的动画队列使用 transforms 将元素从之前的位置平滑过渡新的位置，需要注意的是使用 FLIP 过渡的元素不能设置为 display：inline，可以用 inline-block 代替或者放于 flex 中）

<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.14.1/lodash.min.js"></script>

<div id="flip-list-demo" class="demo">
  <button v-on:click="shuffle">Shuffle</button>
  <transition-group name="flip-list" tag="ul" >
   <!--<transition-group  move-class='flip-list' tag="ul" > -->
    <li v-for="item in items" v-bind:key="item">
      {{item}}
    </li>
  </transition-group>
</div>

.flip-list-move {transition: transform 1s;}
列表的交错过渡：

通过 data 属性与 JavaScript 通信，就可以实现列表的交错过渡：

<script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js"></script>

<div id="staggered-list-demo">
  <input v-model="query">
  <transition-group
    name="staggered-fade"
    tag="ul"
    v-bind:css="false"
    v-on:before-enter="beforeEnter"
    v-on:enter="enter"
    v-on:leave="leave"
  >
    <li
      v-for="(item, index) in computedList"
      v-bind:key="item.msg"
      v-bind:data-index="index"
    >{{item.msg}}</li>
  </transition-group>
</div>
methods: {beforeEnter: function (el) {
      el.style.opacity = 0
      el.style.height = 0
    },
    enter: function (el, done) {
      var delay = el.dataset.index * 150
      setTimeout(function () {
        Velocity(
          el,
          {opacity: 1, height: '1.6em'},
          {complete: done}
        )
      }, delay)
    },
    leave: function (el, done) {
      var delay = el.dataset.index * 150
      setTimeout(function () {
        Velocity(
          el,
          {opacity: 0, height: 0},
          {complete: done}
        )
      }, delay)
    }
  }

可复用的过渡：

退出移动版