[译] OS X 和 iOS 的测绘框架 - Core Plot 入门教程
leilei03
8年前
<p><img src="https://simg.open-open.com/show/0012b3837ecbd332da40dcbae18102a0.png"></p> <p><em>注意</em> :本篇教程已被 Attila Hegedüs 更新,可适用于 iOS 9 和 Swift 2.2。原始教程出自教程组成员 Steve Baranski。</p> <p>如果你曾经想在自己的 app 中引入图表或图形,那么你应该已经考虑过下面两种选项:</p> <ol> <li> <p><em>自己写。</em> 通过使用 Core Graphics 或者 Quartz 这样的框架编写全部的绘制代码。然而,这显然要花费大量的功夫。</p> </li> <li> <p><em>买一个!</em> 购买一个像 <a href="/misc/goto?guid=4959675534553614995" rel="nofollow,noindex">ShinobiControls</a> 这样的商业型框架。这或许可以节省你的时间,但就要花钱啦。</p> </li> </ol> <p>但是如果你不想花费时间和精力从零开始写(代码),也不想花那么多钱,该怎么办呢?这时候第三个选项就派上用场了:使用开源库 <a href="/misc/goto?guid=4959635014829173071" rel="nofollow,noindex">Core Plot</a> !</p> <p>Core Plot 是一个2D绘制库,适用于 iOS,Mac OS X 和 tvOS。它使用了像 Quartz 和 Core Animation 这样的苹果应用框架,同时有着全面的测试覆盖,而且是遵照BSD这个比较宽松的许可证进行发布的。</p> <p>在这个教程中,你将学习到如何使用 Core Plot 来创建饼图和柱状图,同时还会实现一些很酷的图表交互!</p> <p>开始之前,你需要安装好 <em>Xcode 7.3</em> ,同时对 <em>Swift</em> , <em>Interface Builder</em> 和 <em>storyboards</em> 有所了解。如果你对这些主题知之甚少,那么你应该在继续阅读本教程之前先学习一下我们其他的一些 <a href="/misc/goto?guid=4959675534673829902" rel="nofollow,noindex">教程</a> 。</p> <p>本教程同时还使用了 CocoaPods 去安装一些第三方的依赖库。如果你从来没使用过 CocoaPods 的话,那你还应该阅读一下我们关于它的 <a href="/misc/goto?guid=4959675534754287692" rel="nofollow,noindex">教程</a> 。</p> <h2>入门</h2> <p>在本教程中,你将创建一个在一定时间间隔内显示货币汇率(情况)的 App。从 <a href="/misc/goto?guid=4959675534837350909" rel="nofollow,noindex">这里</a> 下载本教程的入门项目,把它解压缩后打开 <em>SwiftRates.xcworkspace</em> 。</p> <p>项目的关键类在 <em>App</em> 这个文件夹和它的子文件夹下,它们包括了:</p> <ul> <li> <p><em>DataStore.swift</em> 这是一个从 <a href="/misc/goto?guid=4959675534928703696" rel="nofollow,noindex">Fixer.io</a> 请求货币汇率数据的帮助类。</p> </li> <li> <p><em>Rate.swift</em> 这是一个模型,表示给定日期里的货币汇率。</p> </li> <li> <p><em>Currency.swift</em> 这是一个表示货币类型的模型。支持的货币类型定义在 <em>Resources/Currencies.plist</em> 里。</p> </li> <li> <p><em>MenuViewController.swift</em> 这是一个app启动后展示的第一个视图控制器。它让用户选择一个货币作为基准然后再选两个对照。</p> </li> <li> <p><em>HostViewController.swift</em> 这是一个容器视图控制器,基于它的分段选项选中状态去控制展示 PieChartViewController 或者 BarGraphViewController 的内容。它还会去检查从 DataStore 请求来的汇率数据,因为它们也将在这个视图控制器里展现。</p> </li> <li> <p><em>PieChartViewController.swift</em> 这个控制器将用饼图的形式展示一个给定日期里的汇率。当然你首先要实现它!</p> </li> <li> <p><em>BarGraphViewController.swift</em> 这个控制器将以柱状图的形式展示几天的汇率。当你掌握绘制饼图的方法后,这个图简直小菜一碟!(看到我做的事情了吗?拜托,这真的有点意思!);]</p> </li> </ul> <p>构建并运行看看这个教程入门项目实际展示。</p> <p><img src="https://simg.open-open.com/show/bb007ed68e078faf08323a74c8d71044.png"></p> <p>点选 <em>Get Rates</em> 导航去到 HostViewController 控制的视图然后可以切换分段选项。这个 app 确实还没有实现太多功能...;]</p> <p>是时候用 Core Plot 开始真正的绘制了!</p> <h3>安装 Core Plot</h3> <p>首先你需要安装 Core Plot,最简单的方式是通过 <a href="/misc/goto?guid=4958876601167114464" rel="nofollow,noindex">CocoaPods</a> 安装。</p> <p>把下面这行代码添加进你的 <em>Podfile</em> 文件, pod 'SwiftDate' 这行的后面:</p> <pre> <code class="language-objectivec">pod 'CorePlot', '~> 2.1'</code></pre> <p>打开 <em>Terminal</em> (终端), cd 进入你的项目根目录,然后运行 pod install 。</p> <p>安装完成后,构建项目。</p> <p>没报错吧?很好,现在你可以随便使用 Core Plot 啦,感谢 CocoaPods。:]</p> <p>如果你遇到了任何报错,可以尝试通过 sudo gem install cocoapods 更新一下 CocoaPods 然后再次运行 pod install 。</p> <h2>创建饼图</h2> <p>打开 <em>PieChartViewController.swift</em> 并添加下面这行引入:</p> <pre> <code class="language-objectivec">import CorePlot</code></pre> <p>接着,添加下面这个属性:</p> <pre> <code class="language-objectivec">@IBOutlet weak var hostView: CPTGraphHostingView!</code></pre> <p>CPTGraphHostingView 负责“托管”一个图表或图形。你可以把它想象成一个“图形容器”。</p> <p>然后,把下面这个类扩展添加到文件结尾的花括号之后:</p> <pre> <code class="language-objectivec">extension PieChartViewController: CPTPieChartDataSource, CPTPieChartDelegate { func numberOfRecordsForPlot(plot: CPTPlot) -> UInt { return 0 } func numberForPlot(plot: CPTPlot, field fieldEnum: UInt, recordIndex idx: UInt) -> AnyObject? { return 0 } func dataLabelForPlot(plot: CPTPlot, recordIndex idx: UInt) -> CPTLayer? { return nil } func sliceFillForPieChart(pieChart: CPTPieChart, recordIndex idx: UInt) -> CPTFill? { return nil } func legendTitleForPieChart(pieChart: CPTPieChart, recordIndex idx: UInt) -> String? { return nil } }</code></pre> <p>你将通过 CPTPieChartDataSource 为一个 Core Plot 图表提供数据,同时你会通过 CPTPieChartDelegate 得到用户交互的所有事件。随着教程递进,你将填满这些方法。</p> <h3>建立图表托管视图</h3> <p>继续往下,打开 <em>Main.storyboard</em> 然后选择 PieChartViewController 窗口。</p> <p>在这个视图上拖出一个新的 UIView ,然后把它的类更改成 CPTGraphHostingView ,并将它连接到 hostView 。</p> <p>对这个视图的每个方向添加约束让撑满父视图,并确认没有设置外边距的约束:</p> <p><img src="https://simg.open-open.com/show/c5c2959fedc9a912179ac4a21b9c4795.png"></p> <p>设置一个你喜欢的背景色。我使用了透明度为92%的灰度颜色。</p> <p>现在回到 <em>PieChartViewController.swift</em> ,在 viewDidLoad() 后面添加下面的方法:</p> <pre> <code class="language-objectivec">override func viewDidLayoutSubviews() { super.viewDidLayoutSubviews() initPlot() } func initPlot() { configureHostView() configureGraph() configureChart() configureLegend() } func configureHostView() { } func configureGraph() { } func configureChart() { } func configureLegend() { }</code></pre> <p>这样子就正好在子视图渲染好后设置了绘制策略。这里是你最早为视图设置框架大小的地方,接下来你将需要配置绘制策略。</p> <p>initPlot() 里的每个方法都代表了一个设置绘制策略的阶段。这样子可以让代码保持其可维护性。</p> <p>把下面这行添加进 configureHostView() :</p> <pre> <code class="language-objectivec">hostView.allowPinchScaling = false</code></pre> <p>这行代码将对饼图禁用手势捏合缩放,它决定了托管视图对捏合手势是否会有反应。</p> <p>接下来你需要添加一个图表到 hostView 。添加下面的代码到 configureGraph() 里吧:</p> <pre> <code class="language-objectivec">// 1 - Create and configure the graph let graph = CPTXYGraph(frame: hostView.bounds) hostView.hostedGraph = graph graph.paddingLeft = 0.0 graph.paddingTop = 0.0 graph.paddingRight = 0.0 graph.paddingBottom = 0.0 graph.axisSet = nil // 2 - Create text style let textStyle: CPTMutableTextStyle = CPTMutableTextStyle() textStyle.color = CPTColor.blackColor() textStyle.fontName = "HelveticaNeue-Bold" textStyle.fontSize = 16.0 textStyle.textAlignment = .Center // 3 - Set graph title and text style graph.title = "\(base.name) exchange rates\n\(rate.date)" graph.titleTextStyle = textStyle graph.titlePlotAreaFrameAnchor = CPTRectAnchor.Top</code></pre> <p>下面对每个部分的代码进行分解:</p> <ol> <li> <p>首先你创建了一个 CPTXYGraph 的实例并指定它作为 hostView 的 hostedGraph 。这就将图表和托管视图联系起来了。</p> <pre> <code class="language-objectivec">这个 `CPTGraph` 包括了你所看到的标准图表或图形的全部东西:边,标题,绘制相关数据,轴和图例。 默认情况下,`CPTXYGraph` 每个方向都有一个`20`的内边距。从我们这个项目来看这样并不好,所以你可以显式地将每个方向的内边距设置为`0`。</code></pre> </li> <li> <p>接下来就是通过创建和配置一个 CPTMutableTextStyle 实例来设置该图标标题的文本样式。</p> </li> <li> <p>最后,就是给你刚刚创建的图表实例设置标题和其样式。同样你还需要指定标题锚点为该视图的上边界。</p> </li> </ol> <p>构建并运行app,你应该就可以看到这个图表的标题展示在屏幕上了:</p> <p><img src="https://simg.open-open.com/show/198d4a1ad24c44e6edd86580bc72b77e.png"></p> <h3>绘制饼图</h3> <p>标题看起来不错,但你知道接下来什么会更棒吗?确确实实地看到饼图!</p> <p>将下面的代码添加进 configureChart() :</p> <pre> <code class="language-objectivec">// 1 - Get a reference to the graph let graph = hostView.hostedGraph! // 2 - Create the chart let pieChart = CPTPieChart() pieChart.delegate = self pieChart.dataSource = self pieChart.pieRadius = (min(hostView.bounds.size.width, hostView.bounds.size.height) * 0.7) / 2 pieChart.identifier = graph.title pieChart.startAngle = CGFloat(M_PI_4) pieChart.sliceDirection = .Clockwise pieChart.labelOffset = -0.6 * pieChart.pieRadius // 3 - Configure border style let borderStyle = CPTMutableLineStyle() borderStyle.lineColor = CPTColor.whiteColor() borderStyle.lineWidth = 2.0 pieChart.borderLineStyle = borderStyle // 4 - Configure text style let textStyle = CPTMutableTextStyle() textStyle.color = CPTColor.whiteColor() textStyle.textAlignment = .Center pieChart.labelTextStyle = textStyle // 3 - Add chart to graph graph.addPlot(pieChart)</code></pre> <p>下面看看这段代码做了什么:</p> <ol> <li> <p>首先获取了刚刚创建的图表的引用。</p> </li> <li> <p>然后实例化一个 CPTPieChart ,将它的代理和数据源设置成这个视图控制器本身,并配置它的一些外观属性。</p> </li> <li> <p>接着配置这个图表的边框样式。</p> </li> <li> <p>配置它的文本样式。</p> </li> <li> <p>最后,将这个饼图添加进刚刚引用的图表里。</p> </li> </ol> <p>如果现在重新构建并运行 app,你将看不到任何变化...因为你还需要实现这个饼图的代理和数据源。</p> <p>首先,用下面这段替代了现在的 numberOfRecordsForPlot(_:) 方法:</p> <pre> <code class="language-objectivec">func numberOfRecordsForPlot(plot: CPTPlot) -> UInt { return UInt(symbols.count) ?? 0 }</code></pre> <p>这个方法决定了有多少块(部分)显示在饼状图上,它将为每一个标记显示一块(部分)。</p> <p>接下来,用下面这段替换掉 numberForPlot(_:field:recordIndex:) :</p> <pre> <code class="language-objectivec">func numberForPlot(plot: CPTPlot, field fieldEnum: UInt, recordIndex idx: UInt) -> AnyObject? { let symbol = symbols[Int(idx)] let currencyRate = rate.rates[symbol.name]!.floatValue return 1.0 / currencyRate }</code></pre> <p>饼图会使用这个方法得到索引为 recordIndex 的货币符号的“总”值。</p> <p>你应该注意到这个值并 <em>不是</em> 一个百分比值。取而代之的是,这个方法计算出了相对基准货币的货币汇率:返回的这个 1.0 / currencyRate 的值是"一个单位的基准货币是多少价值的另外的对照货币"的汇率。</p> <p>CPTPieChart 将查看计算每个分块的百分比值,这个值最终决定了这个分块占多大。</p> <p>下面,用下面这行替代掉 dataLabelForPlot(_:recordIndex:) :</p> <pre> <code class="language-objectivec">func dataLabelForPlot(plot: CPTPlot, recordIndex idx: UInt) -> CPTLayer? { let value = rate.rates[symbols[Int(idx)].name]!.floatValue let layer = CPTTextLayer(text: String(format: "\(symbols[Int(idx)].name)\n%.2f", value)) layer.textStyle = plot.labelTextStyle return layer }</code></pre> <p>这个方法返回了饼图分片的标签。期望的返回类型 CPTLayer 和 CALayer 有点相似,但是 CPTLayer 更加抽象,在 Mac OS X 和 iOS 上都能用,还提供了额外的绘图细节供 Core Plot 使用。</p> <p>这里,创建并返回一个 CPTLayer 的子类 CPTTextLayer 去展示文本。</p> <p>最后,将下面这段代码替换掉 sliceFillForPieChart(_:, recordIndex:) 去添加分片的颜色:</p> <pre> <code class="language-objectivec">func sliceFillForPieChart(pieChart: CPTPieChart, recordIndex idx: UInt) -> CPTFill? { switch idx { case 0: return CPTFill(color: CPTColor(componentRed:0.92, green:0.28, blue:0.25, alpha:1.00)) case 1: return CPTFill(color: CPTColor(componentRed:0.06, green:0.80, blue:0.48, alpha:1.00)) case 2: return CPTFill(color: CPTColor(componentRed:0.22, green:0.33, blue:0.49, alpha:1.00)) default: return nil } }</code></pre> <p>构建并运行,你就将看到一个漂亮的饼图了:</p> <p><img src="https://simg.open-open.com/show/ffa493aff0363226fd99c4a458ef109f.png"></p> <h3>等一下...图例呢!</h3> <p>这个图表看上去相当不错,但是添加一个图例应该会让它更棒。接下来你将学习怎么添加一个图例到这个图表里。</p> <p>首先,用下面这段替换掉 configureLegend() :</p> <pre> <code class="language-objectivec">func configureLegend() { // 1 - Get graph instance guard let graph = hostView.hostedGraph else { return } // 2 - Create legend let theLegend = CPTLegend(graph: graph) // 3 - Configure legend theLegend.numberOfColumns = 1 theLegend.fill = CPTFill(color: CPTColor.whiteColor()) let textStyle = CPTMutableTextStyle() textStyle.fontSize = 18 theLegend.textStyle = textStyle // 4 - Add legend to graph graph.legend = theLegend if view.bounds.width > view.bounds.height { graph.legendAnchor = .Right graph.legendDisplacement = CGPoint(x: -20, y: 0.0) } else { graph.legendAnchor = .BottomRight graph.legendDisplacement = CGPoint(x: -8.0, y: 8.0) } }</code></pre> <p>同样你也需要为每个分片提供图例的数据。</p> <p>要提供数据,就用下面这段替换掉 legendTitleForPieChart(_:recordIndex:) :</p> <pre> <code class="language-objectivec">func legendTitleForPieChart(pieChart: CPTPieChart, recordIndex idx: UInt) -> String? { return symbols[Int(idx)].name }</code></pre> <p>构建并运行,你就会得到一个“带图例的”图表啦。</p> <p><img src="https://simg.open-open.com/show/6cdf939cdf6182a256b520226fc726e0.png"></p> <h2>创建柱状图</h2> <p>看样子你已经是绘制饼图的专家啦,但是时候去搞一个柱状图了!</p> <p>打开 BarGraphViewController 并添加下面这行:</p> <pre> <code class="language-objectivec">import CorePlot</code></pre> <p>接着,再添加下面这行:</p> <pre> <code class="language-objectivec">@IBOutlet var hostView: CPTGraphHostingView!</code></pre> <p>其实就和饼图一样,托管视图将承载这个柱状图的展示。</p> <p>下一步,添加下面这些属性:</p> <pre> <code class="language-objectivec">var plot1: CPTBarPlot! var plot2: CPTBarPlot! var plot3: CPTBarPlot!</code></pre> <p>这里声明了三个 CPTBarPlot 类型的属性,它们就相当于展示在图表中的每种货币。</p> <p>注意到同样也有三个 IBOutlet 标签和三个 IBAction 方法已经被定义了,你都可以在 storyboard 上看到它们。</p> <p>最后,把下面这个类扩展添加到文件末尾:</p> <pre> <code class="language-objectivec">extension BarGraphViewController: CPTBarPlotDataSource, CPTBarPlotDelegate { func numberOfRecordsForPlot(plot: CPTPlot) -> UInt { return 0 } func numberForPlot(plot: CPTPlot, field fieldEnum: UInt, recordIndex idx: UInt) -> AnyObject? { return 0 } func barPlot(plot: CPTBarPlot, barWasSelectedAtRecordIndex idx: UInt, withEvent event: UIEvent) { } }</code></pre> <p>这和创建饼图的过程太像了:通过 CPTBarPlotDataSource 为柱状图提供数据,通过 CPTBarPlotDelegate 捕捉用户交互事件。你只需要复制粘贴就好了。</p> <h3>再次配置图表托管视图</h3> <p>就像刚刚创建饼图时候一样,再次需要通过界面生成器把托管视图添加进去。</p> <p>回到 <em>Main.storyboard</em> 并选择 BarGraphViewController 窗口。</p> <p>在视图上拖拽出一个新的 UIView ,将它的类更改为 CPTGraphHostingView 并将其输出连接到控制器里的 hostView 。</p> <p>通过 <em>UtilitiesSize Inspector</em> (那个 <em>刻度尺</em> 选项卡)将它的框架更新到下面那样:</p> <p>X = 0, Y = 53, Width = 600, Height = 547</p> <p><img src="https://simg.open-open.com/show/81e0072ed9d933894b5fa3a34646f7ba.jpg"></p> <p>添加它和所有相邻元素的约束,确认没有设置 <em>外边距约束</em> 。</p> <p><img src="https://simg.open-open.com/show/eb7cb6f2ec72313f173f91d36d267fd1.png"></p> <p>最后,设置一个你喜欢的背景颜色。我再次用了92%透明度的灰度颜色。</p> <h3>绘制柱状图</h3> <p>既然 UI 已经通过上面的学习全部弄好了,是时候去绘制一个柱状图了。</p> <p>首先,回到 BarGraphViewController ,你需要一对常量属性。把下面这段添加到其他属性之前:</p> <pre> <code class="language-objectivec">let BarWidth = 0.25 let BarInitialX = 0.25</code></pre> <p>你还需要一个帮助函数去计算最高的率值。把下面这段添加到 updateLabels() 之后:</p> <pre> <code class="language-objectivec">func highestRateValue() -> Double { var maxRate = DBL_MIN for rate in rates { maxRate = max(maxRate, rate.maxRate().doubleValue) } return maxRate }</code></pre> <p>接着,把下面的方法添加到 highestRateValue() 之后:</p> <pre> <code class="language-objectivec">override func viewDidLayoutSubviews() { super.viewDidLayoutSubviews() initPlot() } func initPlot() { configureHostView() configureGraph() configureChart() configureAxes() } func configureHostView() { } func configureGraph() { } func configureChart() { } func configureAxes() { }</code></pre> <p>是不是看上去很眼熟?是的,这些和之前的结构完全一样。</p> <p>下面这行添加到 configureHostView() 里:</p> <pre> <code class="language-objectivec">hostView.allowPinchScaling = false</code></pre> <p>因为你不需要捏合缩放,所以你应该再次把它禁用。</p> <p>接着,把下面那么多行代码添加到 configureGraph() 里:</p> <pre> <code class="language-objectivec">// 1 - Create the graph let graph = CPTXYGraph(frame: hostView.bounds) graph.plotAreaFrame?.masksToBorder = false hostView.hostedGraph = graph // 2 - Configure the graph graph.applyTheme(CPTTheme(named: kCPTPlainWhiteTheme)) graph.fill = CPTFill(color: CPTColor.clearColor()) graph.paddingBottom = 30.0 graph.paddingLeft = 30.0 graph.paddingTop = 0.0 graph.paddingRight = 0.0 // 3 - Set up styles let titleStyle = CPTMutableTextStyle() titleStyle.color = CPTColor.blackColor() titleStyle.fontName = "HelveticaNeue-Bold" titleStyle.fontSize = 16.0 titleStyle.textAlignment = .Center graph.titleTextStyle = titleStyle let title = "\(base.name) exchange rates\n\(rates.first!.date) - \(rates.last!.date)" graph.title = title graph.titlePlotAreaFrameAnchor = .Top graph.titleDisplacement = CGPointMake(0.0, -16.0) // 4 - Set up plot space let xMin = 0.0 let xMax = Double(rates.count) let yMin = 0.0 let yMax = 1.4 * highestRateValue() guard let plotSpace = graph.defaultPlotSpace as? CPTXYPlotSpace else { return } plotSpace.xRange = CPTPlotRange(locationDecimal: CPTDecimalFromDouble(xMin), lengthDecimal: CPTDecimalFromDouble(xMax - xMin)) plotSpace.yRange = CPTPlotRange(locationDecimal: CPTDecimalFromDouble(yMin), lengthDecimal: CPTDecimalFromDouble(yMax - yMin))</code></pre> <p>下面是这段代码逻辑的拆解:</p> <ol> <li> <p>首先,实例化一个 CPTXYGraph ,实际上就是一个柱状图,并将它关联到 hostView 。</p> </li> <li> <p>然后声明一个 <em>简约的白色</em> 默认主题并为了展示 XY 轴去设置左侧和下方的内边距。</p> </li> <li> <p>接着设置文本样式,图表标题以及标题位置。</p> </li> <li> <p>最后,配置 CPTXYPlotSpace ,它负责将设备的坐标系映射到图表的坐标系。针对这个图表,你正在绘制三个使用了相同坐标系的汇率。然而,也有可能每个条形图的坐标系都是 <em>分离</em> 的。你还要在坐标系中假定一个最大最小值汇率范围。在后面的教程中,你将学习到怎么样在不提前设定范围的情况下自动调节空间大小。</p> </li> </ol> <p>既然已经创建好图表了,那是时候增加一些绘制方法进去了!把下面的代码添加到 configureChart() 里:</p> <pre> <code class="language-objectivec">// 1 - Set up the three plots plot1 = CPTBarPlot() plot1.fill = CPTFill(color: CPTColor(componentRed:0.92, green:0.28, blue:0.25, alpha:1.00)) plot2 = CPTBarPlot() plot2.fill = CPTFill(color: CPTColor(componentRed:0.06, green:0.80, blue:0.48, alpha:1.00)) plot3 = CPTBarPlot() plot3.fill = CPTFill(color: CPTColor(componentRed:0.22, green:0.33, blue:0.49, alpha:1.00)) // 2 - Set up line style let barLineStyle = CPTMutableLineStyle() barLineStyle.lineColor = CPTColor.lightGrayColor() barLineStyle.lineWidth = 0.5 // 3 - Add plots to graph guard let graph = hostView.hostedGraph else { return } var barX = BarInitialX let plots = [plot1, plot2, plot3] for plot: CPTBarPlot in plots { plot.dataSource = self plot.delegate = self plot.barWidth = BarWidth plot.barOffset = barX plot.lineStyle = barLineStyle graph.addPlot(plot, toPlotSpace: graph.defaultPlotSpace) barX += BarWidth }</code></pre> <p>接着来看看上面的代码干了什么:</p> <ol> <li> <p>实例化每个条形图并设置它们的填充色。</p> </li> <li> <p>实例化一个代表每个条形图的外部边框的 CPTMutableLineStyle 实例。</p> </li> <li> <p>给每个条形图提供“共同配置”。该配置包括设置数据源和代理,宽度和每个条形图在坐标系中的相对位置(左右)以及线条样式,最后,添加这个坐标系到图表当中。</p> </li> </ol> <p>虽然还不可以看到柱状图展示出来,但通过构建 app 可以去验证目前为止是否所有代码都可以正确编译通过。</p> <p>为了确切看到柱状图展示数据出来,需要去实现提供图表所需数据的代理方法。</p> <p>用下面这行替换掉 numberOfRecordsForPlot(:_) :</p> <pre> <code class="language-objectivec">return UInt(rates.count ?? 0)</code></pre> <p>该方法返回了应该展示的记录的总数。</p> <p>下面这段替换掉 numberForPlot(_:field:recordIndex:) :</p> <pre> <code class="language-objectivec">if fieldEnum == UInt(CPTBarPlotField.BarTip.rawValue) { if plot == plot1 { return 1.0 } if plot == plot2 { return rates[Int(idx)].rates[symbols[0].name]!.floatValue } if plot == plot3 { return rates[Int(idx)].rates[symbols[1].name]!.floatValue } } return idx</code></pre> <p>CPTBarPlotField.BarTip 的值表明了柱状图的相对大小。在你需要取回数据的时候可以使用保留属性计算出汇率, recordIndex 对应了利息率的位置。</p> <p>构建并运行,你应该可以看到和下面这张图一样的情况:</p> <p><img src="https://simg.open-open.com/show/21df8ed7d1d3cf1e195d14cdf934b78a.png"></p> <p>已经快完成了!但请注意还没有任何东西指明每个坐标轴是代表什么意思。</p> <p>要解决这个问题,把下面这段添加进 configureAxes() :</p> <pre> <code class="language-objectivec">// 1 - Configure styles let axisLineStyle = CPTMutableLineStyle() axisLineStyle.lineWidth = 2.0 axisLineStyle.lineColor = CPTColor.blackColor() // 2 - Get the graph's axis set guard let axisSet = hostView.hostedGraph?.axisSet as? CPTXYAxisSet else { return } // 3 - Configure the x-axis if let xAxis = axisSet.xAxis { xAxis.labelingPolicy = .None xAxis.majorIntervalLength = 1 xAxis.axisLineStyle = axisLineStyle var majorTickLocations = Set<nsnumber>() var axisLabels = Set<cptaxislabel>() for (idx, rate) in rates.enumerate() { majorTickLocations.insert(idx) let label = CPTAxisLabel(text: "\(rate.date)", textStyle: CPTTextStyle()) label.tickLocation = idx label.offset = 5.0 label.alignment = .Left axisLabels.insert(label) } xAxis.majorTickLocations = majorTickLocations xAxis.axisLabels = axisLabels } // 4 - Configure the y-axis if let yAxis = axisSet.yAxis { yAxis.labelingPolicy = .FixedInterval yAxis.labelOffset = -10.0 yAxis.minorTicksPerInterval = 3 yAxis.majorTickLength = 30 let majorTickLineStyle = CPTMutableLineStyle() majorTickLineStyle.lineColor = CPTColor.blackColor().colorWithAlphaComponent(0.1) yAxis.majorTickLineStyle = majorTickLineStyle yAxis.minorTickLength = 20 let minorTickLineStyle = CPTMutableLineStyle() minorTickLineStyle.lineColor = CPTColor.blackColor().colorWithAlphaComponent(0.05) yAxis.minorTickLineStyle = minorTickLineStyle yAxis.axisLineStyle = axisLineStyle }</cptaxislabel></nsnumber></code></pre> <p>简单地说,上面的代码首先为轴线和标题定义了样式,然后,为图表添加坐标轴的设置并配置好 x 轴和 y 轴的一些属性。</p> <p>构建并运行就可以看到这些改动的结果了。</p> <p><img src="https://simg.open-open.com/show/89156b7335c1b72f0ffc5f1125f3c0b3.png"></p> <h3>功能化坐标轴</h3> <p>更棒了对吧?唯一的缺陷在于这个坐标轴太简单了,没办法从这儿得到一个准确的汇率展示。</p> <p>你可以修复这个问题以便当用户点按在一个单独的柱状图时,这个 app 可以展示这个图表示的汇率。为了实现它,需要增加一个新的属性:</p> <pre> <code class="language-objectivec">var priceAnnotation: CPTPlotSpaceAnnotation?</code></pre> <p>然后把下面的代码添加到 barPlot(_:barWasSelectedAtRecordIndex:) :</p> <pre> <code class="language-objectivec">// 1 - Is the plot hidden? if plot.hidden == true { return } // 2 - Create style, if necessary let style = CPTMutableTextStyle() style.fontSize = 12.0 style.fontName = "HelveticaNeue-Bold" // 3 - Create annotation guard let price = numberForPlot(plot, field: UInt(CPTBarPlotField.BarTip.rawValue), recordIndex: idx) as? CGFloat else { return } priceAnnotation?.annotationHostLayer?.removeAnnotation(priceAnnotation) priceAnnotation = CPTPlotSpaceAnnotation(plotSpace: plot.plotSpace!, anchorPlotPoint: [0,0]) // 4 - Create number formatter let formatter = NSNumberFormatter() formatter.maximumFractionDigits = 2 // 5 - Create text layer for annotation let priceValue = formatter.stringFromNumber(price)! let textLayer = CPTTextLayer(text: priceValue, style: style) priceAnnotation!.contentLayer = textLayer // 6 - Get plot index var plotIndex: Int = 0 if plot == plot1 { plotIndex = 0 } else if plot == plot2 { plotIndex = 1 } else if plot == plot3 { plotIndex = 2 } // 7 - Get the anchor point for annotation let x = CGFloat(idx) + CGFloat(BarInitialX) + (CGFloat(plotIndex) * CGFloat(BarWidth)) let y = CGFloat(price) + 0.05 priceAnnotation!.anchorPlotPoint = [x, y] // 8 - Add the annotation guard let plotArea = plot.graph?.plotAreaFrame?.plotArea else { return } plotArea.addAnnotation(priceAnnotation)</code></pre> <p>这里需要一些解释:</p> <ol> <li> <p>不要给一个隐藏的柱状图展示注解,而当图没有设置隐藏属性的时候,在把切换开关整合到图表之后,你就将实现它了。</p> </li> <li> <p>这里还要为你的注解创建一个文本样式。</p> </li> <li> <p>得到指定柱状图的汇率,然后如果它不存在一个注解对象,就创建一个。</p> </li> <li> <p>如果没有数值格式化的方法还需要创建一个,因为在汇率展示的时候需要先格式化它。</p> </li> <li> <p>创建一个使用这个格式化汇率的文本层,并将注解的内容层设置到这个新的文本层上。</p> </li> <li> <p>获取你将展示的注解需要放置的柱状图索引。</p> </li> <li> <p>基于这个索引计算注解的位置,并给使用这个计算位置注解设置 anchorPlotPoint 的值。</p> </li> <li> <p>最后,将注解添加到图表上。</p> </li> </ol> <p>构建并运行。每次当你点按图表中的一个柱体时,该柱体所表示的值就应该正好在其上方弹出来。</p> <p>棒极了! :]</p> <p><img src="https://simg.open-open.com/show/9b572e11f33cd468fc6b13b20cb069d9.png"></p> <h3>隐藏和查找</h3> <p>这个柱状图看起来很棒,但屏幕最上方的切换开关并没有起什么作用,是时候改动它们了。</p> <p>首先,需要添加一个帮助方法,把下面这段添加到 switch3Changed(_:) 之后:</p> <pre> <code class="language-objectivec">func hideAnnotation(graph: CPTGraph) { guard let plotArea = graph.plotAreaFrame?.plotArea, priceAnnotation = priceAnnotation else { return } plotArea.removeAnnotation(priceAnnotation) self.priceAnnotation = nil }</code></pre> <p>这段代码首先简单地移除了一个如果存在的注解。</p> <p>下一步,你希望用户通过切换开关展示一个给定的货币汇率柱状图。</p> <p>要做到这个功能,用下面这段替换到 switch1Changed(_:) , switch2Changed(_:) 和 switch3Changed(_:) 的实现。</p> <pre> <code class="language-objectivec">@IBAction func switch1Changed(sender: UISwitch) { let on = sender.on if !on { hideAnnotation(plot1.graph!) } plot1.hidden = !on } @IBAction func switch2Changed(sender: UISwitch) { let on = sender.on if !on { hideAnnotation(plot2.graph!) } plot2.hidden = !on } @IBAction func switch3Changed(sender: UISwitch) { let on = sender.on if !on { hideAnnotation(plot3.graph!) } plot3.hidden = !on }</code></pre> <p>这个逻辑相当简单。如果开关设置了关闭,相关的图和其可见的注解就将被隐藏,而如果设置为开启,则图就会被设置为可见。</p> <p>构建并运行。现在你可以在图表中随意切换每个柱状图的展示了。教程至此已经完成了很不错的工作!</p> <p><img src="https://simg.open-open.com/show/7a39accce2f0d421692d7c1bdd03f715.gif"></p> <h2>接下来干点啥?</h2> <p>你可以从 <a href="/misc/goto?guid=4959675535048693325" rel="nofollow,noindex">这里</a> 下载一个已完成的项目。</p> <p>哇哦,相当有趣!这个教程重点介绍了 Core Plot 的强大功能并希望提示了你该怎么在你自己的 apps 里使用它。</p> <p>当然还可以参考 <a href="/misc/goto?guid=4959635014829173071" rel="nofollow,noindex">Core Plot</a> 仓库获取更多的信息,包括文档,例子和一些小贴士。</p> <p>还有,如果你对这个教程有任何的问题或者评论,欢迎加入下面的论坛进行讨论。</p> <p>祝你有个快乐的绘图过程!</p> <p> </p> <p><a href="/misc/goto?guid=4959675535137639660">阅读原文</a></p> <p> </p>