文本属性及布局

原文：Text properties and layout

译者：飞龙

协议：CC BY-NC-SA 4.0

matplotlib.text.Text实例有各种属性，可以通过关键字参数配置文本命令（例如，title()，xlabel()和text()）。

属性 值类型
alpha 浮点
backgroundcolor 任何 matplotlib 颜色
bbox rectangle prop dict plus key ‘pad’ which is a pad in points
clip_box matplotlib.transform.Bbox 实例
clip_on [True / False]
clip_path Path，Transform或Patch 实例
color 任何 matplotlib 颜色
family [ 'serif' / 'sans-serif' / 'cursive' / 'fantasy' / 'monospace' ]
fontproperties matplotlib.font_manager.FontProperties 实例
horizontalalignment or ha [ 'center' / 'right' / 'left' ]
label 任何字符串
linespacing 浮点
multialignment ['left' / 'right' / 'center' ]
name or fontname 字符串，例如 ['Sans' / 'Courier' / 'Helvetica' ...]
picker [None / 浮点 / 布尔值 / 可调用对象]`
position (x,y)
rotation [ 角度制的角度 / ‘vertical’ / ‘horizontal’
size or fontsize [ 点的尺寸 相对尺寸，例如 ['smaller', 'x-large' ]
style or fontstyle [ 'normal' / 'italic' / 'oblique']
text 字符串或任何可使用'%s'打印的东西
transform matplotlib.transform 实例
variant [ 'normal' / 'small-caps' ]
verticalalignment or va [ 'center' / 'top' / 'bottom' / 'baseline' ]
visible [True / False]
weight or fontweight [ 'normal' / 'bold' / 'heavy' / 'light' / 'ultrabold' / 'ultralight']
x 浮点
y 浮点
zorder 任意数值

你可以使用对齐参数horizontalalignment，verticalalignment和multialignment来布置文本。 horizontalalignment控制文本的x位置参数表示文本边界框的左边，中间或右边。 verticalalignment控制文本的y位置参数表示文本边界框的底部，中心或顶部。 multialignment，仅对于换行符分隔的字符串，控制不同的行是左，中还是右对齐。 这里是一个使用text()命令显示各种对齐方式的例子。 在整个代码中使用transform = ax.transAxes，表示坐标相对于轴边界框给出，其中0,0是轴的左下角，1,1是右上角。

  1. import matplotlib.pyplot as plt
  2. import matplotlib.patches as patches
  4. # build a rectangle in axes coords
  5. left, width = .25, .5
  6. bottom, height = .25, .5
  7. right = left + width
  8. top = bottom + height
  10. fig = plt.figure()
  11. ax = fig.add_axes([0,0,1,1])
  13. # axes coordinates are 0,0 is bottom left and 1,1 is upper right
  14. p = patches.Rectangle(
  15.     (left, bottom), width, height,
  16.     fill=False, transform=ax.transAxes, clip_on=False
  17.     )
  19. ax.add_patch(p)
  21. ax.text(left, bottom, 'left top',
  22.         horizontalalignment='left',
  23.         verticalalignment='top',
  24.         transform=ax.transAxes)
  26. ax.text(left, bottom, 'left bottom',
  27.         horizontalalignment='left',
  28.         verticalalignment='bottom',
  29.         transform=ax.transAxes)
  31. ax.text(right, top, 'right bottom',
  32.         horizontalalignment='right',
  33.         verticalalignment='bottom',
  34.         transform=ax.transAxes)
  36. ax.text(right, top, 'right top',
  37.         horizontalalignment='right',
  38.         verticalalignment='top',
  39.         transform=ax.transAxes)
  41. ax.text(right, bottom, 'center top',
  42.         horizontalalignment='center',
  43.         verticalalignment='top',
  44.         transform=ax.transAxes)
  46. ax.text(left, 0.5*(bottom+top), 'right center',
  47.         horizontalalignment='right',
  48.         verticalalignment='center',
  49.         rotation='vertical',
  50.         transform=ax.transAxes)
  52. ax.text(left, 0.5*(bottom+top), 'left center',
  53.         horizontalalignment='left',
  54.         verticalalignment='center',
  55.         rotation='vertical',
  56.         transform=ax.transAxes)
  58. ax.text(0.5*(left+right), 0.5*(bottom+top), 'middle',
  59.         horizontalalignment='center',
  60.         verticalalignment='center',
  61.         fontsize=20, color='red',
  62.         transform=ax.transAxes)
  64. ax.text(right, 0.5*(bottom+top), 'centered',
  65.         horizontalalignment='center',
  66.         verticalalignment='center',
  67.         rotation='vertical',
  68.         transform=ax.transAxes)
  70. ax.text(left, top, 'rotated\nwith newlines',
  71.         horizontalalignment='center',
  72.         verticalalignment='center',
  73.         rotation=45,
  74.         transform=ax.transAxes)
  76. ax.set_axis_off()
  77. plt.show()

文本属性及布局 - 图1