叉烧店并不卖叉烧

组件基础

vuejs TTT 158℃ 0评论

参考

基本示例

这里有一个Vue组件的示例:

Vue.component('button-counter', {
	data: function () {
		return {
			count: 0
		}
	},
	template: `
		<button v-on:click="count++">You clicked me {{ count }} times.</button>
	`
})

new Vue({
	el: '#app-1'
})
注意!在用template属性定义我们的模板HTML内容时,在上面那个例子,我们可以看到使用的``(反引号),使用反引号虽然方便,但是当我们的页面在IE浏览器下,组件可能会渲染不出来。所以推荐还是使用''(单引号)或者""(双引号)。为什么说``(反引号)方便,因为使用''(单引号)或者""(双引号)在我们对HTML内容进行换行的时候,需要加符号\(反斜杠)在行末尾,而``(反引号)不用。
<div id="app-1">
	<button-counter></button-counter>
</div>

组件是可复用的Vue实例,且带有一个名字:在这个例子中是<button-counter>。我们可以在一个通过new Vue创建的Vue根实例中,把这个组件作为自定义元素来使用

因为组件是可复用的Vue实例,所以它们与new Vue接收相同的选项,例如datacomputedwatchmethod以及生命周期钩子等。仅有的例外是像el这样根实例特有的选项。

组件的复用

可以将组件进行任意次的复用:

<div id="components-demo">
  <button-counter></button-counter>
  <button-counter></button-counter>
  <button-counter></button-counter>
</div>

注意当点击按钮时,每个组件都会各自独立维护它的count(这与定义组件时用data: function(){return {count:0}}有以一些关系)。因为你每用一次组件,就会有一个它的新实例被创建。

data必须是一个函数

当我们定义这个<button-counter>组件时,我们可以看到data并不是像这样直接提供一个对象:

data: {
  count: 0
}

取而代之的是,一个组件的data选项必须是一个函数,因此每个实例可以维护一份被返回对象的独立的拷贝:

data: function () {
  return {
    count: 0
  }
}

如果Vue没有这条规则,那么点击一个按钮,就会影响到其他所有实例

组件的组织

通常一个应用会以一颗嵌套的组件树的形式来组织:

例如,你可能会有页头、侧边栏、内容区等组件,每个组件又包含了其他的像导航链接、博文之类的组件。

为了能在模板中使用,这些组件必须先注册以便Vue能够识别。这里有两种组件的注册类型:全局注册局部注册。至此,我们的组件都只是通过Vue.component全局注册的:

Vue.component('my-component-name', {
  // ... options ...
})

全局注册的组件可以用在其被注册之后的任何(通过new Vue)新创建的Vue根实例,也包括其组件树中的所有子组件的模板中。

如果需要了解组件注册可以阅读此章节

通过Prop向子组件传递数据

如果我们要写一个博文组件。那么我们就需要向博文组件传递某一篇博文的标题或内容之内的我们想展示的数据。而实现的关键就prop

Prop可以用来在组件上添加一些自定义特性。当一个值传递给一个prop特性的时候,它就变成了那个组件实例的一个属性。为了给博文组件传递一个标题,我们可以用 一个props选项将其包含在该组件可接受的prop列表中:

Vue.component('blog-post', {
	props: ['title'],
	template: `
		<h3>{{ title }}</h3>
	`
})
var app3 = new Vue({
	el: '#app-3'
})

?一个组件默认可以拥有任意数量的prop,任何值都可以传递给prop。在上述模板中,我们可以在组件实例中访问这个值,就像访问data中的值一样。?!

一个prop被注册之后,你就可以像这样把数据作为一个自定义特性传递进来:

<div id="app-3">
	<blog-post title="My journey with Vue"></blog-post>
	<blog-post title="Blogging with Vue"></blog-post>
	<blog-post title="Why Vue is so fun"></blog-post>
</div>
我发现,当我以这种形式为title赋值时是错误的<blog-post v-bind:title="My journey with Vue"></blog-post>。因为v-bind:title指令需要一个JavaScript表达式,所以我们赋值为My journey with Vue时,JavaScript会当他是一个变量名,会去查找有没有My journey with Vue这个变量,所以出错。所以我们可以这样写,<blog-post v-bind:title="'My journey with Vue'"></blog-post>,因为这样JavaScript就会直接当'My journey with Vue'(注意'')它是一个字符串,这样就正常。我们也可以在实例化Vue对象时的data对象里面添加一个title1变量来存储My journey with Vue,然后在v-bind指令中使用变量。
<div id="app-3">
	<blog-post v-bind:title="title1"></blog-post>
</div>
Vue.component('blog-post', {
	props: ['title'],
	template: `
		<h3>{{ title }}</h3>
	`
})
var app3 = new Vue({
	el: '#app-3',
	data: {
		title1: 'My journey with Vue'
	}
})

切记不能在HTML标签中使用双括号表达式{{varName}}为普通属性赋值,例如,<blog-post title="{{title1}}"></blog-post>这样是错误的

然而在以典型的应用中,我们可能在data里面有一个博文数组:

var app4 = new Vue({
	el: '#app-4',
	data: {
		posts: [
			{
				id: 1,
				title: 'My Journey with Vue'
			},
			{
				id: 2,
				title: 'Blogging with Vue'
			},
			{
				id: 3,
				title: 'Why Vue is so fun'
			},
		]
	}
})

并想要为每篇博文渲染一个组件:

<div id="app-4">
	<blog-post v-for="post in posts"
		v-bind:key="post.id"
		v-bind:title="post.title"></blog-post>
</div>

如上所示,我们可以使用v-bind来动态传递prop。如果我们一开始不清楚要渲染的具体内容,那这个操作是非常有用的。也可以看这个从一个API获取博文列表

到目前位置,关于prop需要了解的大概内容就这些了,如果学习完本页内容并掌握了它的内容,就推荐把prop读完

单个根元素

当构建一个<blog-post>组件时,你的模板最终会包含的东西远不止一个标题:

<h3>{{ title }}</h3>

最起码,我们会包含这篇博文的正文:

<h3>{{ title }}</h3>
<div v-html="content"></div>

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

<div class="blog-post">
  <h3>{{ title }}</h3>
  <div v-html="content"></div>
</div>

看起来当组件变得原来复杂的时候,我们的博文不止需要标题和内容,还需要发布日期、评论等等。为每个相关的信息定义一个prop会变得麻烦,比如:

<blog-post
  v-for="post in posts"
  v-bind:key="post.id"
  v-bind:title="post.title"
  v-bind:content="post.content"
  v-bind:publishedAt="post.publishedAt"
  v-bind:comments="post.comments"
></blog-post>

所以是时候重构一下这个<blog-post>组件了,让它变成接受一个单独的postprop:

<blog-post
  v-for="post in posts"
  v-bind:key="post.id"
  v-bind:post="post"
></blog-post>
Vue.component('blog-post', {
  props: ['post'],
  template: `
    <div class="blog-post">
      <h3>{{ post.title }}</h3>
      <div v-html="post.content"></div>
    </div>
  `
})

代码验证:

<div id="app-5">
	<app5 v-for="post in posts"
		v-bind:key="post.id"
		v-bind:post="post">		
	</app5>
</div>
Vue.component('app5', {
	props: ['post'],
	template: '\
		<div class="blog-post">\
			<h3>{{ post.title }}</h3>\
			<div v-html="post.content"></div>\
		</div>\
	'
})
var app5 = new Vue({
	el: '#app-5',
	data: {
		posts: [
			{
				id: 1, 
				content: 'content1'
			},
			{
				id: 2, 
				content: 'content2'
			},
			{
				id: 3, 
				content: 'content3'
			}
		]
	}
})
上述的这个和一些接下来的示例使用了JavaScript的模板字符串来让多行的模板更容易读(也就是使用``(反引号))。它们在IE下并没有被支持,所以如果需要在不(经过Babel或TypeScript之类的工具)编译的情况下支持IE,请使用折行转义符\(反斜杠))取而代之。

现在,不论何时为post对象添加一个新的属性,它都会自动在<blog-post>内可用。

通过事件向父级组件发送消息

在我们开发blog-post组件时,它的一些功能可能需要我们和父级组件进行沟通。例如我们可能会引入一个可访问性的功能来放大博文的字号,同时让页面的其他部分保持默认的字号。

在其父组件中,我们可以通过添加一个postFontSize数据属性来支持这个功能:

new Vue({
  el: '#blog-posts-events-demo',
  data: {
    posts: [/* ... */],
    postFontSize: 1
  }
})

它可以在模板中用来控制所有博文的字号:

<div id="blog-posts-events-demo">
  <div :style="{ fontSize: postFontSize + 'em' }">
    <blog-post
      v-for="post in posts"
      v-bind:key="post.id"
      v-bind:post="post"
    ></blog-post>
  </div>
</div>

现在我们在每篇博文正文之前添加一个按钮来放大字号:

Vue.component('blog-post', {
  props: ['post'],
  template: `
    <div class="blog-post">
      <h3>{{ post.title }}</h3>
      <button>
        Enlarge text
      </button>
      <div v-html="post.content"></div>
    </div>
  `
})

问题时这个按钮不会做任何事:

<button>
  Enlarge text
</button>

当点击这个按钮时,我们需要告诉父级组件放大所有博文的文本。幸好Vue实例提供了一个自定义事件的系统来解决这个问题。我们可以调用内建的$emit方法并传入事件的名字,来向父级组件触发一个事件:

<button v-on:click="$emit('enlarge-text')">
  Enlarge text
</button>

然后我们可以用v-on在博文组件上监听这个事件,就像监听一个原生DOM事件一样:

<blog-post
  ...
  v-on:enlarge-text="postFontSize += 0.1"
></blog-post>

代码验证:

<div id="app-6">
	<div v-bind:style="{fontSize: postFontSize + 'em'}">
		<app6 v-for="post in posts"
			v-bind:key="post.id"
			v-bind:post="post"
			v-on:enlarge-text="postFontSize += 0.1"
		></app6>
	</div>
</div>
Vue.component('app6', {
	props: ['post'],
	template: '\
		<div>\
			<h3>{{ post.title }}</h3>\
			<button v-on:click="$emit(\'enlarge-text\')">\
				Enlarge text\
			</button>\
			<p>{{ post.content }}</p>\
		</div>'
})
var app6 = new Vue({
	el: '#app-6',
	data: {
		posts: [
			{
				id: 1, 
				title: 'title1',
				content: '...content1...'
			},
			{
				id: 2, 
				title: 'title2',
				content: '...content2...'
			},
			{
				id: 3, 
				title: 'title3',
				content: '...content3...'
			}
		],
		postFontSize: 1,
	}
})

使用事件抛出一个值

有的时候用一个事件来抛出一个特定的值时非常有用的。例如我们可能想让<blog-post>组件决定它的文本要放大多少。这时候可以使用$emit的第二个参数来提供这个值:

<button v-on:click="$emit('enlarge-text', 0.1)">
  Enlarge text
</button>

然后当在父级组件监听这个事件的时候,我们可以通过$event访问到被抛出的这个值:

<blog-post
  ...
  v-on:enlarge-text="postFontSize += $event"
></blog-post>

代码验证:

<div id="app-7">
	<div :style="{fontSize: postFontSize + 'em'}">
		<app7 v-for="post in posts"
			v-bind:key="post.id"
			v-bind:post="post"
			v-on:enlarge-text="postFontSize += $event"
		></app7>
	</div>
</div>
Vue.component('app7', {
	props: ['post'],
	template: '\
		<div>\
			<h3>{{ post.title }}</h3>\
			<button v-on:click="$emit(\'enlarge-text\', 0.1, 2)">\
				enlarge text\
			</button>\
			<br/>\
			<p>{{ post.content }}</p>\
		</div>\
	'
})
var app7 = new Vue({
	el: '#app-7',
	data: {
		postFontSize: 1,
		posts: [
			{
				id: 1, 
				title: 'title1',
				content: '...content1...'
			},
			{
				id: 2, 
				title: 'title2',
				content: '...content2...'
			},
			{
				id: 3, 
				title: 'title3',
				content: '...content3...'
			}
		]
	}
})
注意!在这里,当v-on:click="$emit(\'enlarge-text\', 0.1, 2)"发出\'enlarge-text\', 0.1, 2事件时候。会调用v-on:enlarge-text="postFontSize += $event",如果以这种方式来处理我们的逻辑,那么Vue会默认帮我们把"postFontSize += $event"封装成一个函数,比如function ($event) { postFontSize += $event}而此时这个默认函数只能接受一个参数,所以这正是它的缺陷,它只能接收0.1参数,参数2接收不到。如果要达到接收多个函数的话就需要我们把语句自己封装在一个函数里面,有两中方法,第一种时我们在Vue实例中自己定义一个函数,比如methods: { enlargeFontSize: function ($event1, $event2){...}},然后调用,这样就可以接收两个参数;另一种方法是直接这样写function ($event, $event2, $event3) {postFontSize += $event;}

或者,如果这个事件处理函数是一个方法:

<blog-post
  ...
  v-on:enlarge-text="onEnlargeText"
></blog-post>

那么这个值将会作为第一个参数传入这个方法:

methods: {
  onEnlargeText: function (enlargeAmount) {
    this.postFontSize += enlargeAmount
  }
}

代码验证:

<div id="app-8">
	<div :style="{fontSize: postFontSize + 'em'}">
		<app8 v-for="post in posts"
			v-bind:key="post.id"
			v-bind:post="post"
			v-on:enlarge-text="onEnlargeText"
		></app8>
	</div>
</div>
Vue.component('app8', {
	props: ['post'],
	template: '\
		<div>\
			<h3>{{ post.title }}</h3>\
			<button v-on:click="$emit(\'enlarge-text\', 0.1, 2)">\
				enlarge text\
			</button>\
			<br/>\
			<p>{{ post.content }}</p>\
		</div>\
	'
})
var app8 = new Vue({
	el: '#app-8',
	data: {
		postFontSize: 1,
		posts: [
			{
				id: 1, 
				title: 'title1',
				content: '...content1...'
			},
			{
				id: 2, 
				title: 'title2',
				content: '...content2...'
			},
			{
				id: 3, 
				title: 'title3',
				content: '...content3...'
			}
		]
	},
	methods: {
		onEnlargeText: function ($var, $var2) {
			this.postFontSize += $var
		}
	}
})

在组件上使用v-model

自定义事件也可以用于创建支持v-model的自定义输入组件。记住:

<input v-model="searchText">

等价于:

<input
  v-bind:value="searchText"
  v-on:input="searchText = $event.target.value"
>

代码验证:

<div id="app-9">
	<input v-model="searchText"/>
	<p>{{ searchText }}</p>
</div>
<div id="app-10">
	<input 
		v-bind:value="searchText"
		v-on:input="searchText = $event.target.value"/>
		<p>{{ searchText }}</p>
</div>
var app9 = new Vue({
	el: '#app-9',
	data: {
		searchText: ''
	}
})
var app10 = new Vue({
	el: '#app-10',
	data: {
		searchText: ''
	}
})
注意!这里它是使用$event.target.value获取到绑定的值。这是最原始的情况。
使用v-bind:prop1='val1'只是单向的动态绑定,也就是变量val1的值如果改变,那么也会改变对应标签属性prop1的值,但是反过来却不会。
v-on:input="val1 = $event.target.value"中表示,如果触发标签的input(onInput)事件,那么就会执行语句"val1 = $event.target.value",这个语句的意思是将$event.target.value的内容赋值给变量val1。然后根据之前所说的,val1改变之后标签的属性prop1也会被改变。
onInput也就是我们的输入事件,如果没有加v-on:input="val1 = $event.target.value",那么我们每次输入的时候,只会更新标签的prop1(value)属性的,但是v-bind:prop1=val1并不是双向绑定,所以这个动作不能修改val1的值,所以我们只能自己取到输入的值赋值给val1

当用在组件上时,v-model则会这样:

<custom-input
  v-bind:value="searchText"
  v-on:input="searchText = $event"
></custom-input>

代码验证:

<div id="app-11">
	<app11 v-bind:value1="searchText"
		v-on:input="searchText = $event"></app11>
	<p>{{ searchText }}</p>
</div>
Vue.component('app11', {
	props: ['value1'],
	template: '\
		<input v-bind:value="value1"\
			v-on:input="$emit(\'input\', $event.target.value)"/>\
	'
})
var app11 = new Vue({
	el: '#app-11',
	data: {
		searchText: ''
	}
})
注意!在:
Vue.component('app11', {
	props: ['value1'],
	template: '\
		<input v-bind:value="value1"\
			v-on:input="$emit(\'input\', $event.target.value)"/>\
	'
})
中,props:['value1']中的value1属性是属于app11的,Vue在实例话的时候应该会为value1加上前缀,或者就已经是app11组件的一个属性了,而:
template: '\
		<input v-bind:value="value1"\
			v-on:input="$emit(\'input\', $event.target.value)"/>\
	'
里面的v-bind:value中的value是属于这个字符串中的标签input的。
它的顺序应该是,当我们在输入框输入东西的时候我们会触发input标签的input事件,从而运行"$emit('input', $event.target.value)"语句,这个语句会抛出一个input事件,并且将$event.target.value作为参数传递过去给v-on:input="searchText = $event",然后运行"searchText = $event",意思是将传递过来的第一个参数赋值给searchText。而在标签<app11 v-bind:value1="searchText"中,searchText的值与app11标签的属性value1绑定在一起,所以修改searchText的也会修改value1的值。而在定义app11标签中我们有如下语句:
template: '\
		<input v-bind:value="value1"\
,也就是说明我们将app11标签的value1特性绑定到了input标签的value属性上。因此如果我们改变了searchText那么就会同时修改app11value1inputvalue

为了让它正常工作,这个组件内的<input>必须:

  • 将其value特性绑定到一个名叫value的prop上
  • 在其input事件被触发时,将新的值通过自定义的input事件抛出

写成代码之后是这样的:

Vue.component('custom-input', {
  props: ['value'],
  template: `
    <input
      v-bind:value="value"
      v-on:input="$emit('input', $event.target.value)"
    >
  `
})

现在v-model就应该可以在这个组件上完美地工作起来了:

<custom-input v-model="searchText"></custom-input>

代码验证:

<div id="app-12">
	<app12 v-model="searchText"></app12>
	<p>{{ searchText }}</p>
</div>
Vue.component('app12', {
	props: ['value1'],
	template: '\
		<input v-bind:value="value1"\
			v-on:input="$emit(\'input\', $event.target.value)"/>\
	'
})
var app12 = new Vue({
	el: '#app-12',
	data: {
		searchText: ''
	}
})

到目前为止,关于组件自定义事件需要了解的内容就这些,如果阅读完本页并掌握,就可以读自定义事件

通过插槽分发内容

和HTML元素一样,我们经常需要向一个组件传递内容,就像这样:

<alert-box>
  Something bad happened.
</alert-box>

可能会渲染出这样的东西:

幸好,Vue自定义的<slot>元素让这变得非常简单:

Vue.component('alert-box', {
  template: `
    <div class="demo-alert-box">
      <strong>Error!</strong>
      <slot></slot>
    </div>
  `
})

代码验证:

<div id="app-13">
	<app13>Something bad happend.</app13>
</div>
Vue.component('app13', {
	template: '\
		<div class="app13">\
			<strong>Error!</strong>\
			<slot></slot>\
		</div>\
	'
})
var app13 = new Vue({
	el: '#app-13'
})
#app-13{
    background-color: #ac4545;
    border:2px #f70e0e solid;
    padding:1em;
}

如你所见,我们只需要在需要的地方加入插槽就行了!

到目前为止,关于插槽的了解大概就这些了,如果阅读完本页内容,可以把插槽读完。

动态组件

有时候,在不同组件之间进行动态切换是非常有用的,比如在一个多标签的界面里面:

上述内容可以通过Vue的<component>元素添加一个is特性来实现:

<!-- 组件会在 `currentTabComponent` 改变时改变 -->
<component v-bind:is="currentTabComponent"></component>

?在上述示例中,currentTabComponent可以包括

  • 已注册的名字
  • 一个组件的选项对象?!

这里查阅完整代码,或在这个版本了解绑定组件选项对象,而不是已经注册组件名的示例。

代码验证:

实现一

<div id="app-14">
	<button v-for="btn in btns"
		v-bind:key="btn"
		v-on:click="currentBtn = btn"
		v-bind:class="['btn', { active: currentBtn === btn }]">
		{{ btn }}
	</button>
	<component v-bind:is="currentTab"
		class="tab"></component>
</div>
Vue.component('tab-home', {
	template: '\
		<div>Home component</div>\
	'
})
Vue.component('tab-posts', {
	template: '\
		<div>Posts component</div>\
	'
})
Vue.component('tab-archive', {
	template: '\
		<div>Archive component</div>\
	'
})
var app14 = new Vue({
	el: '#app-14',
	data: {
		currentBtn: 'home',
		btns: [
			'home', 'posts', 'archive'
		]
	},
	computed: {
		currentTab: function () {
			return 'tab-' + this.currentBtn
		}
	}
})
.btn {
    padding: 0.5rem 0.7rem;
    border:1px #cecbcb solid;
    background-color: #dfd9d9;
    border-top-left-radius: 0.5rem;
    border-top-right-radius: 0.5rem;
}
.btn:hover {
    background-color: #cec7c7
}
.btn.active {
    background-color: #cec7c7
}
.tab {
    padding: 0.5rem 0.7rem;
    border:1px #cecbcb solid;
}

实现二

<div id="app-15">
	<button v-for="tab in tabs"
		v-bind:key="tab.name"
		v-on:click="currentTab = tab"
		v-bind:class="['btn', { active: currentTab.name === tab.name }]">
		{{ tab.name }}
	</button>
	<app15 v-bind:is="currentTab.component"
		class="tab"></app15>
</div>
var tabs2 = [
	{
		name: 'home',
		component: {
			template: '<div>home component</div>'
		}
	},
	{
		name: 'posts',
		component: {
			template: '<div>posts component</div>'
		}
	},
	{
		name: 'archive',
		component: {
			template: '<div>archive component</div>'
		}
	},
]
var app15 = new Vue({
	el: '#app-15',
	data: {
		tabs: tabs2,
		currentTab: tabs2[0]
	}
})
对于实现二,使用JavaScript原生对象来存储组件内容,其中对象要包含有template属性来存放HTML模板内容。最后在v-bind:is特性的作用下,会自动将对象的template的HTML模板内容渲染出来。

到目前位置,关于动态组件需要了解的内容大概就是这些,如果阅读完本页内容并掌握它的内容,那可以把动态和异步组件读完。

解析DOM模板时的注意事项

有些HTML元素,诸如<ul><ol><table> <select>,对于哪些元素可以出现在其内部是有严格限制的。而有些元素,诸如<li><tr><option>,只能出现在其他某些特定的元素内部。

这会导致我们在使用这些有约束条件的元素时遇到一些问题。例如:

<table>
  <blog-post-row></blog-post-row>
</table>

这个自定义组件<blog-post-row>会被作为无效的内容提升到外部,并导致最
终渲染出来的结果出错。而Vue提供一个特殊的is特性给我们使用,例如:

<table>
  <tr is="blog-post-row"></tr>
</table>

需要注意的是如果我们是从一下来源使用模板的话,这条限制是不存在

  • 字符串(例如:template: '...'
  • 单文件组件.vue
  • <script type="text/x-template">

到这里,需要了解的解析DOM模板时的注意事项——实际上也就是Vue的全部必要内容,大概就是这些了。

转载请注明:叉烧店 » 组件基础

喜欢 (0)
发表我的评论
取消评论

CAPTCHA Image
Reload Image
表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址