# 自定义过滤器
## 基础
类似于自定义指令,可以用全局方法 `Vue.filter()` 注册一个自定义过滤器,它接收两个参数:**过滤器 ID** 和**过滤器函数**。过滤器函数以值为参数,返回转换后的值:
```
Vue.filter('reverse', function (value) {
return value.split('').reverse().join('')
})
```
```
<!-- 'abc' => 'cba' -->
<span v-text="message | reverse"></span>
```
过滤器函数可以接收任意数量的参数:
```
Vue.filter('wrap', function (value, begin, end) {
return begin + value + end
})
```
```
<!-- 'hello' => 'before hello after' -->
<span v-text="message | wrap 'before' 'after'"></span>
```
## 双向过滤器
目前我们使用过滤器都是在把来自模型的值显视在视图之前转换它。不过也可以定义一个过滤器,在把来自视图(`<input>` 元素)的值写回模型之前转化它:
```
Vue.filter('currencyDisplay', {
// model -> view
// 在更新 `<input>` 元素之前格式化值
read: function(val) {
return '/figure>+val.toFixed(2)
},
// view -> model
// 在写回数据之前格式化值
write: function(val, oldVal) {
var number = +val.replace(/[^\d.]/g, '')
return isNaN(number) ? 0 : parseFloat(number.toFixed(2))
}
})
```
示例:
![](https://box.kancloud.cn/2016-01-03_5688e1a8eee3b.png)
## 动态参数
如果过滤器参数没有用引号包起来,则它会在当前 vm 作用域内动态计算。另外,过滤器函数的 `this` 始终指向调用它的 vm。例如:
```
<input v-model="userInput">
<span>{{msg | concat userInput}}</span>
```
```
Vue.filter('concat', function (value, input) {
// `input` === `this.userInput`
return value + input
})
```
上例比较简单,也可以用表达式达到相同的结果,但是对于更复杂的逻辑——需要多于一个语句,这时需要将它放到计算属性或自定义过滤器中。
内置过滤器 `filterBy` 和 `orderBy`,根据所属 Vue 实例的当前状态,过滤/排序传入的数组。
- 教程
- 起步
- 概述
- Vue 实例
- 数据绑定语法
- 计算属性
- Class 与 Style 绑定
- 条件渲染
- 列表渲染
- 方法与事件处理器
- 表单控件绑定
- 过渡
- 组件
- 深入响应式原理
- 自定义指令
- 自定义过滤器
- 混合
- 插件
- 构建大型应用
- 对比其它框架
- API
- 示例
- Markdown 编辑器 Example
- GitHub 提交 Example
- Firebase + 验证 Example
- 表格组件 Example
- 树状视图 Example
- SVG 图形 Example
- 模态组件 Example
- Elastic Header Example
- 自定义指令 Example
- TodoMVC Example
- HackerNews 克隆 Example