diff --git "a/\346\236\227\351\270\277\351\221\253/note2021-6-08-01.md" "b/\346\236\227\351\270\277\351\221\253/note2021-6-08-01.md" new file mode 100644 index 0000000000000000000000000000000000000000..167b00f16efa45e0e8aa818783987d03d7670654 --- /dev/null +++ "b/\346\236\227\351\270\277\351\221\253/note2021-6-08-01.md" @@ -0,0 +1,388 @@ +# 组件基础(vue的第九次课) + +## 基本示例 + +举个例子: + +
+ +
+ + + + +因为组件是可复用的 Vue 实例,所以它们与 new Vue 接收相同的选项,例如 data、computed、watch、methods 以及生命周期钩子等。仅有的例外是像 el 这样根实例特有的选项。 + +## 组件的复用 + +就是跟上面一样的道理但是就把一个用成多个就行了 + + +
+ + + + + + +
+ + + + +### data 必须是一个函数 + +当我们定义这个 组件时,你可能会发现它的 data 并不是像这样直接提供一个对象: + +data: { + count: 0 +} +取而代之的是,一个组件的 data 选项必须是一个函数,因此每个实例可以维护一份被返回对象的独立的拷贝: + +data: function () { + return { + count: 0 + } +} + +不然你点击一个的时候其它的随之也会改变 + +## 组件的组织 +通常一个应用会以一棵嵌套的组件树的形式来组织: + * + *** + ***** + ******** + ********** + [*] + [*] +Component Tree + +例如,你可能会有页头、侧边栏、内容区等组件,每个组件又包含了其它的像导航链接、博文之类的组件。 + +为了能在模板中使用,这些组件必须先注册以便 Vue 能够识别。这里有两种组件的注册类型:全局注册和局部注册。至此,我们的组件都只是通过 Vue.component 全局注册的: + +Vue.component('my-component-name', { + // ... options ... +}) +全局注册的组件可以用在其被注册之后的任何 (通过 new Vue) 新创建的 Vue 根实例,也包括其组件树中的所有子组件的模板中。 + +到目前为止,关于组件注册你需要了解的就这些了,如果你阅读完本页内容并掌握了它的内容,我们会推荐你再回来把组件注册读完。 + +## 通过 Prop 向子组件传递数据 + +Prop 是你可以在组件上注册的一些自定义 attribute。当一个值传递给一个 prop attribute 的时候,它就变成了那个组件实例的一个 property。为了给博文组件传递一个标题,我们可以用一个 props 选项将其包含在该组件可接受的 prop 列表中: + +
+ +
+ + + + +然而在一个典型的应用中,你可能在 data 里有一个博文的数组: + +
+ +
+ + + + +如上所示,你会发现我们可以使用 v-bind 来动态传递 prop。这在你一开始不清楚要渲染的具体内容,比如从一个 API 获取博文列表的时候,是非常有用的。 + +## 单个根元素 + +构建一个 组件时,你的模板最终会包含的东西远不止一个标题: + +

{{ title }}

+最最起码,你会包含这篇博文的正文: + +

{{ title }}

+
+然而如果你在模板中尝试这样写,Vue 会显示一个错误,并解释道 every component must have a single root element (每个组件必须只有一个根元素)。你可以将模板的内容包裹在一个父元素内,来修复这个问题,例如: + +
+

{{ title }}

+
+
+看起来当组件变得越来越复杂的时候,我们的博文不只需要标题和内容,还需要发布日期、评论等等。为每个相关的信息定义一个 prop 会变得很麻烦: + + + +所以是时候重构一下这个 组件了,让它变成接受一个单独的 post prop: + + + Vue.component('blog-post', { + props: ['post'], + template: ` +
+

{{ post.title }}

+
+
+ ` + }) + +注意: +上述的这个和一些接下来的示例使用了 JavaScript 的模板字符串来让多行的模板更易读。它们在 IE 下并没有被支持,所以如果你需要在不 (经过 Babel 或 TypeScript 之类的工具) 编译的情况下支持 IE,请使用折行转义字符取而代之。 + +现在,不论何时为 post 对象添加一个新的 property,它都会自动地在 内可用。 + +## 监听子组件事件 + +在我们开发 组件时,它的一些功能可能要求我们和父级组件进行沟通。例如我们可能会引入一个辅助功能来放大博文的字号,同时让页面的其它部分保持默认的字号。 + +在其父组件中,我们可以通过添加一个 postFontSize 数据 property 来支持这个功能: + + new Vue({ + el: '#blog-posts-events-demo', + data: { + posts: [/* ... */], + postFontSize: 1 + } + }) +它可以在模板中用来控制所有博文的字号: + +
+
+ +
+
+现在我们在每篇博文正文之前添加一个按钮来放大字号: + + Vue.component('blog-post', { + props: ['post'], + template: ` +
+

{{ post.title }}

+ +
+
+ ` + }) +问题是这个按钮不会做任何事: + + +当点击这个按钮时,我们需要告诉父级组件放大所有博文的文本。幸好 Vue 实例提供了一个自定义事件的系统来解决这个问题。父级组件可以像处理 native DOM 事件一样通过 v-on 监听子组件实例的任意事件: + + +同时子组件可以通过调用内建的 $emit 方法并传入事件名称来触发一个事件: + + +有了这个 v-on:enlarge-text="postFontSize += 0.1" 监听器,父级组件就会接收该事件并更新 postFontSize 的值。 + +### 使用事件抛出一个值 + +有的时候用一个事件来抛出一个特定的值是非常有用的。例如我们可能想让 组件决定它的文本要放大多少。这时可以使用 $emit 的第二个参数来提供这个值: + + +然后当在父级组件监听这个事件的时候,我们可以通过 $event 访问到被抛出的这个值: + + +或者,如果这个事件处理函数是一个方法: + + +那么这个值将会作为第一个参数传入这个方法: + + methods: { + onEnlargeText: function (enlargeAmount) { + this.postFontSize += enlargeAmount + } + } + +### 在组件上使用 v-model + +自定义事件也可以用于创建支持 v-model 的自定义输入组件。记住: + + +等价于: + + +当用在组件上时,v-model 则会这样: + + +为了让它正常工作,这个组件内的 必须: + +将其 value attribute 绑定到一个名叫 value 的 prop 上 +在其 input 事件被触发时,将新的值通过自定义的 input 事件抛出 +写成代码之后是这样的: + + Vue.component('custom-input', { + props: ['value'], + template: ` + + ` + }) +现在 v-model 就应该可以在这个组件上完美地工作起来了: + + +到目前为止,关于组件自定义事件你需要了解的大概就这些了,如果你阅读完本页内容并掌握了它的内容,我们会推荐你再回来把自定义事件读完。 + +## 通过插槽分发内容 + +和 HTML 元素一样,我们经常需要向一个组件传递内容,像这样: + + + Something bad happened. + +可能会渲染出这样的东西: + +幸好,Vue 自定义的 元素让这变得非常简单: + + Vue.component('alert-box', { + template: ` +
+ Error! + +
+ ` + }) +如你所见,我们只要在需要的地方加入插槽就行了——就这么简单! + +到目前为止,关于插槽你需要了解的大概就这些了,如果你阅读完本页内容并掌握了它的内容,我们会推荐你再回来把插槽读完。 + +## 动态组件 +上述内容可以通过 Vue 的 元素加一个特殊的 is attribute 来实现: + + + +在上述示例中,currentTabComponent 可以包括 + +已注册组件的名字,或 +一个组件的选项对象 +你可以在这里查阅并体验完整的代码,或在这个版本了解绑定组件选项对象,而不是已注册组件名的示例。 + +请留意,这个 attribute 可以用于常规 HTML 元素,但这些元素将被视为组件,这意味着所有的 attribute 都会作为 DOM attribute 被绑定。对于像 value 这样的 property,若想让其如预期般工作,你需要使用 .prop 修饰器。 + +到目前为止,关于动态组件你需要了解的大概就这些了,如果你阅读完本页内容并掌握了它的内容,我们会推荐你再回来把动态和异步组件读完。 + +## 解析 DOM 模板时的注意事项 + +有些 HTML 元素,诸如
      、 和
      + +
      +这个自定义组件 会被作为无效的内容提升到外部,并导致最终渲染结果出错。幸好这个特殊的 is attribute 给了我们一个变通的办法: + + + +
      +需要注意的是如果我们从以下来源使用模板的话,这条限制是不存在的: + +字符串 (例如:template: '...') +单文件组件 (.vue) +