Pagination dots

많은 페이지를 점 형태로 축약하여 표현하는 네비게이션 요소입니다. 전통적인 숫자 기반 Pagination의 기능을 유지하면서도 시각적으로는 단순한 점 형태를 사용합니다.

@MainActor struct PaginationDots

Overview

PaginationDots은 페이지 간 이동 및 현재 페이지 표시를 위한 점 형태의 페이지네이션 컴포넌트를 제공합니다. 현재 선택된 페이지는 강조 표시되며, 점을 탭하여 해당 페이지로 이동할 수 있습니다. 페이지 수가 많을 경우 표시되는 점의 개수(최대 5개)와 크기가 자동으로 조정됩니다.

@State private var currentPage = 1

PaginationDots(selectedPage: $currentPage, totalPages: 10)
    .variant(.normal)
    .size(.normal)

Topics

Initializers

init(selectedPage: Binding<Int>, totalPages: Int)

점 형태의 페이지네이션을 초기화합니다.

  • Parameters
    ParameterDescription
    selectedPage현재 선택된 페이지 번호 (1부터 시작)
    totalPages전체 페이지 수

Instance Properties

var body: some View

뷰의 내용과 동작을 정의합니다.

Instance Methods

func size(Size) -> PaginationDots

점 페이지네이션의 크기를 설정합니다.

  • Parameters

    ParameterDescription
    size적용할 점 크기

  • Return Value

    수정된 Dot 인스턴스

func variant(Variant) -> PaginationDots

점 페이지네이션의 색상 변형을 설정합니다.

  • Parameters

    ParameterDescription
    variant적용할 색상 변형

  • Return Value

    수정된 Dot 인스턴스

Enumerations

enum Size

점 페이지네이션의 크기를 지정하는 열거형입니다.

Enumeration Cases

case normal

표준 크기

case small

작은 크기

enum Variant

점 페이지네이션의 색상 변형을 지정하는 열거형입니다.

Enumeration Cases

case normal

기본 스타일 (회색 배경에 검은색 점)

case white

흰색 스타일 (어두운 배경에 적합)

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.