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