Vue 表单数据和过滤器

Vue 凭借响应式系统和双向绑定机制,为表单数据收集提供了简洁优雅的实现方案,从基础的原生元素绑定到复杂的动态表单、可编辑表格、多级联动场景,都能通过分层设计的思路实现可维护、可扩展的代码架构。

1.Vue 表单数据收集

在 Vue 3 中,v-model 本质是一个语法糖,它自动帮开发者完成了"数据向下传递 + 事件向上抛出"的两步操作,在原生表单元素上,v-model 等价于 :value 绑定加上 @input 事件监听。比如最基础的用户名输入框代码:

html 复制代码
<template>
<input v-model="username" />
</template>
<script setup>
import { ref } from 'vue'
const username = ref('')
</script>
这段代码完全等价于手动实现的双向绑定逻辑:
<template>
<input :value="username" @input="username = $event.target.value" />
</template>

全类型表单元素的数据绑定

html 复制代码
<template>
<form @submit.prevent="handleSubmit">
<!-- 文本输入 -->
<div>
<label>用户名:</label>
<input v-model.trim="userInfo.name" placeholder="请输入用户名" />
</div>
<!-- 数字输入 -->
<div>
<label>年龄:</label>
<input v-model.number="userInfo.age" type="number" placeholder="请输入年龄" />
</div>
<!-- 单选框 -->
<div>
<label>性别:</label>
<input type="radio" v-model="userInfo.gender" value="male" />男
<input type="radio" v-model="userInfo.gender" value="female" />女
</div>
<!-- 多选框 -->
<div>
<label>兴趣爱好:</label>
<input type="checkbox" v-model="userInfo.hobbies" value="reading" />阅读
<input type="checkbox" v-model="userInfo.hobbies" value="sports" />运动
<input type="checkbox" v-model="userInfo.hobbies" value="music" />音乐
</div>
<!-- 下拉选择 -->
<div>
<label>所在城市:</label>
<select v-model="userInfo.city">
<option value="">请选择城市</option>
<option value="guangzhou">广州</option>
<option value="shenzhen">深圳</option>
<option value="dongguan">东莞</option>
</select>
</div>
<!-- 协议勾选 -->
<div>
<input type="checkbox" v-model="userInfo.agreed" />
<label>同意用户服务协议</label>
</div>
<button type="submit">提交表单</button>
</form>
</template>
<script setup>
import { reactive } from 'vue'
const userInfo = reactive({
name: '',
age: null,
gender: '',
hobbies: [],
city: '',\
agreed: false
})
const handleSubmit = () => {
console.log('收集到的表单数据:', JSON.stringify(userInfo, null, 2))
// 后续可直接发起接口请求提交数据
}
</script>

2.Vue过滤器

Vue过滤器的官方定义是"用于对文本进行格式化的特殊功能函数",但这个描述远不能体现它的设计价值。

从底层逻辑来看,过滤器是Vue在模板表达式中嵌入的一套轻量数据处理管道机制,它允许开发者以声明式的方式,在不侵入业务逻辑代码的前提下,完成数据的标准化展示。

全局过滤器通过Vue.filter()方法注册,必须在创建Vue根实例之前完成定义,这样它才能在项目的所有组件模板中被直接调用。这种注册方式非常适合封装全项目通用的格式化逻辑,比如全局统一的日期格式化、货币格式化、文本截断工具。举个典型的全局日期过滤器的实现:

javascript 复制代码
Vue.filter('dateFormat', function(value, format = 'YYYY-MM-DD') {
  if (!value) return ''
  const date = new Date(value)
  const year = date.getFullYear()
  const month = String(date.getMonth() + 1).padStart(2, '0')
  const day = String(date.getDate()).padStart(2, '0')
  if (format === 'YYYY-MM-DD HH:mm') {
    const hour = String(date.getHours()).padStart(2, '0')
    const minute = String(date.getMinutes()).padStart(2, '0')
    return `${year}-${month}-${day} ${hour}:${minute}`
  }
  return `${year}-${month}-${day}`
})

局部过滤器则是在组件内部的filters选项中定义,它的作用域被严格限制在当前组件内,只有该组件的模板可以调用它。这种模式适合封装和当前业务强绑定、复用性不高的定制化格式化逻辑,比如某个订单管理页面独有的订单状态文本转换、特定业务字段的脱敏处理。局部过滤器的定义方式非常简单:

javascript 复制代码
export default {
  name: 'OrderList',
  filters: {
    orderStatusText(value) {
      const statusMap = {
        0: '待支付',
        1: '已支付',
        2: '已发货',
        3: '已完成',
        4: '已取消'
      }
      return statusMap[value] || '未知状态'
    },
    phoneMask(value) {
      if (!value) return ''
      return value.replace(/(\d{3})\d{4}(\d{4})/, '$1****$2')
    }
  }
}
相关推荐
oil欧哟41 分钟前
Oil UI 的设计思路与日常使用方式:让 AI 摆脱默认模板并保持多页面风格统一
前端
恋猫de小郭1 小时前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
头发还在的女程序员1 小时前
智慧物业源码解析:房屋档案与业主变更怎样保持历史业务连续
前端·javascript·vue.js·物业管理·小区物业·智慧物业
JianZhen✓2 小时前
电商 SKU 选择器:后端只给扁平列表,前端怎么反推规格矩阵并做到 O(1) 命中
前端·矩阵·状态模式
feixing_fx10 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx11 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
程序员大阳11 小时前
副队长Vue3教程(8)--列表渲染 v-for
javascript·vue3·v-for·列表渲染
JavaGuide13 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
孟健15 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程