如何在 vue3 中使用 jsx/tsx?_ZenDei技術網路在線

我們都知道,通常情況下我們使用 vue 大多都是用的 SFC(Signle File Component)單文件組件模式,即一個組件就是一個文件,但其實 Vue 也是支持使用 JSX 來編寫組件的。這裡不討論 SFC 和 JSX 的好壞,這個仁者見仁智者見智。本篇文章旨在帶領大家快速瞭解和使用 Vu ...

我們都知道,通常情況下我們使用 vue 大多都是用的 SFC(Signle File Component)單文件組件模式,即一個組件就是一個文件,但其實 Vue 也是支持使用 JSX 來編寫組件的。這裡不討論 SFC 和 JSX 的好壞,這個仁者見仁智者見智。本篇文章旨在帶領大家快速瞭解和使用 Vue 中的 JSX 語法,好讓大家在 Vue 中遇到或使用 JSX 的時候能很快入手

JSX 如何用

這裡以vite項目為例,要想在項目中使用 JSX,我們需要安裝一個插件@vitejs/plugin-vue-jsx,這個插件可以讓我們在項目中使用 JSX/TSX

npm i @vitejs/plugin-vue-jsx -D

安裝完成之後在vite.config.ts進行一個配置即可

import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
import vueJsx from "@vitejs/plugin-vue-jsx";
// https://vitejs.dev/config/
export default defineConfig({
  plugins: [vue(), vueJsx()],
});

接下來我們看一下如何使用 JXS?

首先第一種方式就是在.vue文件中使用,需要將 script 中的 lang 設置為tsx,在 setup 函數中返回模板

<script lang="tsx">
import { defineComponent } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    return () => <div>Hello World</div>;
  },
});
</script>

或者將.vue改成.tsx,註意:如果尾碼為.tsx,需要將引入到這個組件的路徑尾碼去掉

import { defineComponent } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    return () => <div>Hello World</div>;
  },
});

//main.ts中引入
import { createApp } from "vue";
import "./style.css";
import App from "./App";

createApp(App).mount("#app");

此時頁面上就會展示一個Hello World

第二種方式是函數式組件,因為函數式組件里沒有 this 引用，所以 Vue 把 props 當作第一個參數傳入,第二個參數 ctx 包含三個屬性：attrs、emit 和 slots。它們分別相當於組件實例的 attrs、attrs、attrs、emit 和 $slots 這幾個屬性。

//App.tsx
export default (props, ctx) => <div>Hello World</div>;

到這裡我們不難發現,TSX 相比於 SFC 有一個特點,那就是它可以在一個文件中定義多個組件模板,比如

const Component1 = () => <div>Component1</div>;
const Component2 = () => <div>Component2</div>;

export default () => (
  <div>
    <Component1 />
    <Component2 />
  </div>
);

此時頁面中便出現了我們定義的兩個組件

接下來我們來看一下 JSX 在 vue 中的具體用法

插值

在 SFC 中使用插值的時候我們可以使用{{}}進行包裹,而在 JSX 中是使用{}進行包裹,例如

import { defineComponent, ref } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    const text = ref("Hello World");
    return () => <div>{text.value}</div>;
  },
});

這裡需要註意的是在 SFC 模板中是不需要加.value的,但是 JSX 模板中則需要加.value

條件渲染(v-if)

在 SFC 中我們可以使用v-if進行條件渲染,如

<div>
  <div v-if="showyes">yes</div>
  <span v-else>no</span>
</div>

而在 JSX 中則沒有了v-if,而是採用更接近原生的寫法

import { defineComponent, ref } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    const showyes = ref(true);
    return () => <div>{showyes.value ? <div>yes</div> : <div>no</div>}</div>;
  },
});

除了v-if,大家可能還會想到另一個條件渲染方式v-show,JSX 中是支持使用v-show的

import { defineComponent, ref } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    const showyes = ref(true);
    return () => (
      <div>
        <div v-show={showyes.value}>yes</div>
        <div v-show={!showyes.value}>no</div>
      </div>
    );
  },
});

列表迴圈(v-for)

在 SFC 中我們經常使用v-for進行列表迴圈渲染,如

<ul>
  <li v-for="{ index, item } in list" :key="index">{{ item }}</li>
</ul>

而在 JSX 中我們則需要改成使用 map 進行列表迴圈渲染

import { defineComponent, ref } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    const list = ref(["one", "two", "three"]);
    return () => (
      <div>
        {list.value.map((item, index) => (
          <div key={index}>{item}</div>
        ))}
      </div>
    );
  },
});

註意,JSX 中列表迴圈也是要加 key 的

事件綁定

事件綁定其實 JSX 與 SFC 就是寫法上的區別,以click為例,在 SFC 中使用@click或者v-on:click進行事件綁定,在 JSX 中則使用onClick進行事件綁定

import { defineComponent, ref } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    return () => (
      <div
        onClick={() => {
          console.log("我被點擊");
        }}
      >
        點擊
      </div>
    );
  },
});

這裡需要註意綁定的函數要使用箭頭函數

事件修飾符

事件修飾符可以使用 vue 提供的withModifiers進行設置,如.self

import { defineComponent, ref, withModifiers } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    return () => (
      <div
        onClick={withModifiers(() => {
          console.log("我被點擊");
        }, ["self"])}
      >
        點擊
      </div>
    );
  },
});

但是對於 .passive、.capture 和 .once 事件修飾符，使用withModifiers並不生效,這裡可以採用鏈式駝峰的形式進行設置,不如.once

import { defineComponent } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    return () => (
      <div
        onClickOnce={() => {
          console.log("我被點擊");
        }}
      >
        點擊
      </div>
    );
  },
});

v-model

v-model 在綁定modelValue或者在input標簽中使用的時候其實和 SFC 差不多

import { defineComponent, ref } from "vue";
export default defineComponent({
  name: "app",
  setup(props, ctx) {
    const num = ref(0);
    return () => <input type="text" v-model={num.value} />;
  },
});

當在組件中使用綁定自定義事件的時候和 SFC 就有了區別,比如綁定一個msg,在 SFC 中直接v-model:msg即可,而在 JSX 中則需要使用一個數組。我們直接看下麵兩個例子你就會明白,假如我們組件名叫ea_button,這個組件發送了一個update:changeMsg的方法,父組件的msg變數需要接受update:changeMsg函數傳來的參數

SFC:

<ea-button v-model:changeMsg="msg"></ea-button>

JSX:

<ea-button v-model={[msg.value, 'changeMsg']}></ea-button>

插槽

先看下預設插槽,我們定義一個子組件 Child 接收一個預設插槽

import { defineComponent, ref } from "vue";
const Child = (props, { slots }) => {
  return <div>{slots.default()}</div>;
};

export default defineComponent({
  name: "app",
  setup(props, ctx) {
    const num = ref(0);
    return () => <Child>預設插槽</Child>;
  },
});

如果想使用具名插槽則需要在父組件中傳入一個對象,對象的 key 值就是插槽的名字

import { defineComponent, ref } from "vue";
//@ts-ignore
const Child = (props, { slots }) => {
  return (
    <div>
      <div>{slots.slotOne()}</div>
      <div>{slots.slotTwo()}</div>
      <div>{slots.slotThree()}</div>
    </div>
  );
};

export default defineComponent({
  name: "app",
  setup(props, ctx) {
    const num = ref(0);
    return () => (
      <Child>
        {{
          slotOne: () => <div>插槽1</div>,
          slotTwo: () => <div>插槽2</div>,
          slotThree: () => <div>插槽3</div>,
        }}
      </Child>
    );
  },
});

如果我們想在父組件的插槽內容中獲取到子組件中的變數,此時便涉及到了作用域插槽。在 JSX 中我們可以在子組件調用預設插槽或者某個具名插槽的時候傳入參數,如下麵的插槽一為例

import { defineComponent, ref } from "vue";
//@ts-ignore
const Child = (props, { slots }) => {
  const prama1 = "插槽1";
  return (
    <div>
      <div>{slots.slotOne(prama1)}</div>
      <div>{slots.slotTwo()}</div>
      <div>{slots.slotThree()}</div>
    </div>
  );
};

export default defineComponent({
  name: "app",
  setup(props, ctx) {
    return () => (
      <Child>
        {{
          slotOne: (pramas: string) => <div>{pramas}</div>,
          slotTwo: <div>插槽2</div>,
          slotThree: <div>插槽3</div>,
        }}
      </Child>
    );
  },
});

我們可以看到prama1=插槽1是子組件中的變數,我們通過slots.slotOne(prama1)將其傳到了父組件的插槽內容中

最後

關於 Vue3 中 JSX 的語法就介紹這麼多,其實如果你熟悉 Vue 的 SFC 語法還是能很快上手 JSX 語法的,因為它們也就是寫法上有一些區別,用法上還是基本一樣的。至於選擇哪一種寫法還是取決於我們自己,我的建議是二者兼得,你可以根據實現不同的功能採用不同的寫法。當然,如果你是一個團隊項目,你還是乖乖聽你領導的吧。

關註公眾號web前端進階每日更新最新前端技術文章,你想要的都有!