Pagination

현재 패널 위치를 표시하는 페이지 인디케이터를 추가합니다. bullet, fraction, scroll 세 가지 타입을 지원합니다.

JavaScript

import Flicking from "@egjs/flicking";
import { Pagination } from "@egjs/flicking-plugins";
import "@egjs/flicking/dist/flicking.css";
import "@egjs/flicking-plugins/dist/pagination.css";
import "./styles.css";

const COLORS = ["#e74c3c", "#3498db", "#2ecc71", "#f39c12", "#9b59b6"];

const camera = document.querySelector(".flicking-camera");
COLORS.forEach((color, i) => {
  const panel = document.createElement("div");
  panel.className = "flicking-panel";
  panel.style.background = color;
  panel.textContent = i + 1;
  camera.appendChild(panel);
});

const flicking = new Flicking("#flick", {
  circular: true
});

flicking.addPlugins(new Pagination({ type: "bullet" }));

Open Sandbox

React

import { Pagination } from "@egjs/flicking-plugins";
import Flicking, { ViewportSlot } from "@egjs/react-flicking";
import "@egjs/react-flicking/dist/flicking.css";
import "@egjs/flicking-plugins/dist/pagination.css";
import "./styles.css";

const COLORS = ["#e74c3c", "#3498db", "#2ecc71", "#f39c12", "#9b59b6"];
const plugins = [new Pagination({ type: "bullet" })];

export default function App() {
  return (
    <Flicking circular={true} plugins={plugins}>
      {COLORS.map((color, i) => (
        <div className="flicking-panel" key={i} style={{ background: color }}>
          {i + 1}
        </div>
      ))}
      <ViewportSlot>
        <div className="flicking-pagination"></div>
      </ViewportSlot>
    </Flicking>
  );
}

Open Sandbox

Vue@3

<template>
  <Flicking :options="{ circular: true }" :plugins="plugins">
    <div v-for="(color, i) in COLORS" :key="i"
         class="flicking-panel"
         :style="{ background: color }">
      {{ i + 1 }}
    </div>
    <template #viewport>
      <div class="flicking-pagination"></div>
    </template>
  </Flicking>
</template>

<script setup>
import { Pagination } from "@egjs/flicking-plugins";
import Flicking from "@egjs/vue3-flicking";
import "@egjs/vue3-flicking/dist/flicking.css";
import "@egjs/flicking-plugins/dist/pagination.css";

const COLORS = ["#e74c3c", "#3498db", "#2ecc71", "#f39c12", "#9b59b6"];
const plugins = [new Pagination({ type: "bullet" })];
</script>


<style>

.flicking-viewport.vertical {
  display: block;
  width: 100%;
}

.flicking-panel {
  width: 200px;
  height: 150px;
  margin-right: 10px;
  border-radius: 8px;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 24px;
  font-weight: bold;
  color: white;
}

.panel-1 { background: #3e8ed0; }
.panel-2 { background: #00d1b2; }
.panel-3 { background: #f14668; }
.panel-4 { background: #ffe08a; color: #333; }
.panel-5 { background: #48c78e; }

.demo-container {
  margin-bottom: 24px;
}

.demo-label {
  font-weight: bold;
  margin-bottom: 8px;
  color: #666;
}

.button {
  padding: 8px 16px;
  margin: 4px;
  border: 2px solid #3498db;
  background: transparent;
  color: #3498db;
  border-radius: 4px;
  cursor: pointer;
  font-size: 14px;
}

.button:hover {
  background: #3498db;
  color: white;
}

.controls {
  display: flex;
  justify-content: center;
  margin-top: 16px;
  gap: 8px;
}

.flicking-panel {
  width: 50%;
  height: 200px;
  margin: 0 5px;
  border-radius: 8px;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 24px;
  font-weight: bold;
  color: white;
}

.flicking-viewport {
  padding-bottom: 40px;
}

</style>

Open Sandbox

요약

주요 옵션

옵션	타입	기본값	설명
type	"bullet" | "fraction" | "scroll"	"bullet"	인디케이터 표시 방식
parentEl	HTMLElement	-	인디케이터의 부모 요소. 기본적으로 .flicking-pagination 요소 사용

필수 CSS

import "@egjs/flicking-plugins/dist/pagination.css";

상세 설명

타입별 동작

타입	설명
bullet	각 패널에 대응하는 점(dot) 표시. 클릭으로 해당 패널로 이동
fraction	현재/전체 형태의 숫자 표시 (예: 1/5)
scroll	스크롤바 형태의 인디케이터

HTML 구조

페이지네이션 요소를 뷰포트 내부에 배치해야 합니다.

<div class="flicking-viewport">
  <div class="flicking-camera">
    <!-- 패널들 -->
  </div>
  <div class="flicking-pagination"></div>
</div>

프레임워크별 사용법

React — ViewportSlot을 사용합니다:

<Flicking plugins={plugins}>
  {/* 패널들 */}
  <ViewportSlot>
    <div className="flicking-pagination"></div>
  </ViewportSlot>
</Flicking>

Vue — #viewport 슬롯을 사용합니다:

<Flicking :plugins="plugins">
  <!-- 패널들 -->
  <template #viewport>
    <div class="flicking-pagination"></div>
  </template>
</Flicking>

주의사항

주의

• 반드시 @egjs/flicking-plugins/dist/pagination.css를 import해야 인디케이터가 올바르게 표시됩니다.
• bullet 타입에서 패널 수가 많으면 점이 너무 많아질 수 있습니다. 이 경우 fraction이나 scroll 타입을 고려하세요.

관련 링크

관련 데모

• Arrow: 화살표 네비게이션
• Pagination (Reactive API): Reactive API 기반 커스텀 페이지네이션