Vue 3语音输入组件通过封装Web Speech API实现纯前端语音识别,支持v-model双向绑定、表单校验集成、状态反馈与跨浏览器降级,具备无障碍支持和可复用性。

Vue 3 中实现带语音录入功能的自定义表单组件,核心是把 Web Speech API 的语音识别能力封装进可复用、可双向绑定的输入框组件里,并与表单校验、状态管理自然融合。不需要后端转写,纯前端即可完成基础识别。
使用原生 SpeechRecognition 封装输入框
浏览器(Chrome/Edge)原生支持 SpeechRecognition,无需引入第三方 SDK。关键点在于:识别实例需手动创建并管理生命周期,避免重复初始化或内存泄漏;识别结果要实时同步到 v-model 绑定的数据上。
- 在
setup()中用ref创建transcript响应式字段,作为组件的 v-model 绑定源 - 检测全局是否存在
window.SpeechRecognition或window.webkitSpeechRecognition,不存在时降级为普通文本框 - 识别对象的
onresult回调中取event.results[0][0].transcript更新 transcript;onend和onerror中重置状态并提示用户 - 提供
start()和stop()方法供父组件或按钮调用,也可绑定到长按/点击事件
支持 v-model 双向绑定与表单集成
要让组件像 <el-input></el-input> 一样被 v-model 使用,需遵循 Vue 的输入组件规范:暴露 modelValue prop 并触发 update:modelValue 事件。
- 定义
props: { modelValue: String }和emits: ['update:modelValue'] - 识别结果更新时调用
emit('update:modelValue', newTranscript) - 同时监听外部传入的
modelValue变化(比如表单重置),同步更新内部显示内容 - 若搭配 Element Plus,可直接传入
:rules和ref="formItemRef",由<el-form-item></el-form-item>统一接管验证状态
添加语音控制 UI 与用户体验细节
纯功能还不够,用户需要明确的反馈和操作入口。一个成熟的语音输入框应包含状态指示、启停控制和容错提示。
立即学习“前端免费学习笔记(深入)”;
- 用图标按钮(?)替代默认 placeholder,点击/长按切换录音状态;正在识别时显示脉冲动画或文字提示“正在听…”
- 识别结束后自动停止,避免持续监听;支持手动点击停止按钮中断
- 识别失败时展示简短错误信息(如“未检测到语音”“网络异常”),不打断表单流程
- 可选:添加“追加模式”开关,让用户决定新识别内容是覆盖还是拼接到已有文本末尾
适配不同框架与无障碍要求
真正可落地的组件要考虑兼容性和可访问性。
- Firefox 不支持 SpeechRecognition,需 fallback 到手动输入,并隐藏语音按钮或灰显提示
- Safari 仅部分支持,且首次使用需用户主动授权麦克风,建议在点击前弹出友好引导
- 为按钮添加
aria-label="语音输入",识别中设置aria-busy="true",提升屏幕阅读器体验 - 若项目已用 TanStack Form 或 VeeValidate,可在组件内透传
field对象,自动接入校验链路


















