一个案例搞懂Vue.js的作用域插槽

开发 前端
当你无法理解一个东西的时候,最好的办法就是在解决问题的过程中体会它的应用。本文将向你展示如何使用作用域插槽构建一个可复用的列表组件。

 [[279199]]

作用域插槽是 Vue.js 中一个很有用的特性,可以显著提高组件的通用性和可复用性。问题在于,它实在不太好理解。尝试搞清楚父子作用域之间错综复杂的关系,其痛苦程度不亚于求解一个棘手的数学方程。

当你无法理解一个东西的时候,最好的办法就是在解决问题的过程中体会它的应用。本文将向你展示如何使用作用域插槽构建一个可复用的列表组件。

注意: 完整代码可以去 Codepen    查看

最基础的组件

我们即将构建的组件叫做 my-list ,用来展示一系列的项目。它的特别之处就在于,你可以在每次使用组件的时候自定义列表项目的渲染方式。

我们先从最简单的单个列表开始:一个包含几何图形名字和边数的数组。

app.js 

  1. Vue.component('my-list', {  
  2.   template: '#my-list',  
  3.   data() {  
  4.     return {  
  5.       title: 'Shapes',  
  6.       shapes: [   
  7.         { name: 'Square', sides: 4 },   
  8.         { name: 'Hexagon', sides: 6 },   
  9.         { name: 'Triangle', sides: 3 }  
  10.       ]  
  11.     };  
  12.   }  
  13. });  
  14. new Vue({  
  15.   el: '#app'  
  16. }); 

index.html 

  1. <div id="app">  
  2.   <my-list></my-list>  
  3. </div>  
  4. <script type="text/x-template" id="my-list">  
  5.   <div class="my-list">  
  6.     <div class="title">{{ title }}</div>  
  7.     <div class="list">  
  8.       <div class="list-item" v-for="shape in shapes">  
  9.         <div>{{ shape.name }} <small>({{ shape.sides }} sides)</small></div>  
  10.       </div>  
  11.     </div>  
  12.   </div>  
  13. </script> 

在加上一点样式,大概就会是下图这个样子:

更通用的 my-list

现在我们想要让 my-list 更加通用,可以渲染任何类型的列表。这次我们展示的是一堆颜色的名字以及对应的颜色方块。

为此,我们需要将上例列表独有的数据进行抽象化。由于列表中的项目可能有不同的结构,我们将会给 my-list 一个插槽,让父组件来定义列表的展示方式。

app.js 

  1. Vue.component('my-list', {  
  2.   template: '#my-list',  
  3.   props: [ 'title' ]  
  4. }); 

index.html 

  1. <script type="text/x-template" id="my-list">  
  2.   <div class="my-list">  
  3.     <div class="title">{{ title }}</div>  
  4.     <div class="list">  
  5.       <slot></slot>  
  6.     </div>  
  7.   </div>  
  8. </script> 

现在,我们在根实例中创建 my-list 组件的两个实例,分别展示两个测试用例列表:lists:

app.js 

  1. new Vue({  
  2.   el: '#app',  
  3.   data: {  
  4.     shapes: [   
  5.       { name: 'Square', sides: 4 },   
  6.       { name: 'Hexagon', sides: 6 },   
  7.       { name: 'Triangle', sides: 3 }  
  8.     ],  
  9.     colors: [  
  10.       { name: 'Yellow', hex: '#F4D03F', },  
  11.       { name: 'Green', hex: '#229954' },  
  12.       { name: 'Purple', hex: '#9B59B6' }  
  13.     ]  
  14.   }  
  15. });  
  1. <div id="app">  
  2.   <my-list :title="Shapes">  
  3.     <div class="list-item" v-for="item in shapes">  
  4.       <div>{{ shape.name }} <small>({{ shape.sides }} sides)</small></div>  
  5.     </div>  
  6.   </my-list>  
  7.   <my-list :title="Colors">  
  8.     <div class="list-item" v-for="color in colors">  
  9.       <div>  
  10.         <div class="swatch" :style="{ background: color.hex }"></div>  
  11.         {{ color.name }}  
  12.       </div>  
  13.     </div>  
  14.   </my-list>  
  15. </div> 

效果如下图:

大材小用的组件

我们刚才创建的组件确实符合要求,但那段代码算不上很好。my-list 本来应该是一个展示列表的组件,但我们却把渲染列表需要的逻辑部分抽象到了父组件中,这样一来,子组件在这里只不过是用来包裹列表而已,未免显得大材小用了。

更糟糕的是,在两个组件的声明中存在着大量重复代码(例如,<div class="list-item" v-for="item in ...">)。如果我们能够在子组件中编写这些代码,那么子组件就不再是“打酱油的角色”了。

作用域插槽

普通插槽无法满足我们的需求,这时候,作用域插槽就派上用场了。作用域插槽允许你传递一个模板而不是已经渲染好的元素给插槽。之所以叫做”作用域“插槽,是因为模板虽然是在父级作用域中渲染的,却能拿到子组件的数据。

例如,带有作用域插槽的组件 child 大概是下面这个样子: 

  1. <div>  
  2.   <slot my-prop="Hello from child"></slot>  
  3. </div> 

使用这个组件的父组件将会在插槽中声明一个 template 元素。这个模板元素会有一个 scope (译者注:Vue 2.6 后改为 v-slot 属性)属性指向一个对象,任何添加到插槽(位于子组件模板)中的属性都会作为这个对象的属性。 

  1. <child>  
  2.   <template scope="props">  
  3.     <span>Hello from parent</span>  
  4.     <span>{{ props.my-prop }}</span>  
  5.   </template>  
  6. </child> 

将会渲染成: 

  1. <div>  
  2.   <span>Hello from parent</span>  
  3.   <span>Hello from child</span>  
  4. </div> 

在 my-list 中使用作用域插槽

我们将两个列表数组通过 props 传递给 my-list。之后将普通插槽替换为作用域插槽,这样,my-list 就能够负责迭代列表项目,同时父组件依然能够定义每个项目具体的展示方式。

index.html 

  1. <div id="app">  
  2.   <my-list title="Shapes" :items="shapes">  
  3.     <!--在这里书写 template-->  
  4.   </my-list>  
  5.   <my-list title="Colors" :items="colors">  
  6.     <!--在这里书写 template-->  
  7.   </my-list>     
  8. </div> 

接着我们让 my-list 迭代项目。在 v-for 循环中,item 是当前迭代项目的别名。我们可以创建一个插槽并通过 v-bind="item" 将那个项目绑定到插槽中。

app.js 

  1. Vue.component('my-list', {  
  2.   template: '#my-list',  
  3.   props: [ 'title', 'items' ]  
  4. }); 

index.html 

  1. <script type="text/x-template" id="my-list">  
  2.   <div class="my-list">  
  3.     <div class="title">{{ title }}</div>  
  4.     <div class="list">  
  5.       <div v-for="item in items">  
  6.         <slot v-bind="item"></slot>  
  7.       </div>  
  8.     </div>  
  9.   </div>  
  10. </script> 

注意:也许你之前没见过不带参数的 v-bind 用法。这种用法将会把整个对象的所以属性都绑定到当前元素上。在涉及作用域插槽时,这种用法很常见,因为绑定的对象可能有很多属性,而一一将它们列举出来并手动绑定显然太麻烦了。

现在,回到根实例这里来,在 my-list 的插槽中声明一个模板。首先看一下几何图形列表(第一个例子中的列表),我们声明的模板必须带有一个 scope 属性,这里将其赋值为 shape。shape 这个别名可以让我们访问作用域插槽。在模板中,我们可以继续沿用最初例子中的标记来展示项目。 

  1. <my-list title="Shapes" :items="shapes">  
  2.   <template scope="shape">  
  3.     <div>{{ shape.name }} <small>({{ shape.sides }} sides)</small></div>  
  4.   </template>  
  5. </my-list> 

整个模板大概是下面这样: 

  1. <div id="app">  
  2.   <my-list title="Shapes" :items="shapes">  
  3.     <template scope="shape">  
  4.       <div>{{ shape.name }} <small>({{ shape.sides }} sides)</small></div>  
  5.     </template>  
  6.   </my-list>  
  7.   <my-list title="Colors" :items="colors">  
  8.     <template scope="color">  
  9.       <div>  
  10.         <div class="swatch" :style="{ background: color.hex }"></div>  
  11.         {{ color.name }}  
  12.       </div>  
  13.     </template>  
  14.   </my-list>     
  15. </div> 

结论

虽然用上作用域插槽之后,代码量并未减少,但是我们将通用的功能都交由子组件负责,这显著提高了代码的健壮性。

完整代码的 Codepen 在这里:

https://codepen.io/anthonygor...

译者注: Vue.js 2.6.0 之后将 slot-scope 改为 v-slot

 

 

责任编辑:庞桂玉 来源: segmentfault
相关推荐

2020-05-25 17:03:47

Vue嵌套插槽开发

2021-04-14 07:52:00

Vue 作用域插槽

2024-01-16 12:19:08

MySQL重要机制高并发

2018-01-31 15:45:07

前端Vue.js组件

2011-03-31 11:15:52

网页设计Web

2022-04-05 16:44:59

系统Vue.js响应式

2022-02-10 10:48:23

JavaScriptVue.js数据

2023-07-13 12:21:18

2022-04-09 17:53:56

Vue.js分支切换嵌套的effect

2019-04-29 14:51:05

前后端JavaVue.js

2019-10-11 09:59:55

开发者技能工具

2011-03-04 10:07:34

Win7SQL Server连接

2023-03-07 16:09:08

2020-12-07 06:26:32

模式交付工作

2020-04-30 09:17:28

数据分析电商分析思维

2023-04-26 01:25:05

案例故障模型

2022-01-13 22:37:26

VSCode代码 编辑器

2020-03-24 08:32:24

vue作用域前端

2018-04-04 10:32:13

前端JavascriptVue.js

2017-07-04 17:55:37

Vue.js插件开发
点赞
收藏

51CTO技术栈公众号