https://github.com/vuejs/babel-plugin-jsx#installation
Vue 3 Babel JSX 插件
以 JSX 的方式来编写 Vue 代码
安装
npm install @vue/babel-plugin-jsx -D
配置 Babel
{ "plugins": ["@vue/babel-plugin-jsx"] }
参数
transformOn
Type:
boolean
Default:
false
把
on: { click: xx }
转成onClick: xxx
optimize
Type:
boolean
Default:
false
是否开启优化. 如果你对 Vue 3 不太熟悉,不建议打开
isCustomElement
Type:
(tag: string) => boolean
Default:
undefined
自定义元素
mergeProps
Type:
boolean
Default:
true
合并 class / style / onXXX handlers
enableObjectSlots
使用
enableObjectSlots
(文档下面会提到)。虽然在 JSX 中比较好使,但是会增加一些_isSlot
的运行时条件判断,这会增加你的项目体积。即使你关闭了enableObjectSlots
,v-slots
还是可以使用
pragma
Type:
string
Default:
createVNode
替换编译JSX表达式的时候使用的函数
表达式内容
函数式组件
const App = () => <div></div>;
在 render 中使用
const App = {
render() {
return <div>Vue 3.0</div>;
},
};
import { withModifiers, defineComponent } from "vue";
const App = defineComponent({
setup() {
const count = ref(0);
const inc = () => {
count.value++;
};
return () => (
<div onClick={withModifiers(inc, ["self"])}>{count.value}</div>
);
},
});
Fragment(没有根标签,用 <></>)
const App = () => (
<>
<span>I'm</span>
<span>Fragment</span>
</>
);
属性绑定:
const App = () => <input type="email" />;
动态绑定:
const placeholderText = "email";
const App = () => <input type="email" placeholder={placeholderText} />;
指令
v-show
const App = {
data() {
return { visible: true };
},
render() {
return <input v-show={this.visible} />;
},
};
v-model
注意:如果想要使用
arg
, 第二个参数需要为字符串
<input v-model={val} />
<input v-model:argument={val} />
<input v-model={[val, ["modifier"]]} />
<A v-model={[val, "argument", ["modifier"]]} />
会变编译成:
h(A, {
argument: val,
argumentModifiers: {
modifier: true,
},
"onUpdate:argument": ($event) => (val = $event),
});
v-models (从 1.1.0 开始不推荐使用)
注意: 你应该传递一个二维数组给 v-models。
<A v-models={[[foo], [bar, "bar"]]} />
<A
v-models={[
[foo, "foo"],
[bar, "bar"],
]}
/>
<A
v-models={[
[foo, ["modifier"]],
[bar, "bar", ["modifier"]],
]}
/>
会变编译成:
h(A, {
modelValue: foo,
modelModifiers: {
modifier: true,
},
"onUpdate:modelValue": ($event) => (foo = $event),
bar: bar,
barModifiers: {
modifier: true,
},
"onUpdate:bar": ($event) => (bar = $event),
});
自定义指令
只有 argument 的时候推荐使用
const App = {
directives: { custom: customDirective },
setup() {
return () => <a v-custom:arg={val} />;
},
};
const App = {
directives: { custom: customDirective },
setup() {
return () => <a v-custom={[val, "arg", ["a", "b"]]} />;
},
};
插槽
注意: 在
jsx
中,应该使用v-slots
代替v-slot
const A = (props, { slots }) => (
<>
<h1>{ slots.default ? slots.default() : 'foo' }</h1>
<h2>{ slots.bar?.() }</h2>
</>
);
const App = {
setup() {
const slots = {
bar: () => <span>B</span>,
};
return () => (
<A v-slots={slots}>
<div>A</div>
</A>
);
},
};
// or
const App = {
setup() {
const slots = {
default: () => <div>A</div>,
bar: () => <span>B</span>,
};
return () => <A v-slots={slots} />;
},
};
// 或者,当 `enableObjectSlots` 不是 `false` 时,您可以使用对象插槽
const App = {
setup() {
return () => (
<>
<A>
{{
default: () => <div>A</div>,
bar: () => <span>B</span>,
}}
</A>
<B>{() => "foo"}</B>
</>
);
},
};
在 TypeScript 中使用
tsconfig.json
:
{ "compilerOptions": { "jsx": "preserve" } }
因为对 vue 还是不是特别熟,导致我上次一直不知道 emit 该如何绑定
其实 emit 绑定只需要在函数前面加 on,例如:
// parent
const App = (
<Component onHandleClick={ /** ...func */ }></Component>
)
// component
const emit = define('handleClick')
emit('handleClick')