Swiper JS问题：无法通过数组创建图片轮播图

常见出错原因及修复 #

• 资源加载顺序错误：本地运行时，自定义JS代码可能在Swiper库加载前执行，导致Swiper未定义。需确保Swiper的JS文件在自定义JS之前加载。
• 本地跨域限制：直接用file://协议打开HTML文件时，部分浏览器会拦截跨域请求，导致fetch无法获取数据。解决办法是使用VSCode的Live Server插件启动本地服务器运行项目。
• 硬编码slide数量不匹配：若接口返回的图片数量变化，硬写的固定数量slide会导致漏图或空slide，建议动态生成slide。

修正后的完整可运行代码 #

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Dragon 图片轮播</title>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swiper@8/swiper-bundle.min.css" />
    <style>
        html,
        body {
            position: relative;
            height: 100%;
        }

        body {
            background: #eee;
            font-family: Helvetica Neue, Helvetica, Arial, sans-serif;
            font-size: 14px;
            color: #000;
            margin: 0;
            padding: 0;
        }

        .swiper {
            width: 100%;
            height: 100%;
        }

        .swiper-slide {
            text-align: center;
            font-size: 18px;
            background: #fff;
            display: flex;
            justify-content: center;
            align-items: center;
        }

        .swiper-slide img {
            display: block;
            width: 100%;
            height: 100%;
            object-fit: cover;
        }
        
        .swiper-button-prev,
        .swiper-button-next,
        .swiper-pagination {
            background: rgba(255, 255, 255, .4);
            border-radius: 5px;
            padding: 10px;
        }
        
        .swiper-button-prev:hover,
        .swiper-button-next:hover,
        .swiper-pagination:hover {
            background-color: white;
        }
    </style>
</head>
<body>
    <div class="swiper">
        <div class="swiper-wrapper"></div>
        <div class="swiper-pagination"></div>
        <div class="swiper-button-prev"></div>
        <div class="swiper-button-next"></div>
    </div>

    <script src="https://cdn.jsdelivr.net/npm/swiper@8/swiper-bundle.min.js"></script>
    <script>
        fetch('https://api.spacexdata.com/v4/dragons/5e9d058759b1ff74a7ad5f8f')
            .then((r) => r.json())
            .then((d) => {
                const swiperWrapper = document.querySelector('.swiper-wrapper');
                // 动态生成所有轮播项
                d.flickr_images.forEach(imgUrl => {
                    const slide = document.createElement('div');
                    slide.className = 'swiper-slide';
                    slide.innerHTML = `<img src="${imgUrl}" alt="Dragon" class="image_dragon">`;
                    swiperWrapper.appendChild(slide);
                });
                initCarousel();
            })
            .catch(err => console.error('加载图片失败:', err));

        function initCarousel() {
            const swiper = new Swiper('.swiper', {
                cssMode: true,
                navigation: {
                    nextEl: ".swiper-button-next",
                    prevEl: ".swiper-button-prev",
                },
                pagination: {
                    el: ".swiper-pagination",
                },
                mousewheel: true,
                keyboard: true,
                loop: true
            });
        }
    </script>
</body>
</html>

运行注意事项 #

1. 使用VSCode的Live Server插件启动：右键HTML文件选择「Open with Live Server」，避免file://协议的跨域问题。
2. 动态生成slide的方式可适配接口返回的任意图片数量，无需手动修改HTML结构。
3. 新增错误捕获逻辑，可在控制台查看请求失败原因，方便调试。

内容的提问来源于stack exchange，提问作者antonkornilov-ua