文章目錄
一、現在要你完成一個Dialog組件,說說你設計的思路?它應該有什么功能?
以前沒有嘗試過封裝組件,其實也沒有嚴格意義的去籠統的學習過封裝組件,最近使用layui滿頻繁的,想要封裝一個dialog,嘗試一下自己去動手封裝一個組件,鍛煉一下自己的動手能力,當然在這里也是分享給大家。
回到上方我們其實可以回想一下大體的功能,如果是一個彈窗的話,我們應該怎樣去調用?應該怎么去使用呢?是使用js api來調用,還是說放置一個已經寫好的html模板,讓其設置display:none? js 手動將其顯示?
其實上面的問題,我們可以參照一下layui和bootstrap
首先我們可以先看一下bootstrap的彈窗組件
我們其實可以明顯的看出在bootstrap中其實也就是手動的將html標簽語句放置在了body體內,而layui其實就是將對應的彈窗封裝成了一個js文件,當調用時,去調用這個js文件的方法,然后采用插入節點的方式,將彈窗呈現。
那么我們應該去采用哪種方式來封裝這個彈窗呢?在這里的話我們就將其手動的寫入到js文件當中,讓其使用js api的方式,讓彈窗跳出,從而實現效果。
大體功能
- 該組件需要提供hook指定渲染位置,默認渲染在body下面。
- 然后改組件可以指定外層樣式,如寬度等
- 組件外層還需要一層mask來遮住底層內容,點擊mask可以執行傳進來的onCancel函數關閉Dialog。
- 另外組件是可控的,需要外層傳入visible表示是否可見。
- 然后Dialog可能需要自定義頭head和底部footer,默認有頭部和底部,底部有一個確認按鈕和取消按鈕,確認按鈕會執行外部傳進來的onOk事件,然后取消按鈕會執行外部傳進來的onCancel事件。
- 組件高度可能大於頁面高度,組件內部需要滾動條。
我略微的刪減掉了幾個功能,因為我們采用的是像layui 式js的跳出方式,所以我們不需要 對應的變量去控制對應的展示還是隱藏,所以我們的dialog需要實現的就是上方的幾個功能。
二、文檔結構
我們大體需要3個文件,一個css、一個html、一個js文件
三、樣式Css文件
/*index.css*/
*{
margin:0;
padding:0;
}
/* a標簽去除下划線改變顏色 */
a{
text-decoration: none;
color: black;
}
/* 彈窗容器 */
.keyui-dialog-box{
width: 100vw;
height: 100vh;
position: fixed;
top: 0;
bottom: 0;
left: 0;
right: 0;
z-index: 100000;
}
/* 遮罩層樣式 */
.keyui-masking-layer{
width: 100%;
height: 100%;
background-color: rgba(0, 0, 0, .3);
}
/* 彈窗默認樣式 */
.keyui-dialog{
width:50vw;
height:50vh;
background-color: white;
position: absolute;
left: 50%;
top: 50%;
transform: translate(-50%,-50%);
}
/* 頭部設置固定高度 */
.keyui-dialog-head{
width: 100%;
height: 40px;
line-height: 40px;
padding: 0 20px;
box-sizing: border-box;
background-color: #f8f8f8;
border-bottom: 1px solid #eeeeee;
position: relative;
}
/* 右上角關閉圖標 */
.keyui-rightUp-close{
position: absolute;
right: 20px;
}
/* 彈窗內容區域 */
.keyui-dialog-content{
height: calc(100% - 40px);
padding: 20px;
box-sizing: border-box;
overflow-y: auto; /* 為什么要設置auto,因為內容區域有時會超出彈窗大小 */
}
/* btn按鈕樣式 */
.keyui-btn {
display: inline-block;
line-height: 1;
white-space: nowrap;
cursor: pointer;
background: #FFF;
border: 1px solid #DCDFE6;
color: #606266;
-webkit-appearance: none;
text-align: center;
box-sizing: border-box;
outline: 0;
margin: 0;
-webkit-transition: .1s;
transition: .1s;
font-weight: 500;
padding: 12px 20px;
font-size: 14px;
border-radius: 4px;
}
/* 鼠標移入按鈕效果 */
.keyui-btn:hover {
color: #409eff;
border-color: #c6e2ff;
background-color: #ecf5ff;
}
/* 確認按鈕 */
.keyui-btn-primary {
color: #FFF;
background-color: #409EFF;
border-color: #409EFF;
}
/* 確認按鈕鼠標移入效果 */
.keyui-btn-primary:hover {
background: #66b1ff;
border-color: #fff;
color: #fff;
}
/* 確認按鈕mini樣式 */
.keyui-btn-mini {
font-size: 12px;
border-radius: 3px;
padding: 7px 15px;
}
/* 確認按鈕small樣式 */
.keyui-btn-small {
padding: 9px 15px;
font-size: 12px;
border-radius: 3px;
}
/* 下框按鈕區域居中,來一些邊距樣式 */
.dialog-bottom{
padding:5px;
background-color: #fff;
text-align: center;
}
四、模擬調用場景index.html文件
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>彈窗組件封裝</title>
<!-- 引入css樣式 -->
<link rel="stylesheet" href="./index.css" />
</head>
<body>
<!-- 彈窗按鈕,用於調用點擊事件的彈窗 -->
<button id="btn">彈窗組件</button>
<!-- 指定content內容,在這里采用id,並默認將其設置為隱藏 -->
<div id="content" style="display:none;">我是一個小天才</div>
</body>
</html>
<!-- 引入jquery,因為我們js中的很多調用方法都是基於jquery的所以我們需要在index.js的上方就要引入jquery -->
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.5.1/jquery.js"></script> <!-- 引入我們的keyui組件庫 --> <script src="./index.js"></script> <script> $('#btn').click(function () { // 配置參數 index對應我們返還的節點 var index = keyui.dialog({ title:'彈窗',// title左上角標題 content: '#content',// content 指定對應內容指向哪一個標簽 btn: ['確認', '取消'],// 下bottom按鈕 area:['200px','200px'],// 彈窗寬高大小 yes: function () { //點擊確認按鈕事件 console.log(index) //對應上方的index變量,傳遞給close參數,用於關閉彈窗 keyui.close(index) //關閉彈窗 }, no:function(){ //點擊取消按鈕事件 keyui.close(index) //關閉彈窗 } }) }) </script>
五、dialog彈窗js組件
// 點擊刪除方法
function rightclose(box) {
$('#'+box).remove()
}
// dom節點轉換為字符串方法
function toInnerHTML(obj){
// 創建一個節點
const div = document.createElement("div")
// 將節點插入進去
div.appendChild(obj);
// 將傳遞進來的dom設置為顯示 因為是復制的上方節點嘛
obj.style.display="block"
// 獲取當當前的dom節點字符串
var a=div.innerHTML;
// return出去
return a;
}
var yes1= function(){
}
var no1 = function(){
}
var keyui = {
// 彈窗方法 外部可直接使用keyui.dialog調用
dialog: function (obj) {
// 設置默認值等等
var {title='彈窗',content='',btn=[],yes,no,area=['50%','50%']} = obj
// 創建一個時間戳當層級id
var date = new Date().getTime()
// 判斷是不是真的傳遞了yes或者no 如果傳遞了yes或者no才會讓對應的方法賦予上方的全局方法,供與回調
if(typeof yes === "function"){
yes1 = yes
}
if(typeof no === "function"){
no1 = no
}
// 判斷當前有沒有btn這個數組
var dialog_bottom=''
//有btn並且btn的長度不為0那么說明傳遞了按鈕
if(btn&&btn.length){
// 拼接
dialog_bottom+= `<div class="dialog-bottom">`
// 循環傳遞進來的數組
btn.forEach((element,index) => {
// 我們在這里只考慮傳遞兩個按鈕第一個相當於確認,第二個相當於取消,同時掛載點擊方法,也就對應了我們上方的yes1,no1
dialog_bottom += `<div class="keyui-btn keyui-btn-mini ${index==0?'keyui-btn-primary':''}" οnclick="${index==0?'yes1()':'no1()'}">${element}</div>`
});
dialog_bottom+= `</div>`
}
// 拼接一個dom節點,其實原理上我們還是使用的插入節點的方式。
var box = $(`<div id="keyui-${date}" class="keyui-dialog-box"> <div class="keyui-masking-layer"> <div class="keyui-dialog" style="width:${area[0]};height:${area[1]}"> <div class="keyui-dialog-head"> <span>${title}</span> <a href="javascript:;" class="keyui-rightUp-close" οnclick="rightclose('keyui-${date}')">X</a> </div> <div class="keyui-dialog-content"> ${content?toInnerHTML($(content).clone(true)[0]):''} </div> ${dialog_bottom} </div> </div> </div>`)
// 分別說一下上方對應變量的意思
/** * @param date 時間戳,主要是為了彈窗之中在彈彈窗,用於區分當前究竟是哪一個彈窗 * @param area[] 0:寬度,1高度 * @param title 標題 * @param toInnerHTML($(content).clone(true)[0]) 完全克隆一個dom節點並作為參數傳遞給toInnerHTML用於拿到dom字符串 * @param dialog_bottom bottom內容,如果傳遞的按鈕是空的,那么就不會渲染,如果不是就會渲染 */
// 將數據插入到對應的body頁面中 當然層級我們肯定要設置很高,防止被其他內容蓋住
$('body').append(box)
// 返回我們拼接的id值 用於關閉這個彈窗
return $('#keyui-'+date)[0]
},
// 關閉彈窗方法,index其實對應的是一個dom節點也就是上方彈窗返還的節點
close: function (index) {
// 取當前節點 直接清除
index.remove();
}
}