Alpine.js を使用して、クリック可能なコントロールを備えたシンプルな自動再生カルーセルを構築する-jsチュートリアル-php.cn

Alpine.js を使用して、クリック可能なコントロールを備えたシンプルな自動再生カルーセルを構築する

Mary-Kate Olsen

リリース： 2024-11-04 21:45:02

オリジナル

509 人が閲覧しました

Build a Simple Auto-Play Carousel with Clickable Controls Using Alpine.js

Alpine.js を使用して単純なカルーセルを作成する手順の例を次に示します。 Alpine.js は、反応性を提供する軽量の JavaScript フレームワークで、大量の JavaScript を使用せずにインタラクティブなコンポーネントを構築するために使用できます。

この例では、画像を一度に 1 つずつ表示し、画像間を移動するための「前へ」と「次へ」ボタンを備えた基本的なカルーセルを作成します。始めましょう!

ステップ 1: HTML をセットアップし、Alpine.js を含める

まず、HTML ファイルの先頭に Alpine.js をインクルードします。これを行うには、次のスクリプトタグを追加します:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Alpine.js Carousel</title>
  <script src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js" defer></script>
  <style>
    .carousel {
      display: flex;
      justify-content: center;
      align-items: center;
      width: 100%;
      height: 300px;
      overflow: hidden;
      position: relative;
    }
    .carousel img {
      width: 100%;
      transition: opacity 0.5s ease-in-out;
      opacity: 0;
    }
    .carousel img.active {
      opacity: 1;
    }
  </style>
</head>
<body>

ログイン後にコピー

ステップ 2: カルーセルコンポーネントの構造

本文内で、カルーセルコンポーネントの div を作成し、それを x-data で初期化して、Alpine.js のプロパティとメソッドを定義します。

<div x-data="carousel()" class="carousel">
  <!-- Previous Button -->
  <button @click="prev" class="absolute left-0 bg-gray-700 text-white px-3 py-2 rounded">Previous</button>

  <!-- Carousel Images -->
  <template x-for="(image, index) in images" :key="index">
    <img :src="image" :class="{'active': index === currentIndex}" alt="Carousel Image">
  </template>

  <!-- Next Button -->
  <button @click="next" class="absolute right-0 bg-gray-700 text-white px-3 py-2 rounded">Next</button>
</div>

ログイン後にコピー

ステップ 3: Alpine.js データとメソッドを定義する

次に、Alpine コンポーネントでカルーセル機能を定義し、画像をナビゲートするための初期データとメソッドを設定します。

<script>
  function carousel() {
    return {
      currentIndex: 0, // Track the index of the current image
      images: [
        'https://via.placeholder.com/600x300?text=Slide+1',
        'https://via.placeholder.com/600x300?text=Slide+2',
        'https://via.placeholder.com/600x300?text=Slide+3',
      ],
      interval: null,
      startAutoPlay() {
          this.interval = setInterval(() => {
              this.next();
          }, 3000); // Change every 3 seconds
      },
      stopAutoPlay() {
          clearInterval(this.interval);
      },
      // Method to go to the next image
      next() {
        this.currentIndex = (this.currentIndex + 1) % this.images.length;
      },
      // Method to go to the previous image
      prev() {
        this.currentIndex = (this.currentIndex - 1 + this.images.length) % this.images.length;
      },
      init() {
          this.startAutoPlay();
      }
    };
  }
</script>

ログイン後にコピー

コンポーネントの説明

カルーセル HTML 構造:
- 前ボタン: クリックすると、 prev メソッドを呼び出して前の画像に移動します。
- 画像: x-for を使用して画像をループし、src 属性をバインドします。 :class バインディングは、アクティブなクラスを現在のイメージに適用し、表示できるようにします。
- 次へボタン: クリックすると、next メソッドを呼び出して次の画像に移動します。
Alpine.js データとメソッド:
- currentIndex: 表示されている現在の画像を追跡します。
- images: カルーセルの画像の URL を含む配列。
- startAutoPlay() および stopAutoPlay(): 3 秒間隔で自動再生を開始および停止します。
- next(): currentIndex をインクリメントします。画像枚数を超えると最初にリセットされます。
- prev(): currentIndex をデクリメントします。ゼロ以下になると、最後の画像に戻ります。
- init(): カルーセルが初期化されるときに自動再生を開始します。