Swift套件 · v0.1.2

KLGlassSegments

在原生玻璃效果與材質回退樣式之間使用導覽用途的分段控制項。

KLGlassSegments為SwiftUI與UIKit提供分段控制項。它保持泛型選取ID、再次點擊、拖曳取消、輔助使用識別碼與降低動態效果行為一致,並在可用時使用iOS原生玻璃效果。

支援平台
iOS 17+ · macOS 14+
開發工具
Swift 6.0+
授權條款
MIT
第三方相依套件

功能

  • 提供綁定式SwiftUI API與基於 `UIControl` 的UIKit API
  • 更新分段資料時保留穩定的泛型選取ID
  • 支援再次點擊、拖曳取消與VoiceOver啟用
  • 使用原生iOS玻璃效果或材質回退樣式

不包含的功能

套件負責分段控制項的繪製與互動。導覽狀態、觸覺回饋策略、App內容與產品特定樣式由整合端App負責。

透過SwiftPM安裝

Package.swiftSwift
.package(url: "https://github.com/KoenLee1023/KLGlassSegments.git", from: "0.1.2")

使用方式

整合範例Swift
KLGlassSegmentedControl(
    segments: segments,
    selection: $selection,
    floatingAction: composeAction
    )
KLGlassSegmentedControl

SwiftUI控制項,綁定選取ID,並接收分段、樣式、度量、可選操作與再次點擊回呼。

KLGlassSegmentedUIKitControl

UIKit控制項,可更新分段、套用外部選取,並在提交變更時送出 `.valueChanged`。

KLGlassSegment

描述帶泛型ID的分段項,包含標題、SF Symbol、可選選中色彩、輔助使用識別碼與可用時的UIKit圖片。

範例App

GlassNavigation

提供綁定式SwiftUI API與基於 `UIControl` 的UIKit API · 更新分段資料時保留穩定的泛型選取ID

SegmentGallery

支援再次點擊、拖曳取消與VoiceOver啟用 · 使用原生iOS玻璃效果或材質回退樣式