通過vue.extend實現消息提示彈框的方法記錄
前提回顧
在項目開發中我們經常使用的組件註冊分為兩種,一個是全局註冊和另一個是局部註冊,假設我們的業務場景是用戶在瀏覽註冊頁面時,點擊頁面中的註冊按鈕後,前端根據用戶的註冊信息先做一次簡單的驗證,並根據驗證彈出一個對應消息提示彈框
我們拿到這個需求後,便開始著手準備要通過局部註冊消息彈框組件的方法來實現這個場景,在通過局部註冊消息彈框組件的方法解決完這個需求後,自然是沾沾自喜,緊接著又迎來瞭一個需求,該需求是用戶在點擊該註冊按鈕時,點擊幾次就要出現幾次這個消息彈框,你開始犯瞭難,並思考難道我要在頁面中提前插入n個組件標簽,不然我怎麼知道用戶要點擊幾次註冊按鈕?
在你還沒有解決第二個需求的時候,又一個需求來瞭,第三個需求是不僅僅是註冊頁面需要用到這個消息彈框組件,在其他多個頁面中也需要用到這個消息彈框組件。
基於上述的業務需求,我們可以通過vue.extend編程式的使用組件,從而實現功能性的動態的消息提示彈框
局部註冊消息彈框組件
先通過局部註冊的方法來實現消息彈框組件
效果圖如下:
構造目錄如下:
‘src/main.js’文件的代碼:
import Vue from 'vue' import App from './App.vue' //全局引入樣式文件 import './assets/css.css'; Vue.config.productionTip = false new Vue({ render: h => h(App) }).$mount('#app')
‘src/bus/bus.js’文件的代碼:
import vue from 'vue'; var bus=new vue() export default bus;
‘src/App.vue’文件的代碼:
<template> <div id="app"> <button @click="handleShowMessage">點擊出現彈框</button> <TMessage :offsetTop='50'></TMessage> <TMessage :offsetTop='100'></TMessage> <TMessage :offsetTop='150'></TMessage> <!-- 我是不是得在這裡埋下幾萬個消息彈框組件??? --> </div> </template> <script> import TMessage from './components/TMessage/TMessage.vue'; import bus from './bus/bus'; export default { name:'app', data() { return { } }, components: { TMessage, }, methods: { handleShowMessage(){ //打印查看消息彈框的組件對象 console.log(TMessage); //點擊按鈕後出現消息彈框 bus.$emit('showMessage') } }, } </script> <style> #app { display: flex; justify-content: center; } #app button{ margin-top: 250px; } </style>
‘src/components/TMessage/TMessage.vue’文件的代碼:
<template> <transition name="message-fade"> <div :class="[ 'message', 'message-' + type, center ? 'is-center' : '' ]" :style="{top: offset + 'px'}" v-if="!closed" > <p class="message-content">提示信息:{{message}}</p> <i class="icon icon-close"></i> </div> </transition> </template> <script> export default { name: 'TMessage', data() { return { message: '這是默認信息', //彈框的提示內容 type: 'success', //彈框的樣式 success、warning、error center: true, //彈框是否居中顯示 offset: 20, //彈框默認的偏移量 closed: true, //彈框默認隱藏 通過v-if="!closed"控制 duration: 1000, //彈框消失的時間 timer: null, //準備一個定時器 } }, mounted() { this.offset=this.offsetTop bus.$on('showMessage',()=>{ this.closed=false; this.timer = setTimeout(() => { //如果彈框是顯示狀態的話在duration後會變為隱藏狀態 if (!this.closed) { this.close(); } }, this.duration); }) }, props:['offsetTop'], methods: { close() { this.closed = true; } } } </script>
寫到這裡,我們實現的效果為(動圖如下):
‘src/assets/css.css’文件的代碼:
/* 樣式重點解析: 1.'message' 2.'message-' + type: 2.1:message-success 2.2:message-warning 2.3:message-error 3.'is-center' //決定瞭彈框居中顯示 4.'message-fade-enter' //4和5決定瞭彈框的的過渡效果 5.'message-fade-leave-active' 6. .message { top:20px; //決定瞭彈框的偏移量 } */ .message { min-width: 380px; -webkit-box-sizing: border-box; box-sizing: border-box; border-radius: 4px; border-width: 1px; border-style: solid; border-color: #EBEEF5; position: fixed; left: 50%; top: 20px; z-index: 999999999; transform: translateX(-50%); background-color: #edf2fc; transition: opacity .3s, transform .4s, top .4s; overflow: hidden; padding: 15px 15px 15px 20px; display: flex; align-items: center } .message.is-center { -webkit-box-pack: center; -ms-flex-pack: center; justify-content: center } .message p { margin: 0 } .message-info .message-content { color: #909399 } .message-success { background-color: #f0f9eb; border-color: #e1f3d8 } .message-success .message-content { color: #67C23A } .message-warning { background-color: #fdf6ec; border-color: #faecd8 } .message-warning .message-content { color: #E6A23C } .message-error { background-color: #fef0f0; border-color: #fde2e2 } .message-error .message-content { color: #F56C6C } .message-content { padding: 0; font-size: 14px; line-height: 1 } .message-content:focus { outline-width: 0 } .message .icon-close { position: absolute; top: 50%; right: 15px; -webkit-transform: translateY(-50%); transform: translateY(-50%); cursor: pointer; color: #C0C4CC; font-size: 16px } .message .icon-close:focus { outline-width: 0 } .message .icon-close:hover { color: #909399 } .message-fade-enter, .message-fade-leave-active { opacity: 0; transform: translate(-50%, -100%) }
編程式的使用組件
上方在通過局部註冊消息彈框組件時體現的局限性:靈活性低、可復用性低、代碼觀感較差
緊接著我們就要使用vue.extend來實現消息提示彈框,做到編程式的使用組件
該構造目錄為:
‘src/App.vue’文件的代碼:
<template> <div id="app"> <button @click="handleShowMessage">點擊出現彈框</button> </div> </template> <script> import Message from './components/TMessage/TMessage.js'; export default { name:'app', data() { return { } }, methods: { handleShowMessage(){ /** * 每點擊一次按鈕就調用一次該工廠函數 * 每調用一次該工廠函數就創建一個彈框組件對象 */ return Message('我好帥啊我好帥啊我好帥啊') } }, } </script> <style> #app { display: flex; justify-content: center; } #app button{ margin-top: 250px; } </style>
‘src/components/TMessage/TMessage.vue’文件的代碼:
<template> <transition name="message-fade"> <div :class="[ 'message', 'message-' + type, center ? 'is-center' : '' ]" :style="{top: offset + 'px'}" v-if="!closed" > <p class="message-content">提示信息:{{message}}</p> <i class="icon icon-close"></i> </div> </transition> </template> <script> export default { name: 'TMessage', data() { return { message: '這是默認信息', //彈框的提示內容 type: 'success', //彈框的樣式 success、warning、error center: true, //彈框是否居中顯示 offset: 20, //彈框默認的偏移量 closed: false, //彈框默認隱藏 通過v-if="!closed"控制 duration: 1000, //彈框消失的時間 timer: null, //準備一個定時器 } }, mounted() { /*為瞭方便演示先不讓彈框消失 this.timer = setTimeout(() => { //在規定的this.duration後該消息彈框消失 if (!this.closed) { this.close(); } }, this.duration); */ }, methods: { close() { this.closed = true; } } } </script>
‘src/components/TMessage/TMessage.js’文件的代碼:
import Vue from 'vue'; import TMessage from "./TMessage.vue"; function Message(data) { data = data || {}; if (typeof data === 'string') { data = { message: data } } const TMessageClass = Vue.extend(TMessage); //得到的是一個組件對象VueComponent實例 //new TMessageClass接收的是一個包含組件選項的對象 覆蓋 let instance = new TMessageClass({ data }); instance.$mount(); console.log(instance.$el,'現在才可以訪問$el'); /* instance.$el的打印結果如下: <div class="message message-success is-center" style="top: 20px;"> <p class="message-content">提示信息:我好帥啊我好帥啊我好帥啊</p> <i class="icon icon-close"></i> </div> */ document.body.appendChild(instance.$el); } export default Message
寫到這裡,我們來看一下效果,如下圖:
解決消息彈框覆蓋問題
我們已經做到瞭每點擊一次按鈕就出現一個消息彈框組件,但是因為定位的問題出現瞭相互覆蓋,所以得再接著去’TMessage.js’文件中去完善邏輯:
//file:'src/components/TMessage/TMessage.js' /* 解決方法: 通過維護一個隊列來存儲每一個消息彈框組件對象 在每一次生成消息彈框組件時都需要重新計算其top值 通過該隊列來計算上一個消息彈框組件對象的top值 */ import Vue from 'vue'; import TMessage from "./TMessage.vue"; //裝有instance消息彈框組件對象的容器 let instances = []; function Message(data) { data = data || {}; if (typeof data === 'string') { data = { message: data } } data.onClose = function() { console.log('onClose'); // 每消失一個消息彈框就會觸發一個onClose //instance是消息彈框組件的實例對象即VueComponent console.log(instance,'instance'); //每消失一個就得把在instances容器中對應的該組件對象給刪除掉 Message.close(instance); }; const TMessageClass = Vue.extend(TMessage); let instance = new TMessageClass({ data }); instance.$mount(); document.body.appendChild(instance.$el); //如果data數據中有設置偏移量則使用該偏移量 //否則使用默認的偏移量值20 let offset = data.offset || 20; //規定每一個消息彈框的間隔 //這裡直接使用offset值做為間隔 let offsetTop = offset; /**思路如下: * let offsetTop=20; * [].forEach(()=>{offsetTop+=10}); * console.log(offsetTop) //還是20 * * [{a:'1'}].forEach(()=>{offsetTop+=10}); * console.log(offsetTop) //才是30 */ /*這裡是在循環之後才去push 因為生成的第一個消息彈框是不需要計算offsetTop的 生成的第一個消息彈框直接使用offset值即可 */ //從第一個起instances裡有值瞭(組件對象)以後再去循環計算offsetTop值 instances.forEach( item => { //根據上一個計算的offsetTop+自身的高度+規定的間隔 offsetTop += item.$el.offsetHeight + offset; }); //當前生成的消息彈框的高度為offsetTop //offsetTop是根據上一個生成的消息彈框的三個值計算得到的 //instances容器中第0個是不需要參與計算的即采用默認的offset值 instance.$el.style.top = offsetTop + 'px'; instances.push(instance); } Message.close = function(instance) { //每消失一個就得把在instances容器中對應的該組件對象給刪除掉 instances = instances.filter( item => item !== instance ); }; export default Message
‘src/components/TMessage/TMessage.vue’文件的代碼:
//file:'src/components/TMessage/TMessage.vue' <template> <transition name="message-fade"> <div :class="[ 'message', 'message-' + type, center ? 'is-center' : '' ]" :style="{top: offset + 'px'}" v-if="!closed" > <p class="message-content">提示信息:{{message}}</p> <i class="icon icon-close"></i> </div> </transition> </template> <script> export default { name: 'TMessage', data() { return { message: '這是默認信息', //彈框的提示內容 type: 'success', //彈框的樣式 success、warning、error center: true, //彈框是否居中顯示 offset: 20, //彈框默認的偏移量 closed: false, //彈框默認隱藏 通過v-if="!closed"控制 duration: 1000, //彈框消失的時間 timer: null, //準備一個定時器, onClose: null //擴充一個功能 彈框消失後觸發 } }, mounted() { //在規定的this.duration後該消息彈框消失 //消息框消失後會觸發this.close()函數方法 this.timer = setTimeout(() => { if (!this.closed) { this.close(); } }, this.duration); }, methods: { close() { this.closed = true; //如果該組件可以接收到this.onClose方法則調用該方法 //該方法是在該消息彈框消失的時候被觸發 if (typeof this.onClose === 'function') { this.onClose(); } } } } </script>
寫到這裡,我們來看一下效果,如下圖:
優化消息彈框消失的效果
我們可以進一步的優化消息彈框消失的效果,效果圖如下:
‘src/components/TMessage/TMessage.vue’文件的代碼:
<template> <transition name="message-fade"> <div :class="[ 'message', 'message-' + type, center ? 'is-center' : '' ]" :style="{top: offset + 'px'}" v-if="!closed" > <p class="message-content">提示信息:{{message}}</p> <i class="icon icon-close"></i> </div> </transition> </template> <script> export default { name: 'TMessage', data() { return { message: '這是默認信息', type: 'success', center: true, offset: 20, closed: false, duration: 1000, timer: null, onClose: null //擴充一個功能 彈框消失後觸發 } }, mounted() { this.timer = setTimeout(() => { if (!this.closed) { this.close(); } }, this.duration); }, methods: { close() { this.closed = true; //當彈框消失時會調用this.onClose()該函數方法 if (typeof this.onClose === 'function') { this.onClose(); } } } } </script>
‘src/components/TMessage/TMessage.js’文件的代碼:
import Vue from 'vue'; import TMessage from "./TMessage.vue"; //裝有instance的容器 let instances = []; function Message(data) { data = data || {}; if (typeof data === 'string') { data = { message: data } } const TMessageClass = Vue.extend(TMessage); let instance = new TMessageClass({ data }); instance.$mount(); document.body.appendChild(instance.$el); data.onClose = function() { console.log('onClose'); // 每消失一個彈框就會觸發一個onClose方法 Message.close(instance); }; //如果data數據中有設置偏移量則使用該偏移量 //否則使用默認的偏移量20 let offset = data.offset || 20; //規定每一個消息彈框的間隔 let offsetTop = offset; instances.forEach( item => { //上一個實例對象的offsetTop+自身的高度+規定的間隔 offsetTop += item.$el.offsetHeight + offset; }); instance.$el.style.top = offsetTop + 'px'; instances.push(instance); } Message.close = function(instance) { /* 每次彈窗關閉都會調用一次這個函數 * 獲取當前這個instance的高度 * 把這個instance後面的所有實例的top減去這個高度,再減去偏移 * */ let removeHeight = instance.$el.offsetHeight + instance.offset; //把傳遞進來的instance在容器instances中刪除 let index = instances.findIndex( item => item === instance ); instances = instances.filter( item => item !== instance ); //對應的消息彈框消失後在該消息彈框後面的消息彈框會依次出現頂上來的效果 //原理是找到對應的消息彈框在instances容器中的下標位置 //通過循環改變對應的消息彈框後面的所有消息彈框的高度 for (let i = index; i<instances.length; i++) { instances[i].$el.style.top = parseFloat(instances[i].$el.style.top) - removeHeight + 'px'; } }; export default Message
‘src/App.vue’文件的代碼:
<template> <div id="app"> <button @click="handleShowMessage">點擊出現彈框</button> </div> </template> <script> import Message from './components/TMessage/TMessage.js'; export default { name:'app', data() { return { } }, methods: { handleShowMessage(){ /** * 調用一次就創建一個彈框組件對象 */ return Message('我好帥啊我好帥啊我好帥啊') } }, } </script> <style> #app { display: flex; justify-content: center; } #app button{ margin-top: 250px; } </style>
終極版實現版
我們在上方’src/App.vue’文件中是通過引入TMessage.js後再通過Message()的方式調用使用該組件的,還可以將調用方式掛載到Vue全局上,來看看怎麼操作:
‘src/main.js’文件的代碼
import Vue from 'vue' import App from './App.vue' import './assets/css.css'; import Message from '../src/components/TMessage/TMessage'; Vue.config.productionTip = false //掛載到全局 Vue.prototype.$message = Message; new Vue({ render: h => h(App) }).$mount('#app')
‘src/App.vue’文件的代碼
<template> <div id="app"> <button @click="handleShowMessage">點擊出現彈框</button> </div> </template> <script> export default { name:'app', data() { return { } }, methods: { handleShowMessage(){ this.$message.error('我好帥啊我好帥啊我好帥啊') this.$message.success('我好帥啊我好帥啊我好帥啊') this.$message.info('我好帥啊我好帥啊我好帥啊') this.$message.warning('我好帥啊我好帥啊我好帥啊') } }, } </script> <style> #app { display: flex; justify-content: center; } #app button{ margin-top: 250px; } </style>
‘src/components/TMessage/TMessage.vue’文件的代碼:
<template> <transition name="message-fade"> <div :class="[ 'message', 'message-' + type, center ? 'is-center' : '' ]" :style="{top: offset + 'px'}" v-if="!closed" > <p class="message-content">提示信息:{{message}}</p> <i class="icon icon-close"></i> </div> </transition> </template> <script> export default { name: 'TMessage', data() { return { message: '這是默認信息', type: 'success', center: true, offset: 20, closed: false, duration: 1000, timer: null, onClose: null //擴充一個功能 彈框消失後觸發 } }, mounted() { this.timer = setTimeout(() => { if (!this.closed) { this.close(); } }, this.duration); }, methods: { close() { this.closed = true; //當彈框消失時會調用this.onClose()該函數方法 if (typeof this.onClose === 'function') { this.onClose(); } } } } </script>
‘src/components/TMessage/TMessage.js’文件的代碼:
import Vue from 'vue'; import TMessage from "./TMessage.vue"; let instances = []; function Message(data) { data = data || {}; if (typeof data === 'string') { data = { message: data } } data.onClose = function() { console.log('onClose'); //instance是消息彈框組件的實例對象即VueComponent Message.close(instance); }; const TMessageClass = Vue.extend(TMessage); let instance = new TMessageClass({ data }); instance.$mount(); // console.log(instance.$el,'現在才可以訪問$el'); document.body.appendChild(instance.$el); let offset = data.offset || 20; //規定每一個消息彈框的間隔 let offsetTop = offset; //第一個彈框是不需要計算偏移量的 //從第一個以後再去循環 instances.forEach( item => { //上一個實例對象的offsetTop+自身的高度+規定的間隔 offsetTop += item.$el.offsetHeight + offset; }); instance.$el.style.top = offsetTop + 'px'; instances.push(instance); } Message.close = function(instance) { let removeHeight = instance.$el.offsetHeight + instance.offset; let index = instances.findIndex( item => item === instance ); instances = instances.filter( item => item !== instance ); for (let i = index; i<instances.length; i++) { instances[i].$el.style.top = parseFloat(instances[i].$el.style.top) - removeHeight + 'px'; } }; ['info', 'success', 'error', 'warning'].forEach( type => { Message[type] = function(data) { if (typeof data === 'string') { data = { message: data } } data.type = type; //整合data後再次去調用Message() return Message(data); }; } ); // Message.error=function(data){ // if (typeof data === 'string') { // data = { // message: data // } // } // return Message({ // ...data, // type:'error' // }) // } export default Message
完結撒花,最後來看一下效果圖:
總結
到此這篇關於通過vue.extend實現消息提示彈框的文章就介紹到這瞭,更多相關vue.extend實現消息提示彈框內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- 封裝一個更易用的Dialog組件過程詳解
- Vue3內置組件Teleport使用方法詳解
- Vue.extend實現組件庫message組件示例詳解
- 利用vue3仿蘋果系統側邊消息提示效果實例
- vue中父子組件的參數傳遞和應用示例