如何为pandas Style对象同时添加顶部和底部双标题

问题原因 #

HTML规范要求单个<table>标签只能存在一个<caption>子元素，所以你调用set_caption()时新传入的内容会直接覆盖旧内容，天然不支持直接通过多次调用该方法同时设置顶部标题和底部注释。

解决方案 #

这里提供两种实现路径：

方案一：在单个caption内插入多段内容（代码最简） #

直接在caption内容里嵌入两个带自定义类的文本块，分别给两类设置样式实现上下分离的效果：

import pandas as pd

# 示例DataFrame，替换为你自己的df即可
df = pd.DataFrame({'列1': [1,2,3], '列2': [4,5,6]})

styler = df.style
# caption内插入两段内容，分别对应顶部标题和底部注释
styler = styler.set_caption('''
<p class="top-title">表格顶部标题</p>
<p class="bottom-note">表格底部注释内容</p>
''')
# 分别配置各元素样式
styler = styler.set_table_styles([
    {
        'selector': 'caption',
        'props': 'line-height: 1.5; width: 100%;'
    },
    {
        'selector': '.top-title',
        'props': 'font-size: 1.25em; text-align: center; margin: 0 0 10px 0; font-weight: bold;'
    },
    {
        'selector': '.bottom-note',
        'props': 'font-size: 1.25em; text-align: left; margin: 10px 0 0 0;'
    }
], overwrite=False)

方案二：用表尾（tfoot）实现底部注释（兼容性最好） #

如果需要严格区分标题和注释的DOM结构，避免和caption原生逻辑冲突，可以用caption做顶部标题，底部注释通过新增跨列表尾行实现：

df = pd.DataFrame({'列1': [1,2,3], '列2': [4,5,6]})
col_num = len(df.columns)

styler = df.style
# 配置顶部标题
styler = styler.set_caption("表格顶部标题").set_table_styles([{
    'selector': 'caption',
    'props': 'caption-side: top; font-size:1.25em; font-weight: bold; margin-bottom: 8px;'
}], overwrite=False)

# 拼接底部注释行到表尾
styler = styler.concat(
    pd.DataFrame([["表格底部注释内容"] + [""]*(col_num-1)], columns=df.columns),
    axis=0
).set_table_styles([
    # 表尾注释行样式
    {
        'selector': f'row{len(df)} td',
        'props': 'border: none; text-align: left; padding-top: 8px; font-size: 1.25em;'
    }
], overwrite=False)

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