SwiftUI Charts 入门指南:5分钟搞定BarMark和PointMark的基础用法

SwiftUI——如何使用自带的原生图表(Charts) 在 WWDC2022 上,苹果为 SwiftUI 提供了图表相关的包Charts,这下就不用自己费劲实现图表功能了。代码量一下子从四五百行变成了十几行,甚至几行。如果是老系统的话还是得手写。自定义颜色,线图点图条形图,颜色,组合,自定义 阅读详情

SwiftUI Charts 实战:从零构建你的第一个数据可视化图表

最近在开发一个个人健康追踪应用时,我需要快速为应用添加一个简洁的体重变化趋势图。一开始我考虑使用第三方图表库,但引入外部依赖总是带来额外的维护成本和包体积问题。直到我重新审视了 SwiftUI 自带的 Charts 框架,才发现苹果已经为我们准备了一套既强大又优雅的原生解决方案。今天我想和你分享的,就是如何用最短的时间,让 BarMark 和 PointMark 这两个最基础的图表元素在你的应用中“活”起来。

如果你和我一样,面对产品经理“明天就要看到图表效果”的需求时感到压力,或者你只是想为个人项目添加一些数据可视化功能而不想陷入复杂的配置泥潭,那么这篇文章正是为你准备的。我们将避开那些冗长的理论,直接进入实战,用最少的代码实现最实用的图表效果。你会发现,原来在 SwiftUI 中创建专业的图表,真的可以像搭积木一样简单有趣。

1. 环境准备与数据建模

在开始绘制图表之前,我们需要确保开发环境已经就绪。SwiftUI Charts 框架作为苹果在 WWDC 2022 年推出的原生组件,对系统版本有明确的要求。你的项目需要至少满足以下条件:

  • iOS/iPadOS 16.0 或更高版本
  • macOS 13.0 (Ventura) 或更高版本
  • watchOS 9.0 或更高版本
  • Xcode 14.0 或更高版本

提示:如果你的应用需要支持更早的系统版本,那么 Charts 框架将无法使用,你需要考虑第三方图表库或自定义绘制方案。

确认环境支持后,第一步不是急着写图表代码,而是思考你的数据结构。这是很多初学者容易忽略的关键步骤——糟糕的数据结构会让后续的图表配置变得异常复杂。让我们从一个实际场景开始:假设你正在开发一个简单的销售数据看板,需要展示过去一周每天的销售额。

1.1 设计合理的数据模型

对于柱状图(BarMark)和点图(PointMark)来说,数据模型的设计直接决定了图表的可读性和易用性。我建议遵循以下原则:

  1. 每个数据点应该是独立的实体,最好遵循 Identifiable 协议
  2. 明确区分维度(x轴)和度量(y轴) 字段
  3. 考虑数据的可扩展性,为后续的多维度分析留出空间

基于这些原则,我们可以这样设计销售数据模型:

import Foundation

// 销售数据点模型
struct DailySales: Identifiable {
    let id = UUID()  // 唯一标识符,Charts框架推荐使用
    let date: Date   // 日期 - 通常作为x轴维度
    let amount: Double  // 销售额 - 通常作为y轴度量
    let category: String?  // 可选:商品类别,用于分组显示
    
    // 便捷初始化方法
    init(date: Date, amount: Double, category: String? = nil) {
        self.date = date
        self.amount = amount
        self.category = category
    }
}

这个模型虽然简单,但已经包含了图表所需的核心要素。Identifiable 协议确保每个数据点都有唯一标识,这在 Charts 框架内部处理数据更新和动画时非常重要。

1.2 准备模拟数据

在实际开发中,你的数据可能来自网络API或本地数据库。但在原型阶段,使用模拟数据可以让我们快速验证图表效果。下面是一个生成过去一周销售数据的实用方法:

extension DailySales {
    // 生成过去7天的模拟销售数据
    static func generateSampleData() -> [DailySales] {
        let calendar = Calendar.current
        let today = Date()
        var salesData: [DailySales] = []
        
        // 生成过去7天的数据
        for dayOffset in 0..<7 {
            guard let date = calendar.date(byAdding: .day, value: -dayOffset, to: today) else {
                continue
            }
            
            // 模拟销售额(5000-15000之间的随机值)
            let amount = Double.random(in: 5000...15000)
            
            // 模拟商品类别(仅用于演示分组功能)
            let categories = ["电子产品", "服装", "食品", "家居"]
            let category = categories.randomElement()
            
            let sales = DailySales(date: date, amount: amount, category: category)
            salesData.append(sales)
        }
        
        // 按日期排序(从早到晚)
        return salesData.sorted { $0.date < $1.date }
    }
}

这个数据生成方法有几个值得注意的细节:

  • 使用真实的日期对象而不是字符串,这样 Charts 框架可以自动处理日期格式化和刻度
  • 包含随机性但又在合理范围内,这能让图表看起来更真实
  • 提供可选的分类字段,为后续的多系列图表做准备

现在我们已经有了数据和模型,接下来就可以开始创建第一个图表了。

2. BarMark 柱状图:快速展示数据对比

柱状图可能是数据可视化中最常用的图表类型之一。它通过不同高度的柱子直观展示数据的大小对比,特别适合展示离散数据的分布情况。在 SwiftUI Charts 中,BarMark 就是实现柱状图的核心组件。

2.1 创建基础柱状图

让我们从最简单的单系列柱状图开始。假设我们只需要展示每天的销售额,不考虑商品类别。首先,在 SwiftUI 视图中导入 Charts 框架:

import SwiftUI
import Charts

struct SalesChartView: View {
    // 使用我们之前准备的模拟数据
    let salesData = DailySales.generateSampleData()
    
    var body: some View {
        VStack(alignment: .leading, spacing: 16) {
            Text("近7日销售额")
                .font(.title2)
                .fontWeight(.semibold)
            
            Chart {
                ForEach(salesData) { sale in
                    BarMark(
                        x: .value("日期", sale.date, unit: .day),
                        y: .value("销售额", sale.amount)
                    )
                }
            }
            .frame(height: 300)
            .padding()
            .background(Color(.systemBackground))
            .cornerRadius(12)
            .shadow(color: .black.opacity(0.1), radius: 4, x: 0, y: 2)
        }
        .padding()
    }
}

这段代码虽然简短,但已经创建了一个功能完整的柱状图。让我解释几个关键点:

  • Chart { } 是图表容器,所有图表元素都需要放在这个闭包内
  • ForEach 遍历数据数组,为每个数据点创建一个 BarMark
  • .value(_:_:) 方法用于指定坐标轴的值,第一个参数是描述标签(在辅助功能中会用到),第二个是实际值
  • 日期处理:通过 unit: .day 参数,我们告诉 Charts 按天聚合日期数据

运行这段代码,你会看到一个简洁的柱状图,x轴显示日期,y轴显示销售额,每个柱子代表一天的销售情况。

2.2 自定义柱状图样式

默认的蓝色柱子虽然清晰,但可能不符合你的应用设计语言。Charts 框架提供了丰富的自定义选项。让我们来美化一下这个图表:

Chart {
    ForEach(salesData) { sale in
        BarMark(
            x: .value("日期", sale.date, unit: .day),
            y: .value("销售额", sale.amount)
        )
        // 自定义柱子颜色
        .foregroundStyle(
            LinearGradient(
                colors: [.blue, .purple],
                startPoint: .bottom,
                endPoint: .top
            )
        )
        // 添加圆角效果
        .cornerRadius(4)
        // 添加悬停效果(仅限支持平台)
        .annotation {
            if sale.amount > 12000 {
                Text("高峰")
                    .font(.caption2)
                    .foregroundColor(.red)
                    .padding(4)
                    .background(Color.red.opacity(0.1))
                    .cornerRadius(4)
            }
        }
    }
}
// 自定义坐标轴样式
.chartXAxis {
    AxisMarks(values: .stride(by: .day)) { value in
        AxisGridLine()
        AxisTick()
        AxisValueLabel(format: .dateTime.weekday(.abbreviated))
    }
}
.chartYAxis {
    AxisMarks(position: .leading) { value in
        AxisGridLine()
        AxisTick()
        AxisValueLabel {
            if let doubleValue = value.as(Double.self) {
                Text("\(Int(doubleValue / 1000))k")
            }
        }
    }
}
// 添加图表标题
.chartPlotStyle { plotArea in
    plotArea
        .background(Color.gray.opacity(0.05))
}

通过这段代码,我们实现了:

  • 渐变颜色的柱子,从蓝色到紫色的垂直渐变
  • 圆角柱子,让图表看起来更现代
  • 智能标注,自动标记销售额超过12000的高峰日
  • 自定义坐标轴,x轴显示星期几,y轴显示简化格式(如"10k")
  • 背景色,为图表区域添加浅灰色背景

2.3 处理多系列数据(分组柱状图)

在实际业务中,我们经常需要对比不同类别的数据。比如,不仅要看每天的销售总额,还想知道每个商品类别的贡献。这就是分组柱状图的用武之地。

首先,我们需要调整数据模型,确保包含类别信息。然后修改图表代码:

// 假设我们的数据已经包含category字段
Chart {
    ForEach(salesData) { sale in
        if let category = sale.category {
            BarMark(
                x: .value("日期", sale.date, unit: .day),
                y: .value("销售额", sale.amount)
            )
            // 按类别分组
            .foregroundStyle(by: .value("类别", category))
        }
    }
}
// 为不同类别指定颜色
.chartForegroundStyleScale([
    "电子产品": .blue,
    "服装": .green,
    "食品": .orange,
    "家居": .purple
])
// 添加图例
.chartLegend(position: .top, alignment: .center, spacing: 16)

这里的关键是 .foregr

SwiftUI 4.0 中原生图表(Charts)实现超长内容滚动功能 在本篇博文中,我们通过两种方式在 iOS 16 里实现了SwiftUI 4.0 中原生图表(Charts)超长内容的滚动显示功能,现在再多的内容也可以分页在图表中美美的显示了。 阅读详情

相关推荐

使用 SwiftUI 中的图表进行数据可视化,使用代码片段和自定义,了解如何使用 SwiftUI 和图表提高应用程序的标准

向 Swift Charts 问好吧——这是一个灵活的框架,可帮助您完全在 SwiftUI 中创建图表,这些图表在所有 Apple 平台上看起来和感觉都很自在。探索如何使用组合语法以更少的代码制作信息丰富、令人愉悦且易于访问的图表。我们将分享使用 Swift Charts 进行可视化的构建块,并探索如何使用简单的修改器更改图表的设计。我们还将带您了解 Xcode 预览的最新更新,以帮助您规划通往引人入胜的体验的道路。” — 来自 Apple 开发者网站。

iCloudEnd的博客 618

SwiftUI与Charts:可视化数据展示

在移动应用中,数据可视化是“让数字说话”的关键——用户能通过图表瞬间理解数据趋势,而不是盯着表格里的数字发呆。本文将聚焦苹果生态(iOS 16+、macOS 13+),讲解如何用SwiftUI(声明式UI框架)与Charts(官方图表库)组合,高效实现柱状图、折线图、饼图等常见图表,覆盖基础用法到进阶技巧。本文从“为什么需要Charts”讲起,用“早餐店卖包子”的故事引出核心概念,再通过代码实战一步步带你实现图表,最后分享真实场景和未来趋势。即使你没用过Charts,也能跟着示例动手敲出第一个图表。

移动开发前沿的博客 1175

SwiftUI 绘图库之 SwiftUI 的图表和绘图库(教程含源码)

SwiftUI 绘图库之 SwiftUI 的图表和绘图库(教程含源码)SwiftUI 的图表/绘图库。适用于 macOS、iOS、watchOS 和 tvOS,并具有内置的辅助功能和本地化功能。

code2day的博客 379

LightChart:SwiftUI图表

LightChart是带有折线图实现的轻量级SwiftUI软件包。 当您只需要一个完全适合您的视图的图表时,可以使用它。 它没有任何交互,标题,不同类型的图表或其他任何东西,仅表示您的数据集。 当前, LightChart仅具有带有尖角或曲线的line图表。 这就是实际应用中有关货币汇率示例的外观: 安装 这是一个Swift软件包,因此您需要执行以下操作: 在Xcode菜单中打开File 打开Swift Packages 选择Add Package Dependency...选项 在Enter package repository URL字段中,粘贴以下URL: https://github.com/pichukov/LightChart : https://github.com/pichukov/LightChart 选择任何现有版本或master分支选项 用法 添加impor

SwiftUICharts:一个简单的折线图和条形图库,支持使用SwiftUI编写的可访问性

SwiftUI图表 一个简单的折线图和条形图库,支持使用SwiftUI编写的可访问性。 用法 垂直条形图 let highIntensity = Legend ( color : . orange , label : " High Intensity " , order : 5 ) let buildFitness = Legend ( color : . yellow , label : " Build Fitness " , order : 4 ) let fatBurning = Legend ( color : . green , label : " Fat Burning " , order : 3 ) let warmUp = Legend ( color : . blue , label : " Warm Up " , order : 2 ) let low = Legend

SwiftUICharts-使用SwiftUI绘制简单,动画的图表-Swift开发

该项目显示了一种使用SwiftUI制作一些简单图表的方法。 当它们的数据更改时,会设置动画的ColumnChart,BarChart,LineChart和PieChart。 这些图表的数据是代表百分比的Double值数组。 为了使事情变得容易一些,有一个ChartModel可以使用Double的任何数组并将其转换为百分比值。 SwiftUICharts使用SwiftUI绘制简单,动画的图表此项目显示了一种使用SwiftUI制作一些简单图表的方法。 当它们的数据更改时,会设置动画的ColumnChart,BarChart,LineChart和PieChart。 这些图表的数据是代表百分比的Double值数组。 为了使事情变得容易一些,有一个ChartModel可以使用Double的任何数组并将其转换为百分比值。 一个示例显示了如何使用图表视图,包括自定义日期

适用于所有Apple平台的轻巧易用的SwiftUI图表库-Swift开发

SwiftUI条形图SwiftUI条形图适用于所有Apple平台的轻巧易用的SwiftUI图表库功能在两个轴上均可缩放完全可自定义的轴(标签字体,颜色,虚线)自定义渐变条React性图表配置条形选择API [WIP]水平滚动要求iOS 13 + / macOS 10.15 + / watchOS 6 + / tvOS 13+ Xcode 11.0+ Swift 5+安装Swift Package Manager将此swift软件包添加到您的项目中https://github.com/dawigr/BarChart.git用法Se

macOS SwiftUI完整代码之绘制柱状图

macOS SwiftUI完整代码之绘制柱状图。1、取消间距VStack(spacing: 0)。2、矩状图Capsule();3、设置高度.frame(width: 10, height: CGFloat(value))。

STM32G0实战:手把手教你用国产GD25Q16 Flash存储传感器数据(附完整驱动)

本文详细介绍了如何使用国产GD25Q16 Flash芯片与STM32G0系列MCU实现传感器数据存储的完整方案。从SPI接口配置、驱动层实现到存储系统架构设计,提供了实战代码和优化策略,帮助开发者快速构建高性价比的物联网数据存储系统。

weixin_30733003的博客 108

MediaCodec视频解码流程详解及参考demo

本文主要讲解mediacodec的视频解码流程,及demo参考例子。

分享音视频技术 7880

从零到一:Quartus II连接开发板实战,打通绘图、管脚分配、编译与下载全链路

本文详细介绍了使用Quartus II软件连接FPGA开发板并完成首个项目的全流程。从硬件连接到驱动安装,到绘制电路框图、精准分配管脚,再到编译设置与最终下载,手把手指导您打通从设计到硬件实现的完整链路,是FPGA初学者的实战入门指南。

mqtt6iot的博客 717

FusionCompute8.0.0实战指南:从零部署CNA与VRM环境

本文以华为FusionCompute 8.0.0为例,详细介绍了如何利用老旧硬件从零开始部署CNA计算节点与VRM管理节点的完整实战指南。内容涵盖实验环境准备、CNA安装与网络配置、VRM虚拟机部署方案对比,并提供了典型故障排查与性能调优技巧,帮助读者低成本构建可用的虚拟化学习环境。

weixin_29306317的博客 315

保姆级教程:用Python+OpenCV搞定Orbbec Gemini深度与彩色流对齐(附完整代码)

本文提供了一份详细的Orbbec Gemini深度与彩色流对齐教程,涵盖从环境配置到完整代码实现的每一步。通过解析深度流对齐原理,对比不同对齐模式,并提供工业级应用中的问题排查方法,帮助开发者快速掌握Orbbec Gemini相机的使用技巧。文章还包含进阶应用如点云生成与三维重建的实战代码。

weixin_29090917的博客 470

三维跨孔电磁波CT数据可视化框架搭建

利用matlab实现对跨孔电磁波CT实测数据反演,并搭建了三维CT数据可视化框架,可装填实测CT反演数据。

Neverlevsun的博客 1170

高通GAIA V3命令参考手册的研读学习(15):自定制命令的详细工作描述

里的示例一样,手机APP发出这个GetManuFacturer的命令发0x0000,那么耳机回复:0x8000, 同时在回复的playload部分,用最多15个字节的ACSII码来表达制造商信息(因此最多15个字母)。那么这个APP在通过GAIA协议控制这个耳机时,不仅可以通过前面讲过的vendor ID来识别,也可以更进一步通过这个命令来识别这个耳机,到底是不是本公司的。通过这个可变长度的playload,真的是可以传达极多的事先约定的信息,相当的灵活,真是不错!这个命令用来得到设备的制造商信息。

qq_37191547的博客 400

android 蓝牙通讯demo

android 下蓝牙通讯demo,实现了发现蓝牙,使能蓝牙,通过蓝牙发送消息。

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

VB摄像头监控

该VB模块可对摄像头捕获的画面进行录像等,可在创建的窗口进行控制

上一篇: Docker容器网络切换实战:从自定义网络回退到默认桥接的完整流程
下一篇: 避坑指南:深度知识追踪(DKT)模型训练中的5个关键参数(PyTorch版)
cloud
博客等级 码龄27年 61粉丝 1276原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值