ElementPlus el-message-box樣式錯位問題及解決

Posted on by

ElementPlus el-message-box樣式錯位

不知道從哪個版本開始發現，element-plus的message-box在有圖標的時候，錯位比較嚴重，f12跟官網的樣式對比後發現，好傢夥！原來position: absolute被覆蓋瞭。

錯位效果截圖

ElementPlus官網代碼截圖

本地項目代碼截圖

可以看出在本地中el-message-box__status樣式的position並未生效

解決方案

修改css樣式

.el-message-box__status {
  position: absolute !important;
}

完成效果截圖

實現ElementPlus的MessageBox

ElementPlus 的 MessageBox 主要功能分析

  • 1.提供一個函數用來展示消息框，這個函數提供如標題、內容等配置參數
  • 2.消息框出現和消失時有動畫
  • 3.使用 Promise 獲取消息框的結果

基本思路

Vue 中動態顯示一個組件，無非就是通過 h 函數創建 VNode，並且把這個 VNode 掛載在 DOM 樹上。這裡有兩種掛載的方式：

createApp

在 main.js 中創建 Vue 實例用的就是這種方法，這也是 Vue3 中代替 Vue2 的 Vue.extend 的方法，簡單使用案例如下：

const app = createApp(MessageBox, {
    message: 'hello?'
})
// 創建無父元素的文檔對象，掛載到 DOM 中後直接調用 app.unmount() 移除 MessageBox
// 和掛載到 div 的區別是 MessageBox 不會作為 div 的子元素
const frg = document.createDocumentFragment()
// app.mount 返回組件實例
// 組件實例內包含 expose 出來的方法或者數據
const vm = app.mount(frg)
document.body.appendChild(frg)

h + render

和 createApp 方法大同小異

const vn = h(MessageBox, {
    message: 'vnode'
})
render(vn, container)
document.body.appendChild(container)

可以看到無論是 createApp 方法還是 h 方法，都可以在第二個參數中傳入組件的 props，於是我們可以封裝一個動態顯示組件的函數，這個函數接受組件的 props。但是在封裝函數之前，讓我們先來實現

MessageBox 這個組件

MessageBox 組件實現

直接貼代碼，講下最關鍵的幾點：

進入退出動態效果實現

設置一個 transition flag，初始時為 false，組件 mounted 後 flag 為 true。

全局遮罩層

一個 fixed 定位寬高為100%的 div。

剩下的主要看 script 部分

<template>
    <transition name="messagebox-fade" @after-leave="onDestroy">
        <div @click="setVisiable(false)" v-show="visiable"
            class="z-50 flex items-center justify-center fixed top-0 left-0 w-full h-full bg-dark-50/50">
            <div @click.stop class="transform -translate-y-1/2 p-2 rounded min-w-3/7 bg-white">
                <p class="text-sm text-gray-600 font-light"> {{ title }}</p>
                <p class="my-4 text-lg">
                    <content-view :type="type"></content-view>
                </p>
                <div class="w-full flex justify-end items-center">
                    <button @click="okBtnClicked" class="btn btn-primary"> {{ ok }}</button>
                    <button @click="cancelBtnClicked" v-if="cancel" class="ml-2 btn btn-danger"> {{ cancel }}</button>
                </div>
            </div>
        </div>
    </transition>
</template>
<script setup>
import { ref, onMounted, h } from 'vue'
const { onOK, onCancel, message } = defineProps({
    title: {
        type: String,
        default: '提示'
    },
    message: {
        type: String,
        default: ''
    },
    type: {
        type: String,
        validator: (value) => {
            return ['confirm', 'prompt'].includes(value)
        }
    },
    ok: {
        type: String,
        default: 'OK'
    },
    cancel: {
        type: String,
        default: ''
    },
    onDestroy: Function,
    onOK: Function,
    onCancel: Function
})
const promptContent = ref('')
const ContentView = ({ type }) => {
    switch (type) {
        case (!type || 'confirm'):
            return h('p', null, message)
        case 'prompt':
            return h('input', {
                class: 'messagebox-input',
                onInput: (e) => promptContent.value = e.target.value
            })
    }
}
const visiable = ref(false);
const setVisiable = (vis) => {
    visiable.value = vis;
}
const okBtnClicked = () => {
    setVisiable(false);
    onOK(promptContent.value)
}
const cancelBtnClicked = () => {
    setVisiable(false)
    onCancel()
}
onMounted(() => {
    setVisiable(true);
})
</script>
<style scoped>
.btn {
    @apply outline-gray-100 border-none p-1 rounded bg-warm-gray-200
}
.btn-primary {
    @apply bg-sky-300
}
.messagebox-input {
    @apply border rounded border-light-900 outline-none w-full py-1 px-2 text-lg 
}
.messagebox-fade-enter-from,
.messagebox-fade-leave-to {
    @apply opacity-0
}
.messagebox-fade-enter-active,
.messagebox-fade-leave-active {
    @apply transition-opacity
}
</style>

函數式組件

// 第一個參數是 props，第二個參數是 context，類似 setup 的參數
// 返回值為 VNode
// 可以導出或者直接在組件內部使用
const ContentView = ({ type }) => {
    switch (type) {
        case (!type || 'confirm'):
            return h('p', null, message)
        case 'prompt':
            return h('input', {
                class: 'messagebox-input',
                onInput: (e) => promptContent.value = e.target.value
            })
    }
}

封裝 MessageBox 顯示函數

import { createApp } from 'vue'
import MessageBoxCpn from './MessageBox.vue'
const fields = ['confirm', 'prompt']
export default function MessageBox(options) {
    return new Promise((resolve, reject) => {
        const app = createApp(MessageBoxCpn, {
            ...options,
            onDestroy: () => {
                app.unmount()
            },
            onOK: (value) => {
                resolve(value)
            },
            onCancel: () => {
                reject()
            }
        })
        const frg = document.createDocumentFragment()
        app.mount(frg)
        document.body.appendChild(frg)
    })
}
fields.forEach(field => {
    MessageBox[field] = (options) => {
        options.type = field
        return MessageBox(options)
    }
})

通過組件的 props 傳入回調，實現按鈕點擊事件的傳遞、MessageBox 關閉時取消掛載的操作。

另外可以通過 MessageBox.prompt 等靜態方法直接調用對應 type 的 MessageBox，實現方式是在 MessageBox 上掛上對應的靜態方法，並且覆蓋 options 的 type 選項。

以上為個人經驗，希望能給大傢一個參考，也希望大傢多多支持WalkonNet。 

推薦閱讀：