Page counter

콘텐츠에서 사용자의 현재 위치를 안내하는 정보성 컴포넌트입니다. 인터랙션이 없는 수동적 요소로 갤러리, 슬라이더, 문서 뷰어 등에서 진행 상황을 숫자로 간결하게 전달합니다.

@MainActor struct PageCounter

Overview

PageCounter은 현재 페이지와 전체, 페이지 수를 숫자로 표시하는 페이지네이션 컴포넌트를 제공합니다. “1/10”과 같은 형식으로 페이지 정보를 시각화하며, 반투명 배경이 적용됩니다.

@State private var currentPage = 1

PageCounter(selectedPage: $currentPage, totalPages: 10)
    .size(.medium)
    .alternative(true)

Topics

Initializers

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

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

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

Instance Properties

var body: some View

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

Instance Methods

func alternative(Bool) -> PageCounter

카운터 페이지네이션의 대체 스타일을 적용합니다.

  • Parameters

    ParameterDescription
    alternative대체 스타일 적용 여부, 생략하면 기본값으로 true 적용
  • Return Value

    수정된 Counter 인스턴스

  • Discussion

    기본 스타일은 반투명 배경을 사용하고, 대체 스타일은 좀 더 불투명한 회색 배경을 사용합니다.

func size(Size) -> PageCounter

카운터 페이지네이션의 크기를 설정합니다.

  • Parameters

    ParameterDescription
    size적용할 카운터 크기
  • Return Value

    수정된 Counter 인스턴스

Enumerations

enum Size

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

Enumeration Cases

case medium

중간 크기

case small

작은 크기

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.