在 ECharts 中,环形图(也称为饼图的环形变体)是一种常见的数据可视化形式,常用于展示比例数据,如市场份额、预算分配或调查结果。设置环形图的大小是创建美观、响应式图表的关键步骤。ECharts 通过
series
中的
radius
属性来控制环形图的内半径和外半径,从而决定图表的整体大小和形状。本文将详细解释
radius
属性的用法、如何使用百分比进行适配,以及在实际项目中的技巧和最佳实践。我们将结合代码示例,帮助你一步步掌握这些设置,确保图表在不同设备上都能完美显示。
1. 理解 ECharts 环形图的基本结构
ECharts 环形图是基于饼图(Pie Chart)构建的,通过设置
series
类型为
‘pie’
并调整
radius
属性来实现环形效果。环形图的核心是“空心”设计,这使得它比实心饼图更现代,适合与其他元素(如标签或图例)结合使用。
基本配置概述
series 类型
:必须是
‘pie’
。
radius 属性
:这是一个数组,格式为
[内半径, 外半径]
,用于定义环形的宽度和位置。
数据格式
:
series.data
是一个对象数组,每个对象包含
name
(名称)和
value
(数值)。
一个简单的环形图示例代码如下(假设你已经在 HTML 中引入了 ECharts 库):
// 基于 HTML 的完整示例
在这个示例中,
radius: [‘40%’, ‘70%’]
创建了一个内半径为 40%、外半径为 70% 的环形图。这意味着环形的宽度是 30%(70% – 40%),并且相对于容器的最小尺寸(宽度或高度)进行缩放。如果你将容器的
width
改为
100%
,图表会自动响应容器大小变化。
为什么使用环形图?
环形图适合展示 3-6 个类别的比例数据,避免饼图的拥挤感。它允许在中心放置额外信息,如总计值或自定义文本,这在仪表盘中非常实用。
2. radius 属性详解
radius
属性是控制环形图大小的核心,它支持两种类型的值:
像素值
(固定大小)和
百分比
(相对大小)。理解其工作原理,能帮助你精确控制图表的视觉效果。
2.1 radius 的数据类型和格式
数组格式
:
[innerRadius, outerRadius]
innerRadius
:内半径,决定环形的“空心”大小。如果为 0,则是实心饼图。
outerRadius
:外半径,决定环形的整体大小。
值的类型
:
字符串百分比
:如
‘40%’
,相对于容器的最小尺寸(min(width, height))的百分比。例如,如果容器是 600px 宽、400px 高,则 min=400px,
‘40%’
对应 160px。
数字像素
:如
100
,表示固定像素值,不受容器大小影响。
混合使用
:可以混用,如
[‘40%’, 200]
,内半径百分比,外半径固定像素。
2.2 百分比 vs 像素:优缺点比较
百分比
(推荐用于响应式设计):
优点:自动适配容器大小,适合 Web 应用和移动端。
缺点:在极端容器比例下(如非常宽或高),可能变形。
像素
(固定大小):
优点:精确控制,适合打印或固定布局。
缺点:不响应式,需要手动调整。
示例:不同 radius 设置的对比
假设容器大小为 500px x 500px,我们来比较几种设置:
实心饼图
:
radius: ‘70%’
(单值,相当于
[‘0%’, ‘70%’]
)
效果:整个圆填充 70% 的空间。
标准环形
:
radius: [‘30%’, ‘70%’]
内半径:150px (30% of 500px)
外半径:350px (70% of 500px)
环宽:200px
细环形
:
radius: [‘60%’, ‘70%’]
内半径:300px
外半径:350px
环宽:50px(适合标签密集的场景)
固定像素
:
radius: [100, 200]
无论容器大小,内半径始终 100px,外半径 200px。
代码示例:在同一页面中创建多个图表对比。
// 假设我们有三个容器:chart1, chart2, chart3
var charts = [
echarts.init(document.getElementById(‘chart1’)),
echarts.init(document.getElementById(‘chart2’)),
echarts.init(document.getElementById(‘chart3’))
];
var baseOption = {
series: [{
type: ‘pie’,
data: [{value: 100, name: ‘A’}, {value: 200, name: ‘B’}]
}]
};
// 图表1:实心
charts[0].setOption({
…baseOption,
series: [{…baseOption.series[0], radius: ‘70%’}]
});
// 图表2:标准环形
charts[1].setOption({
…baseOption,
series: [{…baseOption.series[0], radius: [‘30%’, ‘70%’]}]
});
// 图表3:细环形
charts[2].setOption({
…baseOption,
series: [{…baseOption.series[0], radius: [‘60%’, ‘70%’]}]
});
通过调整这些值,你可以观察到环形图的大小变化。在实际开发中,使用浏览器开发者工具(F12)实时修改 radius 值来调试是最有效的方法。
3. 百分比适配技巧:实现响应式环形图
在现代 Web 开发中,环形图需要在不同屏幕尺寸下保持美观。使用百分比是基础,但还需结合 ECharts 的响应式 API 和 CSS 技巧来优化。
3.1 基于容器大小的自动适配
ECharts 的
radius
百分比默认基于容器的
min(width, height)
。这意味着:
如果容器是正方形,环形图会完美居中。
如果容器是长方形(如 800×400),环形图会以 400px 为基准,避免超出。
技巧 1:使用 resize() 方法
当窗口大小变化时,调用
myChart.resize()
来重新计算半径。
// 监听窗口变化
window.addEventListener(‘resize’, function() {
myChart.resize();
});
技巧 2:结合 CSS 百分比容器
将图表容器设置为百分比宽度,确保 radius 百分比与之匹配。
#main {
width: 100%; /* 容器宽度自适应 */
height: 400px; /* 固定高度,或使用百分比如 50vh */
max-width: 800px; /* 限制最大尺寸,避免过大 */
}
3.2 高级适配:媒体查询与动态 radius
对于移动端和桌面端的差异,使用 CSS 媒体查询调整容器大小,或在 JS 中动态计算 radius。
示例:根据屏幕宽度动态设置 radius
function getDynamicRadius() {
const width = window.innerWidth;
if (width < 768) { // 移动端
return ['30%', '60%']; // 较小环形,节省空间
} else { // 桌面端
return ['40%', '70%']; // 标准环形
}
}
// 初始化时使用
var option = {
series: [{
type: 'pie',
radius: getDynamicRadius(),
data: [...] // 你的数据
}]
};
// 窗口变化时更新
window.addEventListener('resize', function() {
myChart.setOption({
series: [{ radius: getDynamicRadius() }]
});
myChart.resize();
});
技巧 3:处理中心内容适配
如果环形中心需要显示文本(如总计),使用
graphic
组件动态调整位置:
option = {
series: [{
radius: ['40%', '70%'],
// ... 其他配置
}],
graphic: [{
type: 'text',
left: 'center',
top: 'center',
style: {
text: '总计: 3000',
textAlign: 'center',
fill: '#333',
fontSize: window.innerWidth < 768 ? 14 : 20 // 动态字体大小
}
}]
};
3.3 常见问题与解决方案
问题 1:环形图在窄屏下变形
。
解决:使用
min
函数确保 radius 不超过 100%,如
radius: ['30%', Math.min(70, (containerWidth / minSize) * 100) + '%']
。
问题 2:标签溢出
。
解决:结合
label
的
overflow
和
radius
调整。示例:
label: { overflow: 'truncate', width: 100 }
。
问题 3:多系列环形嵌套
。
ECharts 支持多个 pie series 嵌套。通过不同 radius 实现:
series: [
{ type: 'pie', radius: ['0%', '30%'], data: [...] }, // 内环
{ type: 'pie', radius: ['35%', '70%'], data: [...] } // 外环
]
4. 最佳实践与完整项目示例
4.1 最佳实践总结
始终优先使用百分比
:确保图表在响应式布局中自适应。
测试多种容器大小
:在 Chrome DevTools 中模拟不同设备。
结合其他属性
:如
center
(中心位置,默认 [‘50%’, ‘50%’])来微调布局。
性能优化
:对于大数据集,使用
avoidLabelOverlap: true
避免标签重叠。
可访问性
:添加
tooltip
和
legend
,确保颜色对比度高。
4.2 完整项目示例:响应式仪表盘
假设我们构建一个销售仪表盘,包含环形图显示产品类别比例。容器使用 Flexbox 布局,确保自适应。
HTML 结构
:
CSS
:
.dashboard {
display: flex;
gap: 20px;
padding: 20px;
}
#pieChart {
background: #f9f9f9;
border-radius: 8px;
}
@media (max-width: 768px) {
.dashboard {
flex-direction: column;
}
#pieChart {
height: 300px; /* 移动端减小高度 */
}
}
JavaScript
(完整 ECharts 配置):
var chartDom = document.getElementById(‘pieChart’);
var myChart = echarts.init(chartDom);
// 动态数据(可从 API 获取)
var salesData = [
{ value: 335, name: ‘直接访问’ },
{ value: 310, name: ‘邮件营销’ },
{ value: 234, name: ‘联盟广告’ },
{ value: 135, name: ‘视频广告’ },
{ value: 1548, name: ‘搜索引擎’ }
];
function getOption() {
const isMobile = window.innerWidth < 768;
return {
title: {
text: '销售来源分布',
left: 'center',
textStyle: { fontSize: isMobile ? 16 : 20 }
},
tooltip: {
trigger: 'item',
formatter: '{b}: {c} ({d}%)'
},
legend: {
orient: 'vertical',
left: 'left',
textStyle: { fontSize: isMobile ? 12 : 14 }
},
series: [
{
name: '销售来源',
type: 'pie',
radius: isMobile ? ['35%', '65%'] : ['40%', '70%'], // 动态 radius
center: ['50%', '50%'],
data: salesData,
emphasis: {
itemStyle: {
shadowBlur: 10,
shadowOffsetX: 0,
shadowColor: 'rgba(0, 0, 0, 0.5)'
}
},
label: {
show: !isMobile, // 移动端隐藏标签,避免拥挤
formatter: '{b}\n{d}%'
},
labelLine: {
show: !isMobile
}
}
]
};
}
// 初始化
myChart.setOption(getOption());
// 响应式更新
window.addEventListener('resize', function() {
myChart.setOption(getOption()); // 更新 radius 和字体
myChart.resize();
});
这个示例展示了如何结合
radius
百分比、动态计算和媒体查询,实现一个在桌面端显示 40%-70% 环形、在移动端调整为 35%-65% 的图表。你可以直接复制到 HTML 文件中运行,观察效果。
通过这些技巧,你可以轻松设置 ECharts 环形图的大小,并确保其在各种场景下完美适配。如果需要更复杂的自定义(如动画或交互),可以进一步探索 ECharts 官方文档的
series-pie
部分。