概念

过滤器(filters)是 vue 为开发者提供的功能,对要显示的数据进行特定格式化后再显示(适用于一些简单逻辑的处理)实质不改变原始数据,我们也可以理解其为一个纯函数

过滤器

Vue.js 允许你自定义过滤器,可被用于一些常见的文本格式化

过滤器可以用在两个地方:
双花括号插值:{{变量 | 过滤器名}}
v-bind 表达式 (后者从 2.1.0+ 开始支持):v-bind:属性 = “变量 | 过滤器名”

注意:Vue3 中已移除 filter

1、过滤器的使用

过滤器应该被添加在 JavaScript 表达式的尾部,由“管道符” |进行调用:

<!-- 在双花括号中 -->
{{ message | capitalize }}

<!-- 在 `v-bind` 中 -->
<div v-bind:id="rawId | formatId"></div>

2、过滤器的分类

2.1、局部过滤器

在一个组件的选项中定义本地的过滤器,即 filters 节点下定义的过滤器,称为局部过滤器,因为它只能在当前 vm 实例所控制的 el 区域内使用

注册过滤器:new Vue{filters:{}}

// 局部过滤器
filters: {   // 在 filters 节点下定义过滤器
    capitalize(str) {  // 把首字母转为大写的过滤器
        if (!str) return ''
        str= str.toString()
        return str.charAt(0).toUpperCase() + str.slice(1);
    },
}
2.2、全局过滤器

在创建 Vue 实例之前全局定义过滤器,可以在多个 vue 实例之间共享过滤器

注册过滤器:Vue.filter(name,callback)

// 全局过滤器
Vue.filter('capitalize', function (value) {
    if (!value) return
    value = value.toString()
    return value.charAt(0).toUpperCase() + value.slice(1)
})
const vm = new Vue({
    // ...
})

当全局过滤器和局部过滤器重名时,会采用局部过滤器

3、参数问题

过滤器函数总接收表达式的值 (之前的操作链的结果) 作为第一个参数。在上述例子中,capitalize 过滤器函数将会收到 message 的值作为第一个参数

过滤器可以串联:

{{ message | filterA | filterB }}

在这个例子中,filterA 被定义为接收单个参数的过滤器函数,表达式 message 的值将作为参数传入到函数中。然后继续调用同样被定义为接收单个参数的过滤器函数 filterB,将 filterA 的结果传递到 filterB 中

过滤器是 JavaScript 函数,因此可以接收参数:

{{ message | filterA(‘arg1’, arg2) }}

这里,filterA 被定义为接收三个参数的过滤器函数。其中 message 的值作为第一个参数,普通字符串 ‘arg1’ 作为第二个参数,表达式 arg2 的值作为第三个参数

4、Vue项目中过滤器的应用场景

开发中,需要用到过滤器的地方有很多,如单位转换、文本格式化、时间格式化、数字打点等
例:要实现将 30000 => 30,000,这时候我们就需要使用过滤器

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>vue 中的数字打点</title>
    <script type="text/javascript" src="./js/vue.min.js"></script>
</head>

<body>
    <div id="root">
        <p>{{num | toThousandFilter}}</p>
    </div>

    <script type="text/javascript">
        Vue.filter('toThousandFilter', function (value) {  // 数字从右到左,每三位用英文逗号隔开
            if (!value) return ''
            value = value.toString()
            return value.replace(value.indexOf('.') > -1 ? /(\d)(?=(\d{3})+\.)/g : /(\d)(?=(?:\d{3})+$)/g, '$1,')
        })
        new Vue({
            el: '#root',
            data: {
                num: '30000'
            }
        })
    </script>
</body>

</html>

5、案例

BootCDN
BootCDN 是 极兔云 联合 Bootstrap 中文网 共同支持并维护的前端开源项目免费 CDN 服务,致力于为 Bootstrap、jQuery、React、Vue.js 一样优秀的前端开源项目提供稳定、快速的免费 CDN 加速服务。BootCDN 所收录的开源项目主要同步于 cdnjs 开源项目仓库

dayjs
Day.js 是一个轻量的处理时间和日期的 JavaScript 库,和 Moment.js 的 API 设计保持完全一样
1、将 dayjs.min.js 下载到本地
2、在项目中引入下载的 js 文件
3、GitHub 仓库中查看相应用法

相应案例:

<!DOCTYPE html>
<html>

<head>
	<meta charset="UTF-8" />
	<title>过滤器</title>
	<script type="text/javascript" src="../js/vue.js"></script>
	<script type="text/javascript" src="../js/dayjs.min.js"></script>
</head>

<body>
	<div id="root">
		<h2>显示格式化后的时间</h2>
		<!-- 计算属性实现 -->
		<h3>现在是:{{fmtTime}}</h3>
		<!-- methods实现 -->
		<h3>现在是:{{getFmtTime()}}</h3>
		<!-- 过滤器实现 局部过滤器-->
		<h3>现在是:{{time | timeFormater}}</h3>
		<!-- 过滤器实现(传参) -->
		<h3>现在是:{{time | timeFormater('YYYY_MM_DD') | mySlice}}</h3>
		<!-- v-bind 可在控制台中查看相应变化 -->
		<h2 :x="msg | mySlice">Vue 学习</h2>
		<!-- 全局过滤器-->
		<h2>{{msg | mySlice}}</h2>
	</div>
</body>

<script type="text/javascript">
	Vue.config.productionTip = false  // 阻止 Vue 在启动时生成生产提示
	//全局过滤器
	Vue.filter('mySlice', function (value) {
		return value.slice(0, 4)
	})

	new Vue({
		el: '#root',
		data: {
			time: 1621561377603, //时间戳
			msg: 'hello'
		},
		computed: {
			fmtTime() {
				return dayjs(this.time).format('YYYY年MM月DD日 HH:mm:ss')
			}
		},
		methods: {
			getFmtTime() {
				return dayjs(this.time).format('YYYY年MM月DD日 HH:mm:ss')
			}
		},
		//局部过滤器
		filters: {
			timeFormater(value, str = 'YYYY年MM月DD日 HH:mm:ss') {
				return dayjs(value).format(str)
			}
		}
	})
</script>

</html>

效果展示:

Logo

前往低代码交流专区

更多推荐