Arrow

이전/다음 패널로 이동하는 화살표 네비게이션 버튼을 추가합니다.

JavaScript

import Flicking from "@egjs/flicking";
import { Arrow } from "@egjs/flicking-plugins";
import "@egjs/flicking/dist/flicking.css";
import "@egjs/flicking-plugins/dist/arrow.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 Arrow());

Open Sandbox

React

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

const COLORS = ["#e74c3c", "#3498db", "#2ecc71", "#f39c12", "#9b59b6"];
const plugins = [new Arrow()];

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>
        <span className="flicking-arrow-prev"></span>
        <span className="flicking-arrow-next"></span>
      </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>
      <span class="flicking-arrow-prev"></span>
      <span class="flicking-arrow-next"></span>
    </template>
  </Flicking>
</template>

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

const COLORS = ["#e74c3c", "#3498db", "#2ecc71", "#f39c12", "#9b59b6"];
const plugins = [new Arrow()];
</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: 0 40px;
}

</style>

Open Sandbox

요약

주요 옵션

옵션	타입	기본값	설명
parentEl	HTMLElement	-	화살표 버튼의 부모 요소. 기본적으로 뷰포트 내부에 배치

필수 CSS

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

상세 설명

동작 원리

Arrow 플러그인은 .flicking-arrow-prev와 .flicking-arrow-next 클래스를 가진 요소를 찾아 이전/다음 패널로 이동하는 클릭 이벤트를 바인딩합니다.

HTML 구조

화살표 요소를 뷰포트 내부에 배치해야 합니다.

<div class="flicking-viewport">
  <div class="flicking-camera">
    <!-- 패널들 -->
  </div>
  <span class="flicking-arrow-prev"></span>
  <span class="flicking-arrow-next"></span>
</div>

프레임워크별 사용법

React — ViewportSlot을 사용하여 뷰포트 내부에 화살표를 배치합니다:

<Flicking plugins={plugins}>
  {/* 패널들 */}
  <ViewportSlot>
    <span className="flicking-arrow-prev"></span>
    <span className="flicking-arrow-next"></span>
  </ViewportSlot>
</Flicking>

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

<Flicking :plugins="plugins">
  <!-- 패널들 -->
  <template #viewport>
    <span class="flicking-arrow-prev"></span>
    <span class="flicking-arrow-next"></span>
  </template>
</Flicking>

주의사항

주의

• 반드시 @egjs/flicking-plugins/dist/arrow.css를 import해야 화살표가 올바르게 표시됩니다.
• 화살표 요소는 .flicking-viewport 내부에 위치해야 합니다.

관련 링크

관련 데모

• Pagination: 페이지 인디케이터
• Prev/Next: 커스텀 네비게이션