開始使用 Swiper

安裝

您有幾種方式可以將 Swiper 導入到您的專案中

從 NPM 安裝

我們可以從 NPM 安裝 Swiper

$ npm install swiper

// import Swiper JS
import Swiper from 'swiper';
// import Swiper styles
import 'swiper/css';

const swiper = new Swiper(...);

預設情況下，Swiper 只會匯出核心版本，不包含額外的模組（例如導覽、分頁等）。因此，您也需要匯入並設定它們

// core version + navigation, pagination modules:
import Swiper from 'swiper';
import { Navigation, Pagination } from 'swiper/modules';
// import Swiper and modules styles
import 'swiper/css';
import 'swiper/css/navigation';
import 'swiper/css/pagination';

// init Swiper:
const swiper = new Swiper('.swiper', {
  // configure Swiper to use modules
  modules: [Navigation, Pagination],
  ...
});

如果您想匯入包含所有模組的 Swiper（捆綁包），則應從 swiper/bundle 匯入

// import Swiper bundle with all modules installed
import Swiper from 'swiper/bundle';

// import styles bundle
import 'swiper/css/bundle';

// init Swiper:
const swiper = new Swiper(...);

從 CDN 使用 Swiper

如果您不想在專案中包含 Swiper 檔案，可以使用 CDN。以下檔案可用

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.css"
/>

<script src="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js"></script>

如果您在瀏覽器中使用 ES 模組，也有可用的 CDN 版本

<script type="module">
  import Swiper from 'https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.mjs'

  const swiper = new Swiper(...)
</script>

下載資源

如果您想在本地使用 Swiper 資源，可以直接從 https://www.jsdelivr.com/package/npm/swiper 下載

新增 Swiper HTML 佈局

現在，我們需要在應用程式中新增基本的 Swiper 佈局

<!-- Slider main container -->
<div class="swiper">
  <!-- Additional required wrapper -->
  <div class="swiper-wrapper">
    <!-- Slides -->
    <div class="swiper-slide">Slide 1</div>
    <div class="swiper-slide">Slide 2</div>
    <div class="swiper-slide">Slide 3</div>
    ...
  </div>
  <!-- If we need pagination -->
  <div class="swiper-pagination"></div>

  <!-- If we need navigation buttons -->
  <div class="swiper-button-prev"></div>
  <div class="swiper-button-next"></div>

  <!-- If we need scrollbar -->
  <div class="swiper-scrollbar"></div>
</div>

Swiper CSS 樣式/大小

除了Swiper 的 CSS 樣式，我們可能需要新增一些自訂樣式來設定 Swiper 的大小

.swiper {
  width: 600px;
  height: 300px;
}

初始化 Swiper

最後，我們需要在 JS 中初始化 Swiper

const swiper = new Swiper('.swiper', {
  // Optional parameters
  direction: 'vertical',
  loop: true,

  // If we need pagination
  pagination: {
    el: '.swiper-pagination',
  },

  // Navigation arrows
  navigation: {
    nextEl: '.swiper-button-next',
    prevEl: '.swiper-button-prev',
  },

  // And if we need scrollbar
  scrollbar: {
    el: '.swiper-scrollbar',
  },
});

下一步？

如您所見，將 Swiper 整合到您的網站或應用程式中非常容易。以下是您的下一步

• 前往API 文件以了解有關所有 Swiper API 以及如何控制它的更多資訊。
• 查看可用的範例。
• 如果您對 Swiper 有疑問，請在StackOverflow 或 Swiper Discussions 中提出。
• 如果您發現錯誤，請在 GitHub 上建立 issue。
• 如果您正在尋求支援，我們為 Swiper Patrons 提供了一個私人 Discord 支援聊天室。