如何在 Vue 3 单文件组件中正确传递与使用 props

碧海醫心

发布时间：2025-12-31 18:38:02

569人浏览过

来源于php中文网

原创

如何在 Vue 3 单文件组件中正确传递与使用 props

本文详解 vue 3 中 props 的声明、传递与渲染方法，指出常见语法错误（如误用 `{}` 包裹绑定值），并通过修正示例说明如何正确将数据作为 prop 传入子组件并安全显示。

在 Vue 3 的单文件组件（SFC）中，props 是父组件向子组件传递数据的核心机制。你遇到的问题——子组件中 {{ title }} 渲染出 {"title": "Home"} 这样的字符串化对象——根本原因在于 模板中错误地使用了 :title={title} 语法，导致 Vue 将其解析为一个字面量 JavaScript 对象，而非响应式数据绑定。

✅ 正确的 props 传递方式：使用 v-bind 简写 : + 双引号

在

组件调用处，应使用标准的绑定语法：<pre class="brush:php;toolbar:false;"><template> <div>  <Title :title="title" :styling="styling" /> </div> </template></pre><p>⚠️ 错误写法 :title={title} 会被 Vue 解析为 title: { title: title }（即一个键为 "title" 的对象），因此子组件接收到的 props.title 实际上是一个对象，而非字符串 "Home"。这就是你在 UI 上看到 {"title": "Home"} 的原因。</p> <h3>✅ 子组件中正确声明与使用 props</h3> <p>你的 Title.vue 中 props 声明基本正确，但建议升级为 Vue 3 推荐的组合式 API 风格（或至少保持选项式 API 的完整性）。以下是优化后的版本（仍基于选项式 API，兼容性更好）：</p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/ai/2069" title="稿定AI绘图"><img src="https://img.php.cn/upload/ai_manual/000/000/000/175680133014200.png" alt="稿定AI绘图"></a> <div class="aritcle_card_info flexColumn"> <a href="/ai/2069" title="稿定AI绘图">稿定AI绘图</a> <p>稿定推出的AI绘画工具</p> </div> <a href="/ai/2069" title="稿定AI绘图" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div> <p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）</a>”；</p><pre class="brush:php;toolbar:false;"> <template> <div>  <h5 :class="styling">{{ title }}</h5> </div> </template> <script> export default { name: 'Title', props: { title: { type: String, required: true, default: 'Untitled' }, styling: { type: String, default: '' } } } </script></pre><blockquote>? 补充说明： :class="styling" 比 class={styling} 更规范（后者是非法语法，Vue 会报错或降级为静态 class）；为 props 添加 default 值可提升组件健壮性，避免未传参时渲染异常； type: String 已确保类型校验，若传入非字符串（如对象），开发环境下会触发警告。</blockquote> <h3>? 完整可运行示例（Home.vue）</h3><pre class="brush:php;toolbar:false;"> <template> <div> <Title :title="title" :styling="styling" /> </div> </template> <script> import Title from '../components/Title' export default { name: 'Home', data() { return { title: 'Home', // 字符串，非对象 styling: 'text-center' } }, components: { Title } } </script></pre><h3>? 总结：三大关键点</h3> <ul> <li> <strong>绑定语法无 {}</strong>：v-bind:title="title" 或简写 :title="title"，<strong>不是</strong> :title={title}； </li> <li> <strong>子组件必须显式声明 props</strong>：通过 props 选项定义类型、是否必填及默认值； </li> <li> <strong>模板中直接使用 {{ title }} 即可</strong>：无需解构或额外处理，Vue 自动提供响应式访问。</li> </ul> <p>掌握这些基础规则，就能避免绝大多数 props 传递和渲染问题。随着深入学习，推荐逐步迁移到 Vue 3 的 <script setup> 组合式 API，它语法更简洁、类型推导更友好（尤其搭配 TypeScript）。</script></p>

Vue 3 中实现多步表单数据收集与状态管理的完整方案

Vue 3 中实现多级表单数据收集与状态管理的完整方案

Vue 3 动态表单数据收集：为每层循环独立保存用户选择

如何在 Vue 前端正确初始化 Plaid Link SDK

如何在 Vue 项目中正确初始化 Plaid Link SDK

相关专题

js获取数组长度的方法

在js中，可以利用array对象的length属性来获取数组长度，该属性可设置或返回数组中元素的数目，只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值，也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容，供大家免费下载使用。

541

2023.06.20

js刷新当前页面

js刷新当前页面的方法：1、reload方法，该方法强迫浏览器刷新当前页面，语法为“location.reload([bForceGet]) ”；2、replace方法，该方法通过指定URL替换当前缓存在历史里（客户端）的项目，因此当使用replace方法之后，不能通过“前进”和“后退”来访问已经被替换的URL，语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

372

2023.07.04

js四舍五入

js四舍五入的方法：1、tofixed方法，可把 Number 四舍五入为指定小数位数的数字；2、round() 方法，可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

727

2023.07.04

js删除节点的方法

js删除节点的方法有：1、removeChild()方法，用于从父节点中移除指定的子节点，它需要两个参数，第一个参数是要删除的子节点，第二个参数是父节点；2、parentNode.removeChild()方法，可以直接通过父节点调用来删除子节点；3、remove()方法，可以直接删除节点，而无需指定父节点；4、innerHTML属性，用于删除节点的内容。

470

2023.09.01

JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号，可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容，供大家免费下载体验。

391

2023.09.04

js生成随机数的方法

js生成随机数的方法有：1、使用random函数生成0-1之间的随机数；2、使用random函数和特定范围来生成随机整数；3、使用random函数和round函数生成0-99之间的随机整数；4、使用random函数和其他函数生成更复杂的随机数；5、使用random函数和其他函数生成范围内的随机小数；6、使用random函数和其他函数生成范围内的随机整数或小数。

990

2023.09.04

如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍：1、内联脚本是将JavaScript代码直接嵌入到HTML标签中；2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中；3、外部脚本是将JavaScript代码放置在一个独立的文件；4、外部脚本是将JavaScript代码放置在一个独立的文件。

653

2023.09.12

Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型，用于表示独一无二的值。Symbol的特点：1、独一无二，每个Symbol值都是唯一的，不会与其他任何值相等；2、不可变性，Symbol值一旦创建，就不能修改或者重新赋值；3、隐藏性，Symbol值不会被隐式转换为其他类型；4、无法枚举，Symbol值作为对象的属性名时，默认是不可枚举的。

543

2023.09.20