PagerKit分页导航

技能简介

PagerKit 是面向 SwiftUI 的页式导航库，支持 iOS、macOS、tvOS、visionOS 和 watchOS。通过声明式 API 构建可定制页面流，提供丰富的指示器样式与事件响应机制。

能做什么

• 搭建横向或纵向翻页的视图容器
• 基于数据集合动态生成页面（ForEach）
• 自定义页面指示器颜色、图片、背景风格与位置
• 监听手动/自动翻页事件并获取过渡方向
• 为单页设置独立过渡时长与底部视图

使用说明

安装指令

原始资料未提供具体安装命令。请通过 Swift Package Manager 添加依赖：

https://github.com/openclaw/PagerKit.git

要求：Swift 5.9+，部署目标 iOS 14+/macOS 14+/tvOS 14+/visionOS 1+/watchOS 10+。

基础用法

1. 导入 PagerKit 框架
2. 使用 PKPagesView 作为容器，内部放置 PKPage 或 ForEach 定义页面
3. 通过修饰符配置导航方向、指示器样式及事件回调

输入与输出

见下方输入与输出表格。

风险提示

• 部分功能（如 UIPageControlProgress）仅限特定平台版本
• 自定义图片需区分 UIImage（UIKit）与 Image（SwiftUI）类型
• 跨平台项目建议使用 #if os(…) 处理平台差异

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/szpakkamil/pagerkit/SKILL.md
来源类型：GitHub Skill 文档