Pandas：多索引列的特定样式设置（含提示框）

通用优化：简化多索引列创建 #

你当前通过hide删除冗余列的方式可以优化，直接在创建多索引时生成符合业务逻辑的列组合，避免手动维护大量隐藏规则：

# 直接生成有效列组合：区域+周期+时间维度
columns = []
for region in ['North America', 'Europe', 'Asia']:
    # Weekly维度：WK-01至WK-05 + WoW
    columns.extend([(region, 'Weekly', wk) for wk in ['WK-01', 'WK-02', 'WK-03', 'WK-04', 'WK-05', 'WoW']])
    # Monthly维度：Jan/Feb/Mar + MoM
    columns.extend([(region, 'Monthly', mon) for mon in ['Jan', 'Feb', 'Mar', 'MoM']])

df = pd.DataFrame(
    index=['KPI ABC', 'KPI DEF', 'KPI GHI', 'KPI JKL'],
    columns=pd.MultiIndex.from_tuples(columns)
)

1. 多索引列特定层级的文本样式设置 #

针对最上层的区域名称（North America/Europe/Asia），可以利用Pandas自动给表头层级添加的CSS类精准定位：

# 给level0层级列标题设置大号字体
s.set_table_styles([
    {
        'selector': 'th.col_heading.level0',
        'props': 'font-size: 1.2em; font-weight: bold;'
    }
], overwrite=False)

原理：Pandas会为多索引表头的每一层自动添加level0/level1/level2类，直接通过类选择器就能只修改目标层级，不会影响其他表头。

2. 为个别单元格添加提示框 #

不需要创建全量提示DataFrame，两种简洁方案可选：

方案1：基于空DataFrame的精准赋值

# 初始化与原表结构一致的空提示框DataFrame
tooltip_df = pd.DataFrame('', index=df.index, columns=df.columns)
# 给指定单元格设置提示内容
tooltip_df.loc['KPI JKL', ('Europe', 'Monthly', 'Feb')] = 'Europe月度Feb的JKPI数据：当月核心业务完成率'
tooltip_df.loc['KPI GHI', ('Asia', 'Weekly', 'WK-04')] = 'Asia每周WK-04的GPI数据：周度用户活跃度峰值'
# 应用提示框（可自定义样式）
s.set_tooltips(
    tooltip_df,
    props='visibility: hidden; position: absolute; background: #333; color: #fff; padding: 6px; border-radius: 4px; z-index: 10;'
)

方案2：直接给目标单元格添加HTML title属性

def add_cell_tooltip(val, row, col):
    # 定义需要提示的单元格及对应内容
    target_map = {
        ('KPI JKL', ('Europe', 'Monthly', 'Feb')): 'Europe月度Feb的JKPI数据：当月核心业务完成率',
        ('KPI GHI', ('Asia', 'Weekly', 'WK-04')): 'Asia每周WK-04的GPI数据：周度用户活跃度峰值'
    }
    if (row, col) in target_map:
        return f'<span title="{target_map[(row, col)]}">{val}</span>'
    return val

# 应用到所有单元格，仅目标单元格生效
s.format(add_cell_tooltip, subset=pd.IndexSlice[:, :])

3. 为索引中的KPI名称添加提示框 #

官方未直接支持索引提示框，但可以通过两种方式实现：

方案1：通过表格样式添加title属性

# 定义KPI对应的提示内容
kpi_tip_map = {
    'KPI ABC': 'ABC指标：衡量核心业务营收达成率',
    'KPI DEF': 'DEF指标：跟踪内部流程周转效率',
    'KPI GHI': 'GHI指标：反映用户模块活跃程度',
    'KPI JKL': 'JKL指标：监控系统稳定性与故障率'
}

# 为每个KPI索引行添加提示框
for kpi, tip in kpi_tip_map.items():
    s.set_table_styles({
        kpi: [
            {'selector': 'th.row_heading', 'props': f'title: "{tip}";'}
        ]
    }, overwrite=False, axis=0)

方案2：嵌入JavaScript实现更灵活的提示

如果需要自定义提示框样式（比如悬浮显示），可以在导出HTML时嵌入脚本：

# 生成Styler的HTML内容
html_content = s.render()

# 添加JavaScript动态设置索引提示框
js_script = """
<script>
document.addEventListener('DOMContentLoaded', function() {
    const kpiTips = {
        'KPI ABC': 'ABC指标：衡量核心业务营收达成率',
        'KPI DEF': 'DEF指标：跟踪内部流程周转效率',
        'KPI GHI': 'GHI指标：反映用户模块活跃程度',
        'KPI JKL': 'JKL指标：监控系统稳定性与故障率'
    };
    document.querySelectorAll('th.row_heading').forEach(th => {
        const kpiName = th.textContent.trim();
        if (kpiName in kpiTips) {
            th.setAttribute('title', kpiTips[kpiName]);
        }
    });
});
</script>
"""

# 合并HTML与脚本并保存
final_html = html_content + js_script
with open('kpi_report_with_tooltips.html', 'w') as f:
    f.write(final_html)

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