Swift软件包 · v0.1.0

KLCharts

用Swift Charts平面模式或Canvas立体模式显示同一组柱状图数据。

KLCharts提供 `.flat` 和 `.dimensional` 两种柱状图。软件包负责绘制、模式切换、点击判定以及数据较多时的横向滚动。选中状态、数值格式、颜色、数据来源和页面跳转由接入应用管理。

API文档查看源代码

支持平台: iOS 17+ · macOS 14+
开发工具: Swift 6.0+
许可证: MIT
第三方依赖: 无

功能

平面与投影视图共享数据模型
切换模式时保持外部布局不变
选中和取消选中由接入应用控制
立体图支持拖动、视点重置和点击判定

不包含的功能

软件包只绘制接入应用提供的数据，不负责数据汇总、文案本地化、主题、选中状态持久化、图例或页面跳转。

通过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

选中和取消选中由接入应用控制 · 立体图支持拖动、视点重置和点击判定