如何在Altair中为含图层与分面的图表设置跨分面的单个X轴标题？

嘿，我完全懂你想要给分面图表加一个横跨所有分面的统一X轴标题的需求～确实Altair本身没有原生提供这个功能，但我们可以用一些小技巧来实现效果！

先看你当前代码生成的效果，每个分面都重复显示了X轴长标题，这显然不是你想要的：

原代码的图表效果：

下面是两种实用的解决思路：

思路一：垂直拼接图表+全局标题 #

我们可以把分面后的图表和一个单独的标题文本图表垂直拼在一起，模拟出全局X轴标题的效果，这是最稳妥的方法：

import altair as alt
import pandas as pd
import textwrap

df = pd.DataFrame({
    'y': [10, 20, 30 , 40] ,
    'x': ['a', 'b', 'a', 'b'] ,
    'facet' : ['case 1', 'case 1', 'case 2', 'case 2'] 
})

x         = 'x'
y         = 'y'
facet     = 'facet'
# 全局跨分面X轴标题，用textwrap实现自动换行
global_x_title = textwrap.fill("A long long long long long long long long long long long long title", 30)

base = alt.Chart(df)
bar = base.mark_bar().encode(
    x=alt.X(x).axis(labelAngle=0).title(""),  # 隐藏单个分面的X轴标题，避免重复
    y=alt.Y(y)
)
txt = base.mark_text(dy=-5).encode(
    x=alt.X(x),
    y=alt.Y(y),
    text=alt.Y(y)
)

# 生成分面图表
faceted_chart = alt.layer(bar, txt).properties(width=300, height=250).facet(
    facet=alt.Facet(facet), columns=2
)

# 把全局标题做成独立的小图表
title_chart = alt.Chart(pd.DataFrame({'title': [global_x_title]})).mark_text(
    fontSize=14, lineBreak='\n'  # 支持换行显示长文本
).encode(
    text='title:N'
).properties(height=50)  # 控制标题区域的高度

# 垂直拼接分面图表和标题，消除间距让布局更自然
final_chart = alt.vconcat(faceted_chart, title_chart).configure_concat(spacing=0)
final_chart

这个方法不需要手动调整坐标，布局会自动适配图表尺寸，标题的样式也能灵活调整。

思路二：直接添加全局文本注释 #

如果不想拼接图表，也可以在分面图表的底部直接添加一个文本标记作为全局标题，适合需要精确控制位置的场景：

import altair as alt
import pandas as pd
import textwrap

df = pd.DataFrame({
    'y': [10, 20, 30 , 40] ,
    'x': ['a', 'b', 'a', 'b'] ,
    'facet' : ['case 1', 'case 1', 'case 2', 'case 2'] 
})

x         = 'x'
y         = 'y'
facet     = 'facet'
global_x_title = textwrap.fill("A long long long long long long long long long long long long title", 30)

base = alt.Chart(df)
bar = base.mark_bar().encode(
    x=alt.X(x).axis(labelAngle=0).title(""),
    y=alt.Y(y)
)
txt = base.mark_text(dy=-5).encode(
    x=alt.X(x),
    y=alt.Y(y),
    text=alt.Y(y)
)

# 生成分面图表
faceted_chart = alt.layer(bar, txt).properties(width=300, height=250).facet(
    facet=alt.Facet(facet), columns=2
)

# 添加全局标题文本，手动调整坐标让它居中显示
final_chart = faceted_chart + alt.Chart(pd.DataFrame({'text': [global_x_title]})).mark_text(
    x=300,  # 对应分面图表的宽度中心
    y=290,  # 放在图表下方的合适位置
    fontSize=14,
    lineBreak='\n'
).encode(
    text='text:N'
)
final_chart

这种方式需要根据图表的实际尺寸微调坐标值，适合对布局细节要求高的情况。

另外，如果你原代码里的长文本是想给X轴刻度做换行优化，也可以用textwrap.fill自动处理：

x_labels = [textwrap.fill(label, 15) for label in ["A long long long long long long", "long long long long long long title"]]
# 在X轴编码里设置换行后的刻度标签
x=alt.X(x).axis(labelAngle=0, labels=x_labels).title("")

这样刻度标签会自动换行，不会拥挤在一起。

备注：内容来源于stack exchange，提问作者Diogo