前言

最近接到一個(gè)需求，需要在一些敏感操作進(jìn)行前要求輸入賬號(hào)和密碼，然后將輸入的賬號(hào)和密碼加到接口請(qǐng)求的header里面。如果每個(gè)頁(yè)面都去手動(dòng)導(dǎo)入彈窗組件，在點(diǎn)擊按鈕后彈出彈窗。再拿到彈窗返回的賬號(hào)密碼后去請(qǐng)求接口也太累了，那么有沒(méi)有更簡(jiǎn)單的實(shí)現(xiàn)方式呢？

函數(shù)式彈窗的使用場(chǎng)景

首先我們來(lái)看看什么是函數(shù)式彈窗？

函數(shù)式彈窗是一種使用函數(shù)來(lái)創(chuàng)建彈窗的技術(shù)。它可以簡(jiǎn)化彈窗的使用，只需要在需要彈窗的地方調(diào)用函數(shù)就可以了。那么這里使用函數(shù)式彈窗就能完美的解決我們的問(wèn)題。

我們只需要封裝一個(gè)showPasswordDialog函數(shù)，調(diào)用該函數(shù)后會(huì)彈出一個(gè)彈窗。該函數(shù)會(huì)返回一個(gè)resolve后的值就是賬號(hào)密碼的Promise。然后在http請(qǐng)求攔截器中加一個(gè)needValidatePassword字段，攔截請(qǐng)求時(shí)如果該字段為true，就await調(diào)用showPasswordDialog函數(shù)。拿到賬號(hào)和密碼后塞到請(qǐng)求的header里面。這樣就我們就只需要在發(fā)起請(qǐng)求的地方加一個(gè)needValidatePassword: true配置就行了。

先來(lái)實(shí)現(xiàn)一個(gè)彈窗組件

這個(gè)是簡(jiǎn)化后template中的代碼，和Element Plus官網(wǎng)中的demo代碼差不多，沒(méi)有什么說(shuō)的。

<template>
  <el-dialog :model-value="visible" title="賬號(hào)和密碼" @close="handleClose">
    <!-- 省略賬號(hào)、密碼表單部分... -->
    <el-button type="primary" @click="submitForm()">提交</el-button>
  </el-dialog>
</template>

這個(gè)是簡(jiǎn)化后的script代碼，大部分和Element Plus官網(wǎng)的demo代碼差不多。需要注意的是我們這里將close關(guān)閉事件和confirm確認(rèn)事件定義在了props中，而不是在emits中，因?yàn)楹竺婧瘮?shù)式組件會(huì)通過(guò)props將這兩個(gè)回調(diào)傳入進(jìn)來(lái)。具體的我們下面會(huì)講。

<script setup lang="ts">
interface Props {
  visible: boolean;
  close?: () => void;
  confirm?: (data) => void;
}

const props = defineProps<Props>();

const emit = defineEmits(["update:visible"]);

const submitForm = async () => {
  // 省略validate表單校驗(yàn)的代碼
  // 這里的data為表單中輸入的賬號(hào)密碼
  props.confirm?.(data);
  handleClose();
};

const handleClose = () => {
  emit("update:visible", false);
  props.close?.();
};
</script>

再基于彈窗組件實(shí)現(xiàn)函數(shù)式彈窗

createApp函數(shù)和app.mount方法

createApp函數(shù)會(huì)創(chuàng)建和返回一個(gè)vue的應(yīng)用實(shí)例，也就是我們平時(shí)常說(shuō)的app，該函數(shù)接受兩個(gè)參數(shù)。第一個(gè)參數(shù)為接收一個(gè)組件，也就是我們平時(shí)寫(xiě)的vue文件。第二個(gè)參數(shù)為可選的對(duì)象，這個(gè)對(duì)象會(huì)傳遞給第一個(gè)參數(shù)組件的props。

舉個(gè)例子：

import MyComponent from "./MyComponent"

const app = createApp(MyComponent, {
  visible: true
})

在這個(gè)例子中我們基于MyComponent組件生成了一個(gè)app應(yīng)用實(shí)例，如果MyComponent組件的props中有定義visible，那么visible就會(huì)被賦值為true。

調(diào)用createApp函數(shù)創(chuàng)建的這個(gè)應(yīng)用實(shí)例app實(shí)際就是在內(nèi)存中創(chuàng)建的一個(gè)對(duì)象，并沒(méi)有渲染到瀏覽器的dom上面。這個(gè)時(shí)候我們就要調(diào)用應(yīng)用實(shí)例app暴露出來(lái)的mount方法將這個(gè)組件掛載到真實(shí)的dom上面去。mount方法接收一個(gè)“容器”參數(shù)，用于將組件掛載上去，可以是一個(gè)實(shí)際的 DOM 元素或是一個(gè) CSS 選擇器字符串。比如下面這個(gè)例子是將組件掛載到body上面：

app.mount(document.body)

app提供了很多方法和屬性，詳見(jiàn) vue官網(wǎng)。

封裝一個(gè)showPasswordDialog函數(shù)

首先我們來(lái)看看期望如何使用showPasswordDialog函數(shù)？

我們希望showPasswordDialog函數(shù)返回一個(gè)Promise，resolve的值就是彈窗中輸入的表單。例如，我們可以使用以下代碼使用showPasswordDialog函數(shù)：

try {
  // 調(diào)用這個(gè)就會(huì)彈出彈窗
    const res: RuleForm = await showPasswordDialog();
    // 這個(gè)res就是輸入的賬號(hào)密碼
    console.log("res", res);
  } catch (error) {
    console.log(error);
  }

具體如何實(shí)現(xiàn)showPasswordDialog函數(shù)？

經(jīng)過(guò)上面的介紹我們知道了可以調(diào)用createApp函數(shù)傳入指定組件生成app，然后使用app.mount方法將這個(gè)組件掛載到指定的dom上面去。那么現(xiàn)在思路就清晰了，我們只需要將我們前面實(shí)現(xiàn)的彈窗組件作為第一個(gè)參數(shù)傳遞給createApp函數(shù)。第二個(gè)參數(shù)傳入一個(gè)對(duì)象給彈窗組件的props，用以控制打開(kāi)彈窗和注冊(cè)彈窗關(guān)閉和確認(rèn)的事件回調(diào)。下面是實(shí)現(xiàn)的showPasswordDialog函數(shù)

import { App, createApp } from "vue";
import PasswordDialog from "./index.vue";
// 這個(gè)index.vue就是我們前面實(shí)現(xiàn)的彈窗組件

export async function showPasswordDialog(): Promise<RuleForm> {
  return new Promise((resolve, reject) => {
    let mountNode = document.createElement("div");
    let dialogApp: App<Element> | undefined = createApp(PasswordDialog, {
      visible: true,
      close: () => {
        if (dialogApp) {
          dialogApp.unmount();
          document.body.removeChild(mountNode);
          dialogApp = undefined;
          reject("close");
        }
      },
      confirm: (res: RuleForm) => {
        resolve(res);
        dialogApp?.unmount();
        document.body.removeChild(mountNode);
        dialogApp = undefined;
      },
    });
    document.body.appendChild(mountNode);
    dialogApp.mount(mountNode);
  });
}

在這個(gè)showPasswordDialog函數(shù)中我們先創(chuàng)建了一個(gè)div元素，再將彈窗組件傳遞給了createApp函數(shù)生成一個(gè)dialogApp的實(shí)例。然后將創(chuàng)建的div元素掛載到body上面，再調(diào)用mount方法將我們的彈窗組件掛載到創(chuàng)建的div元素上，至此我們實(shí)現(xiàn)了通過(guò)函數(shù)式調(diào)用將彈窗組件渲染到body中。

現(xiàn)在我們?cè)賮?lái)看看傳入到createApp函數(shù)的第二個(gè)對(duì)象參數(shù)，我們給這個(gè)對(duì)象分別傳入了visible屬性、close和confirm回調(diào)方法，分別會(huì)賦值給彈窗組件props中的visible、close、confirm。

彈窗組件中觸發(fā)關(guān)閉事件時(shí)會(huì)調(diào)用props.close?.()，實(shí)際這里就是在調(diào)用我們傳入的close回調(diào)方法。在這個(gè)方法中我們調(diào)用了實(shí)例的unmount方法卸載組件，然后將創(chuàng)建的彈窗組件dom從body中移除，并且返回一個(gè)reject的Promise。

當(dāng)我們將賬號(hào)和密碼輸入完成后，會(huì)調(diào)用props.confirm?.(ruleForm)，這里的ruleForm就是我們表單中的賬號(hào)和密碼。實(shí)際這里就是在調(diào)用我們傳入的confirm回調(diào)方法，接下來(lái)同樣也是卸載組件和移除彈窗組件生成的dom，并且返回一個(gè)resolve值為賬號(hào)密碼表單的Promise。

總結(jié)

這篇文章主要介紹了如何創(chuàng)建函數(shù)式彈窗：

• 創(chuàng)建一個(gè)常規(guī)的彈窗組件，有點(diǎn)不同的是close和confirm事件不是定義在emits中，而是作為回調(diào)定義在props中。
• 創(chuàng)建一個(gè)showPasswordDialog函數(shù)，該函數(shù)返回一個(gè)Promise，resolve的值就是我們彈窗中輸入的表單。
• 調(diào)用createApp函數(shù)將步驟一的彈窗組件作為第一個(gè)參數(shù)傳入，并且第二個(gè)對(duì)象參數(shù)中傳入屬性visible為true打開(kāi)彈窗和注入彈窗close關(guān)閉和confirm確認(rèn)的回調(diào)。
• 使用者只需await調(diào)用showPasswordDialog就可以打開(kāi)彈窗和拿到表單中填入的賬號(hào)和密碼。

到此這篇關(guān)于一文搞定vue3中的函數(shù)式彈窗 的文章就介紹到這了,更多相關(guān)vue3函數(shù)式彈窗 內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論