Swift套件 · v0.1.0

KLCharts

以Swift Charts平面模式或Canvas立體模式顯示同一組長條圖資料。

KLCharts提供 `.flat` 與 `.dimensional` 兩種長條圖。套件負責繪製、模式切換、點擊判定，以及資料較多時的橫向捲動。選取狀態、數值格式、色彩、資料來源與頁面導覽由整合端App管理。

API文件查看原始碼

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

功能

平面與投影視圖共用資料模型
切換模式時維持外部版面不變
選取與取消選取由整合端App控制
立體圖支援拖曳、視點重設與點擊判定

不包含的功能

套件只繪製整合端App提供的資料，不負責資料彙整、文字在地化、主題、選取狀態保存、圖例或頁面導覽。

透過SwiftPM安裝

Package.swiftSwift

.package(url: "https://github.com/KoenLee1023/KLCharts.git", from: "0.1.0")

使用方式

整合範例Swift

KLDimensionalBarChart(
    data: data,
    mode: mode,
    emptyText: "No data",
    selectedID: selectedID,
    onSelect: { selectedID = $0.id }
)
.frame(height: 300)

API文件

開啟完整API文件。

KLDimensionalBarChart

兩種圖表保持掛載，透過透明度與點擊回應狀態切換顯示。

KLDimensionalBarDatum

保存長條、群組與系列的穩定ID，以及顯示名稱、數值與色彩。

KLFlatBarChartLayout

不進行實際繪製即可計算橫向畫布寬度。

範例App

Geometry Gallery

平面與投影視圖共用資料模型 · 切換模式時維持外部版面不變

Interaction Lab

選取與取消選取由整合端App控制 · 立體圖支援拖曳、視點重設與點擊判定