PhpSpreadsheet 如何设置柱状图不同数据系列的条形间隙
实现同类别条形间隙的设置方法
你要实现的「同类别下两个数据系列的相邻条形间隙」,对应Excel中的「系列重叠」配置,可直接通过PhpSpreadsheet的DataSeries类提供的setOverlap()方法完成设置。
参数说明
setOverlap()的取值范围为-100 ~ 100,以单条条形的宽度为百分比单位:
- 取值为
0时,同分类下的条形完全贴合无间隙(默认值) - 取值为负数时,条形之间会生成对应比例的间隙,例如
-30表示间隙为单条条形宽度的30% - 取值为正数时,条形会互相重叠,数值越大重叠程度越高
如果需要调整不同分类组(例如Q1组和Q2组整体之间)的间隙,可使用setGapWidth()方法,取值范围为0 ~ 500,同样以单条条形宽度为百分比单位,默认值通常为150。
代码修改位置
在你现有代码中,找到$series->setPlotDirection(DataSeries::DIRECTION_COL);这一行,在其后追加对应设置即可:
// 设置同分类下系列重叠为-30,即两个相邻条形之间留30%宽度的间隙 $series->setOverlap(-30); // 可选:如需调整分类组之间的间隙,可添加该行设置,示例为默认的150%宽度间隔 // $series->setGapWidth(150);
注意事项
setOverlap()仅对标准分组柱状图生效,堆积、百分比堆积等其他分组模式下,系列间隙由分组逻辑自动控制,无需手动配置。
内容的提问来源于stack exchange,提问作者Feroz
相关产品推荐
相关产品推荐

