v-bind

  • 缩写：:

  • 预期：any (with argument) | Object (without argument)

  • 参数：attrOrProp (optional)

  • 修饰符：

    • .prop - 被用于绑定 DOM 属性 (property)。(差别在哪里？)
    • .camel - (2.1.0+) 将 kebab-case 特性名转换为 camelCase. (从 2.1.0 开始支持)
    • .sync (2.3.0+) 语法糖，会扩展成一个更新父组件绑定值的 v-on 侦听器。
  • 用法：

动态地绑定一个或多个特性，或一个组件 prop 到表达式。

在绑定 class 或 style 特性时，支持其它类型的值，如数组或对象。可以通过下面的教程链接查看详情。

在绑定 prop 时，prop 必须在子组件中声明。可以用修饰符指定不同的绑定类型。

没有参数时，可以绑定到一个包含键值对的对象。注意此时 class 和 style 绑定不支持数组和对象。

  • 示例：
  1. <!-- 绑定一个属性 -->
  2. <img v-bind:src="imageSrc">
  4. <!-- 动态特性名 (2.6.0+) -->
  5. <button v-bind:[key]="value"></button>
  7. <!-- 缩写 -->
  8. <img :src="imageSrc">
  10. <!-- 动态特性名缩写 (2.6.0+) -->
  11. <button :[key]="value"></button>
  13. <!-- 内联字符串拼接 -->
  14. <img :src="'/path/to/images/' + fileName">
  16. <!-- class 绑定 -->
  17. <div :class="{ red: isRed }"></div>
  18. <div :class="[classA, classB]"></div>
  19. <div :class="[classA, { classB: isB, classC: isC }]">
  21. <!-- style 绑定 -->
  22. <div :style="{ fontSize: size + 'px' }"></div>
  23. <div :style="[styleObjectA, styleObjectB]"></div>
  25. <!-- 绑定一个有属性的对象 -->
  26. <div v-bind="{ id: someProp, 'other-attr': otherProp }"></div>
  28. <!-- 通过 prop 修饰符绑定 DOM 属性 -->
  29. <div v-bind:text-content.prop="text"></div>
  31. <!-- prop 绑定。“prop”必须在 my-component 中声明。-->
  32. <my-component :prop="someThing"></my-component>
  34. <!-- 通过 $props 将父组件的 props 一起传给子组件 -->
  35. <child-component v-bind="$props"></child-component>
  37. <!-- XLink -->
  38. <svg><a :xlink:special="foo"></a></svg>

.camel 修饰符允许在使用 DOM 模板时将 v-bind 属性名称驼峰化，例如 SVG 的 viewBox 属性：

<svg :view-box.camel="viewBox"></svg>

在使用字符串模板或通过 vue-loader/vueify 编译时，无需使用 .camel。