vue.js引入jsx提升动态组件表达力与可维护性,支持动态标签、插槽组合及渲染逻辑复用;vue 3原生支持并需显式导入h函数;typescript通过props、slots、emitsoptions接口保障类型安全。

Vue.js 渲染函数开发中引入 JSX,核心目标是提升动态组件、高阶组件和逻辑复用场景下的表达力与可维护性;类型推断则确保在使用 JSX 编写 render 函数时,props、slots、事件等关键结构具备完整的 TypeScript 支持,避免运行时错误。
JSX 在渲染函数中的实际价值
当组件行为高度依赖运行时条件(如动态标签名、嵌套层级、插槽组合)时,模板语法容易变得冗长或不可控。JSX 直接暴露 JavaScript 的控制能力,让 render 逻辑更贴近业务意图。
- 动态生成标签:比如
const tag = `h${this.level}`; return <tag>{this.$slots.default}</tag>; - 条件组合插槽:可对
this.$slots做 map/filter/reduce,再传入子组件,模板无法直接实现这类操作 - 封装渲染逻辑:将重复的 DOM 结构抽象为函数(如表单控件渲染器),在多个组件中复用,比 mixins 或 scoped slots 更清晰
Vue 2 与 Vue 3 中 JSX 的配置差异
Vue 2 需手动集成 Babel 插件,Vue 3 则原生支持并推荐搭配 h 函数使用,且与 Composition API 天然契合。
-
Vue 2:安装
@vue/babel-preset-jsx,配置 Babel 预设,并确保render方法返回 JSX 表达式 -
Vue 3:无需额外插件(Vite 或 Vue CLI 默认启用),
setup()中可直接返回 JSX;若使用<script setup></script>,需配合defineComponent或显式导出render函数 - 注意:Vue 3 的 JSX 不再默认注入
h,需显式 import:import { h } from 'vue'
TS 类型推断如何保障 JSX 安全性
JSX 本身不带类型信息,但结合 TypeScript 接口定义,可为 props、事件、插槽提供完整校验。
- 定义组件 props 接口,再通过
defineProps<myprops>()</myprops>或export default defineComponent({ props: {...} })绑定,JSX 中访问this.props.xxx或props.xxx会获得精准提示与检查 - 插槽类型可通过
Slots工具类型约束:interface Slots { default?: (props: {}) => any; header?: (props: { title: string }) => any; } - 事件类型建议用
EmitsOptions显式声明:emits: ['update:modelValue', 'change-data'],JSX 中onUpdate:modelValue写法会被 TS 校验参数结构
常见陷阱与规避建议
JSX 灵活的同时也放大了手误风险,类型系统是第一道防线。
- 事件绑定写法不同:Vue 模板中
@click.stop对应 JSX 中需手动处理:on: { click: (e) => { e.stopPropagation(); ... } },TS 无法校验修饰符,但可校验事件回调签名 - 属性传递易混淆:
attrs(HTML 原生属性)、props(组件 prop)、domProps(DOM property)三者语义不同,接口定义时需明确区分字段归属 - 插槽作用域丢失:在 JSX 中使用
this.$slots.default?.()时,若未标注插槽类型,TS 可能推断为any;应配合Slots显式声明返回 VNode[]
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











