ScrollableGraphView 图表库 V4 版本 API 深度解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00521/article/details/148505715

ScrollableGraphView 图表库 V4 版本 API 深度解析

ScrollableGraphView An adaptive scrollable graph view for iOS to visualise simple discrete datasets. Written in Swift. 项目地址: https://gitcode.com/gh_mirrors/sc/ScrollableGraphView

前言

ScrollableGraphView 是一个功能强大的 iOS 图表库，用于创建可滚动的动态图表。在 V4 版本中，该库进行了重大重构，解决了旧版本中的多个痛点问题，并引入了更灵活、更强大的 API 设计。本文将深入解析 V4 版本的 API 变化及其使用方法。

V4 版本的主要改进

1. 数据动态更新机制

旧版本中，图表数据只能在初始化时一次性设置，无法动态更新。V4 版本通过引入数据源协议（ScrollableGraphViewDataSource），实现了数据的动态获取和更新。

2. 多图表支持

V4 版本新增了对多图表叠加显示的支持，开发者可以轻松地在同一视图中添加多个不同类型的图表（如折线图和柱状图）。

3. 参考线自定义增强

参考线的配置更加灵活，支持通过百分比或绝对值两种方式定位参考线位置，并提供了丰富的样式自定义选项。

4. 代码结构优化

将原先集中在单个类中的约 60 个配置属性进行了合理拆分，提高了代码的可维护性和扩展性。

核心 API 详解

ScrollableGraphView 类

初始化方法

init(frame: CGRect, dataSource: ScrollableGraphViewDataSource)

初始化时需要传入数据源对象，该对象必须实现 ScrollableGraphViewDataSource 协议。

添加图表

func addPlot(plot: Plot)

支持添加多个图表，每个图表通过唯一的标识符（identifier）进行区分。

添加参考线

func addReferenceLines(referenceLines: ReferenceLines)

配置并添加参考线到图表中。

数据刷新

func reload()

调用此方法会触发数据源协议的重新调用，实现图表数据的动态更新。

ScrollableGraphViewDataSource 协议

数据获取方法

func value(forPlot plot: Plot, atIndex pointIndex: Int) -> Double

返回指定图表在特定索引处的 Y 轴值。

func label(atIndex pointIndex: Int) -> String

返回 X 轴在特定索引处的标签文本。

func numberOfPoints(forPlot plot: Plot) -> Int

返回指定图表的数据点数量。

ReferenceLines 类

参考线定位方式

var positionType: ReferenceLinePositionType

支持两种定位方式：

.relative：按百分比定位
.absolute：按绝对值定位

参考线位置设置

var relativePositions: [Double]

当 positionType 为 .relative 时，使用此数组设置参考线位置（0.0 到 1.0 之间的值）。

var absolutePositions: [Double]

当 positionType 为 .absolute 时，使用此数组设置参考线的具体 Y 轴值。

实战示例

下面是一个完整的图表创建示例，展示了如何配置一个包含折线图和柱状图的复合图表：

class ChartViewController: UIViewController, ScrollableGraphViewDataSource {
    
    // 准备数据
    var lineData = [12.0, 15.0, 9.0, 17.0, 23.0, 16.0]
    var barData = [8.0, 10.0, 6.0, 12.0, 15.0, 11.0]
    var labels = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 初始化图表
        let graph = ScrollableGraphView(frame: view.bounds, dataSource: self)
        
        // 基础配置
        graph.backgroundColor = .white
        graph.shouldAnimateOnStartup = true
        
        // 配置参考线
        let referenceLines = ReferenceLines()
        referenceLines.positionType = .relative
        referenceLines.relativePositions = [0, 0.25, 0.5, 0.75, 1]
        
        // 添加参考线到图表
        graph.addReferenceLines(referenceLines: referenceLines)
        
        // 配置折线图
        let linePlot = LinePlot(identifier: "line")
        linePlot.lineWidth = 2
        linePlot.lineColor = .blue
        
        // 配置柱状图
        let barPlot = BarPlot(identifier: "bar")
        barPlot.barWidth = 15
        barPlot.barFillColor = .green.withAlphaComponent(0.5)
        
        // 添加图表到视图
        graph.addPlot(plot: linePlot)
        graph.addPlot(plot: barPlot)
        
        view.addSubview(graph)
    }
    
    // 实现数据源协议
    func value(forPlot plot: Plot, atIndex pointIndex: Int) -> Double {
        switch plot.identifier {
        case "line":
            return lineData[pointIndex]
        case "bar":
            return barData[pointIndex]
        default:
            return 0
        }
    }
    
    func label(atIndex pointIndex: Int) -> String {
        return labels[pointIndex]
    }
    
    func numberOfPoints(forPlot plot: Plot) -> Int {
        return lineData.count
    }
}