环境介绍:Nodejs:14.18.0、Vite:2.7.10、Vue:3.2.26、依赖安装采用pnpm。
第一部分:环境搭建
一、使用 pnpm创建一个vite程序
$ pnpm create vite
二、安装vite插件:@vitejs/plugin-vue-jsx
$ pnpm i @vitejs/plugin-vue-jsx
三、在vite.config.js加入jsx配置
// vite.config.js import { defineConfig } from 'vite' import vueJsx from '@vitejs/plugin-vue-jsx' import vue from '@vitejs/plugin-vue' // https://vitejs.dev/config/ export default defineConfig({ plugins: [vue(), vueJsx()], })
至此,我们新建的这个vite项目已经全面支持jsx语法了。
第二部分、改造App.vue为App.jsx
jsx语法的组件命名需采用大驼峰式命名规则。
jsx文件内容的写法跟使用模板语法时,script标签内容中的写法一模一样,可以直接导出一个对象,也可以从vue中导入一个defineComponent函数,然后默认导出defineComponent函数,并传入一个对象。
注:在模板语法中setup函数选项需return出一个对象,而在jsx语法中setup需return出一个箭头函数,所有原先在template标签中书写的内容需写在该函数体内,并且函数体只能有一个根标签。
// App.js import { defineComponent } from "vue"; import HelloWorld from "./components/HelloWorld.vue"; import Logo from "./assets/logo.png"; export default defineComponent({ name: "App", components: { HelloWorld }, setup() { return () => ( <> <img alt="Vue logo" src="/{Logo}" /> <HelloWorld msg="Hello Vue 3 + Vite" /> </> ); }, });
第三部分:组件定义:
一、定义函数式组件
const App = () => <div>Vue 3.0</div>;
二、在函数式组件使用render函数
const App = { render() { return <div>Vue 3.0</div>; }, };
三、推荐写法(除了指令、样式其余跟模板语法无异)
import { defineComponent } from "vue" export default defineComponent({ setup() { return () => { <div className="nameInfo">欢迎</div> } } })
第四部分、语法介绍
一、样式相关语法介绍
1、如直接导入css文件,则该文件中的class类名可在项目的任何组件中使用,相当于全局类名(属性名class需要写成className)。
// App.css .nameInfo{ color:red; } // App.jsx import { defineComponent } from "vue" import "./App.css" export default defineComponent({ setup() { return () => { <div className="nameInfo">欢迎~</div> } } })
2、vite天然支持CSS modules,任何以 .module.css 为后缀名的 CSS 文件都被认为是一个 CSS modules文件。导入这样的文件会返回一个相应的模块对象:
/* example.module.css */ .red { color: red; } import { defineComponent } from "vue" import style from "./example.module.css" export default defineComponent({ setup() { return () => { <div className={style.red}>欢迎~</div> } } })
3、内联样式写法。
import { defineComponent } from "vue" export default defineComponent({ setup() { return () => { <div style={{ color: "red" }}>欢迎~</div> } } })
二、vue常用指令语法
1、v-text
import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", setup() { const text = ref("欢迎"); return () => ( <> <h1 v-text={text.value}></h1> </> ); }, });
2、v-html
import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", setup() { const text = ref("欢迎"); return () => ( <> <h1 v-html={text.value}></h1> </> ); }, });
3、v-show
import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", setup() { const visible = ref(true); setTimeout(() => { visible.value = false; }, 2000); return () => ( <> <div v-show={visible.value} style={{ color: "red" }}> 欢迎 </div> </> ); }, });
4、v-if、v-else-if、v-else无法直接使用,需使用逻辑与、逻辑或、三元表达式实现条件渲染。
import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", setup() { const h1Show = ref(true); const h2Hide = ref(false); const h3Show = ref(true); return () => ( <> {h1Show.value && <h1>这个显示</h1>} {h2Hide.value && <h2>这个不显示</h2>} {h3Show.value ? <h3>h3Show.value为true显示</h3> : <h3>h3Show.value为false显示</h3>} </> ); }, });
5、v-for无法直接使用,需使用map去实现循环遍历渲染。
import { defineComponent, reactive } from "vue"; export default defineComponent({ name: "HelloWorld", setup() { const list = reactive([1, 2, 3]); return () => ( <> {list.map(item => ( <h1>值为:{item}</h1> ))} </> ); }, });
6、v-on无法直接使用,需使用原生绑定事件方式去实现,因此无法使用事件修饰符。
// 不需要传值 import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", setup() { const myName = ref("~WEB前端~"); const changName = () => { myName.value = "欢迎"; }; return () => ( <> <button onClick={changName}>{myName.value}</button> </> ); }, });
// 传值的写法(高阶函数) import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", props: ["msg"], setup() { const myName = ref("~WEB前端~"); const changName = value => { console.log("value", value); myName.value = "欢迎"; }; return () => ( <> <button onClick={() => changName("欢迎")}>{myName.value}</button> </> ); }, });
// 获取事件对象 import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", props: ["msg"], setup() { const myName = ref("~WEB前端~"); const changName = (event, value) => { console.log("event", event); console.log("value", value); myName.value = "欢迎"; }; return () => ( <> <button onClick={event => changName(event, "欢迎~")}>{myName.value}</button> </> ); }, });
7、 v-bind(需注意以下三点)
1、标签属性值如果需要一个变量,需要按照 属性名={变量名} 的形式书写,并且属性名前不能带 “:” ;
2、如果是ref包装之后的响应式变量,需要按照 属性名={变量名.value} 的形式书写;
3、图片资源需先导入后使用,如下示例中的logo图片资源,
import { defineComponent, ref } from "vue" import Logo from "./assets/logo.png" export default defineComponent({ setup() { const altText = ref("Vue logo") return () => { <img alt={ altText.value } src={ Logo } /> } } })
8、v-model
import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", setup() { const text = ref("WEB前端~"); return () => ( <> <h1>{text.value}</h1> <input v-model={text.value} placeholder="~WEB前端~" /> </> ); }, });
9、v-slot,在jsx中v-slot,需要写成v-slots
// HelloWorld.jsx import { defineComponent, ref } from "vue"; export default defineComponent({ name: "HelloWorld", props: ["msg"], setup(props, { slots }) { return () => ( <> <h1>{slots.default ? slots.default() : "WEB前端"}</h1> <h2>{slots.bar?.()}</h2> </> ); }, });
第一种:
// App.jsx import { defineComponent } from "vue"; import HelloWorld from "./components/HelloWorld.jsx"; export default defineComponent({ name: "App", components: { HelloWorld }, setup() { const slots = { bar: () => <span>这个会渲染到h2中</span>, }; return () => ( <> <HelloWorld v-slots={slots}> <div>这个会渲染到H1中</div> </HelloWorld> </> ); }, });
第二种:
// App.jsx import { defineComponent } from "vue"; import HelloWorld from "./components/HelloWorld.jsx"; export default defineComponent({ name: "App", components: { HelloWorld }, setup() { const slots = { default: () => <div>这个会渲染到H1中</div>, bar: () => <span>这个会渲染到h2中</span>, }; return () => ( <> <HelloWorld v-slots={slots} /> </> ); }, });
第三种:
// App.jsx // h1当中渲染子组件默认的 // h2当中则渲染父组件传入的bar组件内容 import { defineComponent } from "vue"; import HelloWorld from "./components/HelloWorld.jsx"; export default defineComponent({ name: "App", components: { HelloWorld }, setup() { const slots = { bar: () => <span>这个会渲染到h2中</span>, }; return () => ( <> <HelloWorld v-slots={slots} /> </> ); }, });
10、v-pre、v-cloak、v-once、v-memo 四个指令暂时未研究出来如何在jsx中去实现,欢迎补充。
第五部分、安装组件库(以Naive UI为例)
一、使用 pnpm安装naive-ui依赖
$ pnpm install naive-ui
1
二、建议按需引入,在使用组件库组件时,标签名应采用大驼峰式书写格式
import { defineComponent, ref } from "vue"; import { NButton } from "naive-ui"; export default defineComponent({ name: "HelloWorld", props: ["msg"], components: { NButton }, setup() { const myName = ref("~WEB前端~"); const changName = (event, value) => { console.log("event", event); console.log("value", value); myName.value = "~WEB前端~"; }; return () => ( <> <NButton type="primary" onClick={event => changName(event, "~WEB前端~")}> {myName.value} </NButton> </> ); }, });
至此如何在vue中使用jsx语法内容全部讲完!!!