vue.js基础之 过滤器详解

过滤器

介绍

过滤器本质上就是函数，作用在于用户输入数据后进行处理并返回一个结果。使用管道符（｜）连接。

分类

• 内置过滤器

  实例：

  {{'abc' | uppercase}} //'abc' => 'ABC'
  

  这里使用了内置过滤器 uppercase ，将字符串改为大写。

• 自定义过滤器

特点

• 支持链式调用
• 高内聚低耦合
• 方便数据处理，获取想要的数据格式

内置过滤器

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-wNI8lqc8-1591182356367)(/Users/mxj/Library/Application Support/typora-user-images/image-20200603130112004.png)]

字母操作

capitalize 、 uppercase 、 lowercase 用于处理英文字符，且仅对英文字符串使用。

capitalize

用于将表达式中的首字母转为大写。

{{ 'def' | capitalize}} // 'Def'

uppercase

用于将表达式中的所有字母转为大写。

lowercase

用于将表达式中的所有字母转为小写。

json 过滤器

用于将字符串的值转换为 json 字符串，带有一个数值参数表示转换之后字符串的缩紧距离，默认为2。

<pre>{{ didFamily | json 4 }}</pre>

上例表示以4个空格打印一个json字符串

限制

limitBy、filterBy、orderBy 用于处理并返回过滤后的数组。

limitBy

限制数组为开始的 N 个元素，N 由传入的第一个参数决定；第二个参数可选，指定数组的偏移量，默认为0，如果为5， 则表示从下标为5的地方开始计数。

//只显示开始的10个元素
<div v-for="item in items | limitBy 10"

//显示第5到第10个元素
<div v-for="item in items | limitBy 10 5"

filterBy

过滤条件为：'function || string ’ + in + ‘optionKeyName’

如果搜索条件为多字符可以中间用空格隔开，返回包含过滤条件的数组。

<div v-for="user in users ｜ filterBy 'Chrim' in 'name' 'nickname'" ></div>

也可以将搜索字段放到一个数组中，当修改搜索字段时只需修改数组即可，无需修改 View 层。

var names = ['name', 'nickname']
<div v-for="user in users ｜ filterBy 'Chrim' in names" ></div>

orderBy

返回排序后的数组。

过滤条件是：‘string || array || function’ + ‘order>0为升序 || order < 0 为降序’，order 默认为 1， 即升序。

注释：当传入参数为 string 或 array 的时候，其原理是用的 sort 函数，只不过 vue 提前在内部做了处理。

currency 过滤器

currency 过滤器的作用是将数字值转换为货币形式输出。第一个参数为 String 的货币符号，如果不输入，则默认为美元符号；第二个参数为 Number 的小数位，默认为2。

注意：如果第一个参数采取默认形式，而需要第二个参数修改小数位，那么第一个参数不可省略。

//默认情况
{{ amount | currency}}  //12345 => $12,345.00

//使用人民币符号
{{ amount | currency '¥'}}  //12345 => ¥12,345.00

//将小数位调整为 3 位
{{ amount | currency '$' 3}}  //12345 => $12,345.000

debounse 过滤器

debounce 过滤器的作用是延迟处理器一定的时间执行。参数为函数且必须，一般与 v-on 等指令结合使用；可选参数延迟时间，单位毫秒，默认为 300 毫秒。

应用：通常在监听用户 input 事件时使用 debounce 过滤器，可以防止频繁调用方法。

<input @keyup='onKeyup | debounce 500'

自定义过滤器

大多数情况下内置的过滤器并不能满足我们的需求，所以需要用到 自定义过滤器。其方法如下：

filter 语法

Vue 中有一个全局函数用于自定义过滤器：Vue.filter：

单个参数：实现将字符串反转

Vue.filter('reverse', function (value) {
  return value.splite('').reverse().join('');
})

<span v-text='message | reverse'></span>

多参数

多参数之间用空格分隔

Vue.filter('wrap', function (value, begin, end) {
	return begin + value + end;
})

<span v-text="message | wrap 'before' 'agter'"></span>
//'hello' => 'before hello after'

双向过滤器

上面的过滤器函数都是在 Model 数据输出到 View 层之前进行数据转化的，实际上 Vue.js 还支持把来自视图（input 元素） 的值在写回模型前进行转化，即双向过滤器。

Vue.filter(id, {
	//model -> viiew 
	//read 函数可选
	read: function(val) {},
	//view -> model
	//write 函数将在数据被写入 Model 之前调用
	//两个参数分别为表达式的新值和旧值
	write: function(newVal, oldVal) {}
})

动态参数

如果过滤器参数和没有用引号包起来，则它会在 vm 作用域内动态计算。此外，过滤器函数的 this 始终指向调用它的 vm。

<input v-model='userInput'>
<span>{{ msg | contact userInput}}</span>

<!-- 此处过滤器接受的参数 userInput 根据用户输入动态计算 -->
Vue.filter('concat', function (value, input) {
	return value + input
})

自定义过滤器注意事项

• 给过滤器一个唯一标识

  如果用户自定义的过滤器与内置过滤器冲突，那么内置过滤器会被覆盖；如果后注册的过滤器与之前的过滤器冲突，则之前注册的过滤器会被覆盖。

• 过滤器函数需要有返回值

  过滤器函数的作用是输入表达式的值，经过处理后输出。因此，定义的函数最好可以返回有意义的值。函数没有 return 语句不会报错，但这样的过滤器没有意义。

常见问题 解析

filterBy/orderBy 对表达式进行过滤后 $index 的索引

在使用 filterBy 或 orderBy 对表达式进行过滤时，如果同时需要将 $index 作为参数，此时的 $index 将会根据表达式数组或对象过滤后的值进行索引。

<ul id="example">
	<li v-for="item in items | order 'age'">{{ item.message}} - {{ $index }}</li>
</ul>

var example = new Vue({
	el: '#example',
	data: {
		items: [
			{ message: '顺风车'， age: 2},
			{ message: '出租车'， age: 10},
			{ message: '快车'， age: 6}
		]
	}
})

//最终显示顺序为：顺风车-0、快车-0、出租车-2

即索引为返回的新数组的索引。

自定义 filter 的书写位置

自定义 filter 既可以写在全局的 Vue 下，也可以写在实例当中。但是需要注意的是，当写在全局 Vue 中时，要写在实例化 Vue 对象之前，否则不起作用。

全局 Vue

Vue.filter('reverse', function(value){
	return value.split('').reverse.join('');
})

实例中

var demo = new Vue({
	el: '#demo',
	data: {},
	filters: {
		reverse: function (value){
			return value.split('').reverse.join('');
		}
	}
})