Vue.js

# 特殊 attribute

# key

  • 预期：number | string | symbol

    key 特殊 attribute 主要用做 Vue 的虚拟 DOM 算法的提示，以在比对新旧节点组时辨识 VNodes。如果不使用 key，Vue 会使用一种算法来最小化元素的移动并且尽可能尝试就地修改/复用相同类型元素。而使用 key 时，它会基于 key 的顺序变化重新排列元素，并且那些使用了已经不存在的 key 的元素将会被移除/销毁。

    有相同父元素的子元素必须有唯一的 key。重复的 key 会造成渲染错误。

    最常见的用例是和 v-for 一起使用：

    <ul>
  <li v-for="item in items" :key="item.id">...</li>
</ul>
    1
    2
    3

    它也可以用于强制替换元素/组件而不是重复使用它。当你遇到如下场景时它可能会很有用：

    • 完整地触发组件的生命周期钩子
    • 触发过渡

    例如：

    <transition>
  <span :key="text">{{ text }}</span>
</transition>
    1
    2
    3

    当 text 发生改变时，<span> 总是会被替换而不是被修改，因此会触发过渡。

# ref

  • 预期：string | Function

    ref 被用来给元素或子组件注册引用信息。引用信息将会被注册在父组件的 $refs 对象上。如果在普通的 DOM 元素上使用，引用指向的就是那个 DOM 元素；如果用在子组件上，引用就指向组件实例：

    <!-- vm.$refs.p 会是 DOM 节点 -->
<p ref="p">hello</p>

<!-- vm.$refs.child 会是子组件实例 -->
<child-component ref="child"></child-component>

<!-- 当动态绑定时，我们可以将 ref 定义为回调函数，显式地传递元素或组件实例 -->
<child-component :ref="(el) => child = el"></child-component>
    1
    2
    3
    4
    5
    6
    7
    8

    关于 ref 注册时机的重要说明：因为 ref 本身是作为渲染函数的结果而创建的，在初始渲染时你不能访问它们——它们还不存在！$refs 也是非响应式的，因此你不应该试图用它在模板中做数据绑定。

  • 参考子组件 Refs

# is

  • 预期：string | Object (component’s options object)

    使用动态组件。

    例如：

    <!-- 当 currentView 改变时组件就改变 -->
<component :is="currentView"></component>
    1
    2

  • 在原生元素上使用 3.1+

    当 is attribute 被用在一个原生 HTML 元素上时，它会被作为一个自定义的内置元素(opens new window) 进行转译，这是一个原生 web platform 的特性。

    不过，如解析 DOM 模板时的注意事项里解释的，有的时候你可能需要 Vue 将一个原生元素替换为一个 Vue 组件。这时你可以把 is attribute 的值加上 vue: 前缀，这样 Vue 就会将这些元素换为 Vue 组件进行渲染：

    <table>
  <tr is="vue:my-row-component"></tr>
</table>
    1
    2
    3

  • 参考

  • 动态组件

  • RFC explaining the change from Vue 2(opens new window)

← 内置组件 →