Altair：如何移除分层分面图表的分面标题？

问题场景 #

尝试先创建分层图表再调用.facet(column)实现分面，想要移除分面标题时，使用.facet(column, title=None)触发SchemaValidationError，提示'data'是必填属性。

错误代码及信息 #

代码：

import altair as alt
from vega_datasets import data
cars = data.cars()

horse = alt.Chart().mark_point().encode(
    x = 'Weight_in_lbs',
    y = 'Horsepower'
)

miles = alt.Chart().mark_point(color='red').encode(
    x = 'Weight_in_lbs',
    y = 'Miles_per_Gallon'
)

alt.layer(horse, miles, data=cars).facet(column='Origin', title=None)

错误信息：

SchemaValidationError: Invalid specification

        altair.vegalite.v4.api.Chart, validating 'required'

        'data' is a required property
        

alt.FacetChart(...)

解决方案 #

不要在.facet()方法中直接传入title参数，而是通过.configure_header()方法来隐藏分面标题。

修改后的代码

import altair as alt
from vega_datasets import data
cars = data.cars()

horse = alt.Chart().mark_point().encode(
    x='Weight_in_lbs',
    y='Horsepower'
)

miles = alt.Chart().mark_point(color='red').encode(
    x='Weight_in_lbs',
    y='Miles_per_Gallon'
)

# 通过configure_header隐藏所有分面标题
alt.layer(horse, miles, data=cars).facet(column='Origin').configure_header(title=None)

如果需要仅隐藏列方向的分面标题，可更精细配置：

# 仅隐藏列分面的标题
alt.layer(horse, miles, data=cars).facet(column='Origin').configure_header(column=alt.Header(title=None))

原因说明 #

在.facet()中传入title=None会导致Altair错误解析参数结构：.facet()的第二个参数实际接收的是分面配置对象，而非直接的标题值，这种写法不符合Vega-Lite的Schema规范，因此触发必填属性缺失的验证错误。而.configure_header()是专门用于配置分面头部元素的方法，能正确修改或隐藏标题。

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