uni-app如何定义全局过滤器

胖宇小哥_2888

胖宇小哥_2888

2026-09-02

848人浏览

原创

vue.filter 仅在 h5 端有效,小程序和 app 端因渲染机制不支持管道语法而失效;跨端应改用纯函数封装+显式调用或 computed,金额等场景优先使用 intl.numberformat。

uni-app如何定义全局过滤器

Vue.filter 在 Vue 2 模式下可用,但仅限 H5 端有效;小程序(微信/支付宝/字节)和 App 端基本不执行,别依赖它做跨端格式化。

为什么全局过滤器在小程序里不生效

不是你写错了,是 uni-app 编译机制决定的:Vue.filter 注册的过滤器只在 Vue 2 的 template 编译阶段被 H5 渲染器识别,而小程序端使用自定义组件树 + JSON 数据驱动,| 语法根本不会被解析——模板里写 {{ date | formatDate }},真机上就原样输出,不报错也不执行。

main.js 里写 Vue.filter 有用吗

只对 H5 有效,其他端无效。常见错误现象:

  • Vue.filter('formatDate', ...) 写了,H5 正常,微信开发者工具里没反应
  • 页面里用 {{ timestamp | formatDate }},小程序真机调试时显示 NaN-NaN-NaN 或直接空字符串
  • 支付宝小程序构建后过滤器完全消失,控制台也无 warning

原因:各端底层渲染引擎不支持 filter 管道语法,且 uni-app 小程序平台未做 polyfill。

真正能跨端用的替代方案

放弃 filters 对象和 Vue.filter,改用函数封装 + 显式调用:

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • 在 @/utils/filters.js 里导出纯函数:
    export const formatDate = (date) => {
      if (!date) return ''
      const d = new Date(date)
      return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`
    }
  • 在页面 setup 中导入并使用:
    import { formatDate } from '@/utils/filters'
    // ...
    const formattedDate = formatDate(item.createTime)
  • 需要模板中直接用?用计算属性或 computed:
    const displayDate = computed(() => formatDate(props.item.time))

金额、千分位等更复杂场景,优先用 Intl.NumberFormat 实例,别手写正则——它在微信基础库 2.19.0+、支付宝 10.2.80+、iOS Safari 和 Android Chrome 均稳定支持。

如果项目必须用 Vue 2 且只跑 H5

可以保留 Vue.filter,但注意两个坑:

  • new Date(date) 传入字符串时,iOS Safari 对 "2022-03-08" 格式支持差,建议统一转成时间戳或加兼容处理
  • getDay() 返回的是星期几(0–6),不是日期,容易误写成 ndate.getDay() 导致显示“2022-3-2”这种错误结果

正确写法是 ndate.getDate(),这个细节在多个博客示例里都写错了,复制即翻车。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

2026.10.22

0

15

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

2026.10.22

0

12

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理,讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

2026.10.22

0

16

剧云故事大纲与分场规划教程
剧云故事大纲与分场规划教程

本专题讲解剧云梗概与多级大纲功能,覆盖全局、分集、分场结构生成,以及主线冲突、剧情节点和场次顺序调整。

2026.10.22

0

15

VibeKnow PPT讲解视频教程汇总
VibeKnow PPT讲解视频教程汇总

本专题介绍VibeKnow PPT讲解模式的素材准备、旁白生成、页面节奏、画面呈现与导出设置,适合课程和培训场景。

2026.10.22

0

16

VibeKnow PDF转视频教程合集
VibeKnow PDF转视频教程合集

本专题围绕VibeKnow的PDF转视频功能,讲解文件准备、内容解析、脚本生成、重点可视化及配音字幕检查方法。

2026.10.22

0

12

二狗PPT模板与视觉设计
二狗PPT模板与视觉设计

本专题介绍二狗PPT的职场模板、主题风格与页面版式,覆盖模板切换、色彩选择、内容匹配和正式汇报场景下的视觉优化方法。

2026.10.22

0

13

php漏洞修复方法
php漏洞修复方法

PHP漏洞聚合专题,持续整理PHP最新高危漏洞、CVE安全预警、受影响版本、自查命令及修复方案,覆盖PHP-FPM、Docker、Ubuntu与Linux服务器环境,帮助开发者快速完成漏洞排查、版本升级和安全加固。

2026.10.22

20

31

二狗PPT入门与基础操作
二狗PPT入门与基础操作

本专题整理二狗PPT从官网进入、输入主题、生成大纲到制作成稿的基础操作,帮助新手掌握AI一键生成职场PPT的完整流程。

2026.10.22

0

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习