使用 HTML5 dialog 制作简单好用的 lightbox 效果

分类：代码日期：2023-01-07

Lightbox 效果是网页中常见的效果，尤其是在图片展示中，它可以让用户以更大的尺寸、更好的画质查看图片，带来刚好的用户体验。本站也介绍过许多优秀的 lightbox 插件/库，如 Zoomify、JK Responsive、Simple Lightbox、Boxer 和 baguetteBox.js 等等，今天，我们使用 HTML5 的 dialog 标签制作一个简单好用的 lightbox 效果。

制作方法

1、引入文件

我们引入 CSS 重置库 normalize（非必需）：

<link rel="stylesheet" href="css/normalize.min.css">

2、HTML

使用 HTML 搭建一个简单的图片结构（使用已有的也行）：

<div class="dowebok">
    <img src="images/1-1.jpg" alt="">
    <img src="images/1-2.jpg" alt="">
    <img src="images/1-3.jpg" alt="">
    <img src="images/1-4.jpg" alt="">
    <img src="images/1-5.jpg" alt="">
    <img src="images/1-6.jpg" alt="">
    <img src="images/1-7.jpg" alt="">
    <img src="images/1-1.jpg" alt="">
    <img src="images/1-2.jpg" alt="">
    <img src="images/1-3.jpg" alt="">
    <img src="images/1-4.jpg" alt="">
    <img src="images/1-5.jpg" alt="">
    <img src="images/1-6.jpg" alt="">
    <img src="images/1-7.jpg" alt="">
</div>

3、CSS

使用 CSS 把 HTML 里的图片美化成图片墙：

.dowebok {
    display: grid;
    gap: 1rem;
    grid-template-columns: repeat(4, 1fr);
    grid-auto-flow: row dense;
    width: 90%;
    margin: auto;
}

.dowebok img {
    max-width: 100%;
    height: auto;
}

.dowebok > :nth-child(7n + 1) {
    grid-column: span 2;
    grid-row: span 2;
}

.dowebok img {
    display: block;
    aspect-ratio: 1/1;
    border-radius: 6px;
    -o-object-fit: cover;
    object-fit: cover;
    overflow: hidden;
}

dialog.lightbox {
    border: none;
    padding: 0;
    -webkit-animation: fadeIn 0.3s ease-out;
    animation: fadeIn 0.3s ease-out;
    background-color: transparent;
}

dialog.lightbox::-webkit-backdrop {
    background-color: rgba(0, 0, 0, 0.4);
}

dialog.lightbox::backdrop {
    background-color: rgba(0, 0, 0, 0.4);
}

dialog.lightbox img {
    -o-object-fit: contain;
    object-fit: contain;
    display: block;
    overflow: hidden;
    height: 100%;
    width: 100%;
    max-width: 90vw;
    max-width: 90dvw;
    max-height: 90vh;
    max-height: 90dvh;
    border-radius: 6px;
}

@-webkit-keyframes fadeIn {
    from {
        opacity: 0;
    }
    to {
        opacity: 1;
    }
}

@keyframes fadeIn {
    from {
        opacity: 0;
    }
    to {
        opacity: 1;
    }
}

4、JavaScript

JS 是关键，因为本例就是使用 JS 创建 dialog 标签，并克隆图片插入到 dialog 中，再控制它显示/隐藏来达到效果的，具体的步骤请查看 JS 代码中的注释：

document.querySelectorAll('.dowebok img').forEach((img) => {
    img.addEventListener('click', (e) => {
        // 创建 dialog
        const dialog = document.createElement('dialog')
        dialog.className = 'lightbox'

        // 克隆 img 并放入 dialog 中
        const imgClone = img.cloneNode()
        dialog.appendChild(imgClone)

        // 把 dialog 插入到 body 中
        document.body.appendChild(dialog)
        dialog.showModal()
        document.body.setAttribute('inert', true)

        // 关闭 dialog 事件
        dialog.addEventListener('click', (e) => {
            if (e.target === e.currentTarget) {
                dialog.close()
            }
        })

        // dialog 关闭方法
        dialog.addEventListener('close', (e) => {
            dialog.parentNode.removeChild(dialog)
            document.body.removeAttribute('inert')
        })
    })
})

到这里就制作完了，你可以点击这里查看效果。

本例之所以说简单，是因为它对现有的代码几乎没有耦合度，只需要把上面 JS 代码中的选择对象修改一下即可。

标签：Lightbox