jQueryLightbox图片弹窗教程详解

怎么入门文章编程？需要学习哪些知识点？这是新手们刚接触编程时常见的问题；下面golang学习网就来给大家整理分享一些知识点，希望能够给初学者一些帮助。本篇文章就来介绍《jQuery Simple Lightbox数据库图片弹窗教程》，涉及到，有需要的可以收藏一下

本教程详细介绍了如何将存储在数据库中的图片以现代、响应式的弹窗（Lightbox）形式展示，而非传统的新页面跳转或简单链接。我们将使用jQuery和Simple Lightbox插件，通过引入必要的CSS和JavaScript资源，合理构建HTML结构，并编写简单的初始化脚本，从而实现图片点击后居中放大、带有导航功能的专业级图片预览效果。

引言

在网页开发中，展示图片库是一个常见需求。当图片存储在数据库中，并希望用户点击后以一种美观、用户友好的方式（例如弹窗或模态框）进行预览时，传统的window.open()或直接链接到图片的方式往往无法提供最佳的用户体验。本教程将引导您使用流行的jQuery库和Simple Lightbox插件，实现从数据库动态加载图片并以响应式Lightbox弹窗形式展示的功能。

为什么选择LightBox方案？

• 用户体验优化：图片在当前页面上方以模态框形式展示，无需离开当前页面，提供更流畅的浏览体验。
• 视觉效果：通常带有平滑的过渡动画、导航箭头、关闭按钮，甚至图片标题或描述，使图片展示更具专业性。
• 响应式设计：许多Lightbox插件支持响应式布局，能自动适应不同设备屏幕大小。
• 易于集成：借助jQuery等库，LightBox插件通常配置简单，集成度高。

核心工具：jQuery Simple Lightbox

jQuery Simple Lightbox是一个轻量级、响应式的jQuery图片Lightbox插件，支持触摸滑动，易于使用和定制。

实现步骤

要实现数据库图片的弹窗展示，主要分为以下三个步骤：

步骤一：引入必要的CSS和JavaScript资源

首先，您需要在页面的部分或结束标签之前引入jQuery库和Simple Lightbox插件的CSS与JS文件。

<!-- 引入jQuery库 -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>

<!-- 引入Simple Lightbox插件的JavaScript文件 -->
<script type="text/javascript" src="https://www.jqueryscript.net/demo/Responsive-Touch-enabled-jQuery-Image-Lightbox-Plugin/dist/simple-lightbox.jquery.min.js"></script>

<!-- 引入Simple Lightbox插件的CSS样式 -->
<link href='https://www.jqueryscript.net/demo/Responsive-Touch-enabled-jQuery-Image-Lightbox-Plugin/dist/simple-lightbox.min.css' rel='stylesheet' type='text/css'>

<!-- 可选：引入额外的样式，这些通常用于插件的demo或额外美化，非核心功能必需 -->
<link href='https://www.jqueryscript.net/demo/Responsive-Touch-enabled-jQuery-Image-Lightbox-Plugin/demo.css' rel='stylesheet' type='text/css'>
<link href="https://jquery.app/jqueryscripttop.css" rel="stylesheet" type="text/css">

注意事项：

• jquery.min.js是jQuery核心库。
• simple-lightbox.jquery.min.js是Simple Lightbox插件的JavaScript文件。
• simple-lightbox.min.css是Simple Lightbox插件的默认样式。
• demo.css和jqueryscripttop.css通常是示例页面或特定主题的样式，您可以根据项目需求选择是否包含。

步骤二：构建HTML结构并包裹图片链接

为了让Simple Lightbox能够识别并处理您的图片，所有需要弹窗展示的图片链接（标签）需要被一个特定的父容器包裹起来，通常是一个带有特定类的div。Simple Lightbox默认会查找这个容器内的所有标签。

假设您从数据库中获取图片路径，并通过PHP循环生成图片列表。以下是集成LightBox的HTML结构示例：

<?php
    include 'config.php'; // 假设这里包含了数据库连接配置
    // 从数据库获取图片数据
    $query = $db->query("SELECT nameviewer, file_name FROM image ORDER BY uploaded_on DESC");
?>

<!-- 使用一个带有 'gallery' 类的 div 包裹所有图片链接 -->
<div class="gallery">
    <table width="100%" border="1" cellspacing="0" cellpadding="0" align="center">
        <?php
        $i = 0;
        while ($row = $query->fetch_assoc()){
            $nameviewer = 'uploads/'.$row["nameviewer"]; // 图片名称或描述
            $imageURL = 'uploads/'.$row["file_name"];   // 图片文件路径

            if ($i++ % 4 == 0) { // 每4张图片开始新的一行
                echo '<tr>';
            }
            ?>
            <td valign="top">
                <div align="center">
                    <!-- 关键：图片链接，href指向大图，img src指向缩略图 -->
                    <!-- 可以在 <a> 标签中添加 title 属性，Simple Lightbox 可以将其作为图片标题显示 -->
                    <a href="<?= htmlspecialchars($imageURL); ?>" title="<?= htmlspecialchars($row["nameviewer"]); ?>">
                        <img src="<?= htmlspecialchars($imageURL); ?>" width="350" alt="<?= htmlspecialchars($row["nameviewer"]); ?>" />
                    </a>
                    <br>
                    <font color='lightblue'>
                        <b><font size="6"><?php echo htmlspecialchars($row["nameviewer"]);  ?></font></b>
                    </font>
                    <br>
                    <font size="6"><i><font color="#999999">点击图片放大</font></i></font>
                </div>
            </td>
            <?php
            if ($i % 4 == 0) { // 每4张图片结束一行
                echo '</tr>';
            }
        }
        if ($i % 4 != 0) { // 确保最后一行闭合
            echo '</tr>';
        }
        ?>
    </table>
</div>

关键点：

• div class="gallery"：这是Simple Lightbox默认会扫描的容器。您可以自定义这个类名，但需要与步骤三中的JavaScript代码保持一致。
• 标签的href属性：必须指向您希望在弹窗中显示的大图的完整路径。
• 标签的src属性：指向在页面上显示的缩略图路径。
• title属性：为标签添加title属性，Simple Lightbox可以将其作为弹窗中的图片标题显示，提升用户体验。

步骤三：初始化Simple Lightbox插件

最后一步是在页面加载完成后，通过JavaScript代码初始化Simple Lightbox插件。这通常放在标签的末尾，或者在一个$(document).ready()函数中。

<script>
  $(function(){
    // 初始化Simple Lightbox
    // .gallery a 表示选择所有在 class 为 'gallery' 的 div 内部的 <a> 标签
    var gallery = $('.gallery a').simpleLightbox({
      navText:    ['&lsaquo;','&rsaquo;'], // 自定义导航箭头文本
      captionsData: 'title' // 指定从 <a> 标签的 'title' 属性获取图片标题
    });
  });
</script>

代码说明：

• $(function(){ ... });：这是jQuery的简写，确保在DOM加载完成后执行内部代码。
• $('.gallery a')：这是一个jQuery选择器，它会选择所有在class="gallery"的元素内部的标签。这些标签将成为Simple Lightbox的目标。
• .simpleLightbox({...})：调用Simple Lightbox插件并传入配置对象。
  • navText: ['‹','›']：自定义左右导航箭头的显示文本。
  • captionsData: 'title'：告诉插件从标签的title属性中获取图片标题，并在Lightbox中显示。

完整示例代码（集成）

以下是将所有部分整合在一起的完整页面结构示例：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>数据库图片弹窗展示</title>

    <!-- 引入jQuery库 -->
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>

    <!-- 引入Simple Lightbox插件的JavaScript文件 -->
    <script type="text/javascript" src="https://www.jqueryscript.net/demo/Responsive-Touch-enabled-jQuery-Image-Lightbox-Plugin/dist/simple-lightbox.jquery.min.js"></script>

    <!-- 引入Simple Lightbox插件的CSS样式 -->
    <link href='https://www.jqueryscript.net/demo/Responsive-Touch-enabled-jQuery-Image-Lightbox-Plugin/dist/simple-lightbox.min.css' rel='stylesheet' type='text/css'>

    <!-- 可选：引入额外的样式 -->
    <link href='https://www.jqueryscript.net/demo/Responsive-Touch-enabled-jQuery-Image-Lightbox-Plugin/demo.css' rel='stylesheet' type='text/css'>
    <link href="https://jquery.app/jqueryscripttop.css" rel="stylesheet" type="text/css">

    <style>
        /* 示例：一些基本的布局和字体样式，可根据需求调整 */
        body { font-family: Verdana, Arial, Helvetica, sans-serif; margin: 20px; background-color: #f0f0f0; }
        .gallery { margin-top: 20px; }
        .gallery table { border-collapse: collapse; }
        .gallery td { padding: 10px; border: 1px solid #ccc; }
        .gallery img { max-width: 100%; height: auto; display: block; margin: 0 auto; }
        .gallery a { text-decoration: none; }
    </style>
</head>
<body>

    <table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="#000000">
        <tr valign="top" align="left">
            <td width="4%"><a style="text-decoration:none" href="/apppages/more.html"><img src="../appimg/arrow.png" width="108" height="68" border="0"></a></td>
            <td width="96%" valign="middle"><a style="text-decoration:none" href="/apppages/more.html">&nbsp;<font color="#CCCCCC" size="6" face="Verdana, Arial, Helvetica, sans-serif">More Links Options</font></a></td>
        </tr>
    </table>
    <p><br></p>
    <p>
        <img src="header2.jpg" width="921" height="479"><br>
        <font size="7"><br>
        <a href="app-form.php" target="_blank"><font face="Verdana, Arial, Helvetica, sans-serif" color="#9999FF">TAP HERE TO ADD YOUR SELFIE</font></a></font><br>
        <br>
        <?php
            // 假设这里包含了数据库连接配置
            // $db = new mysqli(...)
            include 'config.php';
            // 从数据库获取图片数据
            $query = $db->query("SELECT nameviewer, file_name FROM image ORDER BY uploaded_on DESC");
        ?>
    </p>

    <!-- 使用一个带有 'gallery' 类的 div 包裹所有图片链接 -->
    <div class="gallery">
        <table width="100%" border="1" cellspacing="0" cellpadding="0" align="center">
            <?php
            $i = 0;
            while ($row = $query->fetch_assoc()){
                $nameviewer = 'uploads/'.$row["nameviewer"]; // 图片名称或描述
                $imageURL = 'uploads/'.$row["file_name"];   // 图片文件路径

                if ($i++ % 4 == 0) { // 每4张图片开始新的一行
                    echo '<tr>';
                }
                ?>
                <td valign="top">
                    <div align="center">
                        <!-- 关键：图片链接，href指向大图，img src指向缩略图 -->
                        <!-- 添加 title 属性用于 Lightbox 的标题显示 -->
                        <a href="<?= htmlspecialchars($imageURL); ?>" title="<?= htmlspecialchars($row["nameviewer"]); ?>">
                            <img src="<?= htmlspecialchars($imageURL); ?>" width="350" alt="<?= htmlspecialchars($row["nameviewer"]); ?>" />
                        </a>
                        <br>
                        <font color='lightblue'>
                            <b><font size="6"><?php echo htmlspecialchars($row["nameviewer"]);  ?></font></b>
                        </font>
                        <br>
                        <font size="6"><i><font color="#999999">点击图片放大</font></i></font>
                    </div>
                </td>
                <?php
                if ($i % 4 == 0) { // 每4张图片结束一行
                    echo '</tr>';
                }
            }
            if ($i % 4 != 0) { // 确保最后一行闭合
                echo '</tr>';
            }
            ?>
        </table>
    </div>

    <script>
      $(function(){
        // 初始化Simple Lightbox
        var gallery = $('.gallery a').simpleLightbox({
          navText:    ['&lsaquo;','&rsaquo;'], // 自定义导航箭头文本
          captionsData: 'title', // 指定从 <a> 标签的 'title' 属性获取图片标题
          // 其他常用配置项（可根据需求添加）：
          // animationSpeed: 200, // 动画速度 (毫秒)
          // disableScroll: true, // 打开 Lightbox 时禁用页面滚动
          // history: true, // 启用浏览器历史记录
          // closeText: 'X', // 关闭按钮文本
          // captions: true, // 是否显示标题
          // showCounter: true // 是否显示图片计数器 (例如 1/5)
        });
      });
    </script>

</body>
</html>

注意事项与优化

1. 图片路径：确保$imageURL变量中的图片路径是正确且可访问的。在本例中，图片存储在uploads/目录下。
2. 安全性：在PHP中输出任何来自数据库的用户生成内容时，务必使用htmlspecialchars()函数进行转义，以防止XSS攻击。
3. 性能优化：对于大型图片库，考虑使用图片懒加载（Lazy Loading）技术，以提高页面加载速度。
4. 自定义样式：Simple Lightbox提供了丰富的CSS类，您可以根据自己的品牌和设计风格覆盖或添加自定义样式。
5. 其他配置：Simple Lightbox还有许多其他配置选项，例如动画速度、是否显示计数器、自定义关闭按钮等。您可以查阅其官方文档以进行更高级的定制。
6. 错误处理：在PHP代码中，应添加数据库连接和查询的错误处理机制，以确保在发生问题时能给出友好的提示。

总结

通过本教程，您应该已经掌握了如何利用jQuery和Simple Lightbox插件，将数据库中的图片以现代、交互式的弹窗形式展示出来。这种方法不仅提升了用户体验，也使得图片展示更加专业和美观。请根据您的具体项目需求，灵活调整代码和配置，打造出色的图片展示功能。

理论要掌握，实操不能落！以上关于《jQueryLightbox图片弹窗教程详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！