matplotlib.pyplot.bar_label#
- matplotlib.pyplot.bar_label(container, labels=None, *, fmt='%g', label_type='edge', padding=0, **kwargs)[源代码]#
为条形图添加标签。
为给定
BarContainer
中的条形添加标签。您可能需要调整坐标轴限制以适应标签。- 参数:
- container
BarContainer
- labels类数组, 可选
要显示的标签文本列表。如果未给出,标签文本将是使用fmt格式化的数据值。
- fmtstr 或 callable,默认值: '%g'
用于标签的无名 % 样式或 {} 样式格式字符串,或将值作为第一个参数调用的函数。当 fmt 是字符串且可以同时被两种格式解释时,% 样式优先于 {} 样式。
3.7 版本新增:支持 {} 样式格式字符串和可调用对象。
- label_type{'edge', 'center'},默认值: 'edge'
标签类型。可能的值:
'edge'(边缘):标签放置在条形段的末端,显示的值将是该末端的位置。
'center'(中心):标签放置在条形段的中心,显示的值将是该段的长度。(适用于堆叠条形图,例如带标签的条形图)
- paddingfloat,默认值: 0
标签距条形末端的距离,以点为单位。
- **kwargs
所有剩余的关键字参数都将传递给
Axes.annotate
。对齐参数(horizontalalignment / ha, verticalalignment / va)不受支持,因为标签会自动对齐到条形图。
- container
- 返回:
- 列表中的
Annotation
标签的
Annotation
实例列表。
- 列表中的
备注
注意