如何在Altair中实现多行文本表格的合理行间距？

针对你遇到的多行文本重叠或行间距过大的问题，可以通过两种方式精准控制行间距，取决于你是要自动换行还是手动拆分文本为多行：

方案1：长文本自动换行（推荐） #

如果只是需要让长文本自动换行显示，无需手动拆分单词，直接通过以下设置实现合适的行间距：

import altair as alt
import pandas as pd

text_df = pd.DataFrame({"a": ["very very very very long thing", "very very very very very long thing"]})

# 给每行添加行号
text_df["row_number"] = text_df.index + 1

alt.Chart(text_df, height=120).mark_text(
    align="left",
    baseline="top",
    lineHeight=1.6,  # 控制单条文本内的行间距，值越大间距越宽，推荐1.2-2.0
    width=180        # 设置宽度触发自动换行
).encode(
    y=alt.Y(
        "row_number:Q", 
        axis=None,
        scale=alt.Scale(range=[30, 90])  # 手动设置y轴范围，控制不同条目间的垂直距离
    ),
    text="a:N"
)

关键参数说明： #

• lineHeight：控制单条文本内多行之间的行间距，按需调整数值即可
• width：必须设置，让Altair明确换行触发条件
• scale=alt.Scale(range=[...])：通过连续型y轴的范围，精准调整不同条目之间的垂直间距，避免行间距过大

方案2：手动拆分文本为多行（按空格拆分单词） #

如果需要将文本按特定规则（比如空格）拆分为独立行显示，通过计算行偏移量来控制行间距：

import altair as alt
import pandas as pd

text_df = pd.DataFrame({"a": ["very very very very long thing", "very very very very very long thing"]})

text_chart_base = alt.Chart(text_df).transform_window(
    row_number="row_number()"  # 生成原始行号
).transform_calculate(
    lines="split(datum.a, ' ')"  # 按空格拆分文本为数组
).transform_flatten(
    field="lines"  # 将数组展开为单独行，每个单词对应一行
).transform_calculate(
    # 计算每个拆分后文本在原始行内的索引
    line_index="indexof(split(datum.a, ' '), datum.lines)",
    # 计算最终y位置：原始行号 + 行内索引 * 间距系数（0.2可调整，值越大间距越宽）
    y_pos="datum.row_number + datum.line_index * 0.2"
).mark_text(
    align="left",
    baseline="middle"
).encode(
    y=alt.Y("y_pos:Q", axis=None, scale=alt.Scale(reverse=True)),
    text="lines:N"
)

col1 = text_chart_base.encode(text="lines:N")
col2 = text_chart_base.encode(text="row_number:N")
col1 | col2

关键逻辑说明： #

• transform_flatten：把拆分后的文本数组展开成单独行，让每个单词成为独立的文本标记
• y_pos计算：通过原始行号加上行内索引乘以间距系数，控制同一原始行内各单词的垂直位置，实现精细的行间距调整
• 连续型y_pos:Q：确保y轴为连续刻度，支持灵活的间距设置

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