Altair绘图：标题与坐标轴自定义配置问题咨询

问题关联原始代码 #

chart = Chart(data).mark_bar().encode(
    column='Cell Type',
    x='Truth/Pred',
    y='03',
    color='Truth/Pred',
).properties(
    title='Truth vs Predictions for Cell Type Percentages'
).configure_axisBottom(
    disable = True
).configure_axisTop(
    # labelPadding = 100
    orientation = "bottom"
).configure_axisY(
    title = "Cell Type Percentages"
)

chart.display()

各问题原因与修复方案 #

• 图表标题居中 #

Altair 默认标题为左对齐，居中需要通过configure_title或在properties中传入TitleParams对象设置anchor='middle'，仅传入标题文本不会触发居中效果。分面场景下该配置会自动对齐整个分面画布的水平中心。

• Y轴标题不显示 #

问题由配置优先级和分面默认规则共同导致：

1. 使用column/row分面时，全局configure_axis*配置优先级低于分面共享轴的默认规则，在configure_axisY中设置的title会被覆盖。
2. 未显式指定Y轴编码的标题时，Altair会默认读取字段名（即代码中的03）作为轴标题，不会读取全局配置中的title参数。
   修复方式：直接在encode的Y字段定义中显式绑定轴标题，不要依赖全局configure_axisY传title，写法为y=alt.Y('03', title='Cell Type Percentages')。

• 顶部Cell Type标签配置无效 #

核心原因是配置对象选错：column='Cell Type'生成的顶部标签属于分面列头（Header）组件，不属于顶部坐标轴（axisTop），因此调用configure_axisTop修改方向、间距的操作完全不会生效。
调整分面列头的位置、标签角度、间距，需要在定义column字段时传入header配置：

• 列头移至分面底部：设置orient='bottom'
• 调整标签旋转角度：设置labelAngle参数
• 调整标签与图表间距：设置labelPadding参数
  示例写法：column=alt.Column('Cell Type', header=alt.Header(orient='bottom', labelPadding=10, labelAngle=0))

• 旧示例代码报additional properties are not allowed错误 #

该报错由版本迭代导致：网上流传的旧版分组柱状图代码多基于Altair 2.x/3.x编写，从Altair 4.x到当前5.x版本，大量旧顶层配置属性被移除，要求所有配置必须归属到对应配置类（轴配置传入alt.Axis、分面头配置传入alt.Header、标题配置传入alt.TitleParams），旧代码中直接写在Chart构造函数、mark方法、encode方法中的零散配置项会被判定为非法属性。
编写新版Altair图表时，所有组件配置显式调用对应配置类即可避免该报错，不要照搬发布时间超过3年的旧示例。

修正后可运行代码 #

import altair as alt
from altair import Chart

chart = Chart(data).mark_bar().encode(
    # 分面列配置，列头移至底部，调整标签样式
    column=alt.Column(
        'Cell Type:N',
        header=alt.Header(
            orient='bottom',
            labelPadding=15,
            labelAngle=0
        )
    ),
    # 禁用底部冗余坐标轴
    x=alt.X('Truth/Pred:N', axis=alt.Axis(disable=True)),
    # 显式指定Y轴标题与类型，确保配置生效
    y=alt.Y('03:Q', title='Cell Type Percentages'),
    color='Truth/Pred:N',
).properties(
    title=alt.TitleParams(
        text='Truth vs Predictions for Cell Type Percentages',
        anchor='middle' # 标题水平居中
    ),
    width=120 # 按需调整单个分面宽度，避免标签挤压
).configure_facet(
    spacing=10 # 调整分面之间的间距
)

chart.display()

代码中字段后附带的:N（名义分类类型）、:Q（数值类型）为Altair推荐的显式类型标记，可避免自动类型推断导致的渲染异常。

内容的提问来源于stack exchange，提问作者p_mo