ECharts 环形图大小如何设置?详解 radius 属性与百分比适配技巧

在 ECharts 中,环形图(也称为饼图的环形变体)是一种常见的数据可视化形式,常用于展示比例数据,如市场份额、预算分配或调查结果。设置环形图的大小是创建美观、响应式图表的关键步骤。ECharts 通过
series
中的
radius
属性来控制环形图的内半径和外半径,从而决定图表的整体大小和形状。本文将详细解释
radius
属性的用法、如何使用百分比进行适配,以及在实际项目中的技巧和最佳实践。我们将结合代码示例,帮助你一步步掌握这些设置,确保图表在不同设备上都能完美显示。
1. 理解 ECharts 环形图的基本结构
ECharts 环形图是基于饼图(Pie Chart)构建的,通过设置
series
类型为
‘pie’
并调整
radius
属性来实现环形效果。环形图的核心是“空心”设计,这使得它比实心饼图更现代,适合与其他元素(如标签或图例)结合使用。
基本配置概述
series 类型
:必须是
‘pie’
。
radius 属性
:这是一个数组,格式为
[内半径, 外半径]
,用于定义环形的宽度和位置。
数据格式
:
series.data
是一个对象数组,每个对象包含
name
(名称)和
value
(数值)。
一个简单的环形图示例代码如下(假设你已经在 HTML 中引入了 ECharts 库):
// 基于 HTML 的完整示例




ECharts 环形图示例







在这个示例中,
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 部分。