Plotly go.Box箱线图x轴0/1刻度替换与悬停显示问题求解

开展NBA相关数据可视化项目时，使用Plotly构建1行5列的多子图统计图表，对比两类球员的5项核心场均数据，初始实现代码如下：

fig = make_subplots(
    rows = 1, cols = 5,
    )

fig.add_trace(
    go.Box(x=per_game_player['HOF'], y=per_game_player['trb'], name ='Rebounds'),
    row = 1, col = 1
)

fig.add_trace(
    go.Box(x=per_game_player['HOF'], y=per_game_player['ast'], name = 'Assists'),
    row = 1, col = 2
)

fig.add_trace(
    go.Box(x=per_game_player['HOF'], y=per_game_player['stl'], name = 'Steals'),
    row = 1, col = 3
)

fig.add_trace(
    go.Box(x=per_game_player['HOF'], y=per_game_player['blk'], name = 'Blocks'),
    row = 1, col = 4
)

fig.add_trace(
    go.Box(x=per_game_player['HOF'], y=per_game_player['pts'], name = 'Points'),
    row = 1, col = 5,
    
)

hovertemp = '<b>%{customdata}: </b> %{y} <br>'


fig.update_traces(
                  showlegend=False,
                  customdata = per_game_player['player'],
                  hovertemplate = hovertemp,
)

fig.update_layout(title_text = 'top stats')
fig.show();

使用的per_game_player数据集中，HOF字段为0/1二值，分别对应非名人堂球员、名人堂球员，代码运行后存在两个待解决问题：

• 水平x轴默认刻度值为0和1，需要替换为对应语义的文本标签
• 鼠标悬停在箱体区域时，悬停提示仍会显示0/1的原始x轴值，悬停离群点时不存在该问题

数据集字段样例如下：

{'player_id': {0: 2218, 1: 3168, 2: 2560, 3: 3228, 4: 4374},
 'player': {0: 'A.C. Green',
  1: 'A.J. Bramlett',
  2: 'A.J. English',
  3: 'A.J. Guyton',
  4: 'A.J. Hammons'},
 'g': {0: 1278.0, 1: 8.0, 2: 151.0, 3: 80.0, 4: 22.0},
 'fg': {0: 3.56, 1: 0.5, 2: 4.09, 3: 2.08, 4: 0.77},
 'fga': {0: 7.2, 1: 2.62, 2: 9.39, 3: 5.5, 4: 1.91},
 'trb': {0: 7.41, 1: 2.75, 2: 2.09, 3: 1.0, 4: 1.64},
 'ast': {0: 1.1, 1: 0.0, 2: 2.12, 3: 1.84, 4: 0.18},
 'stl': {0: 0.81, 1: 0.12, 2: 0.38, 3: 0.25, 4: 0.05},
 'blk': {0: 0.43, 1: 0.0, 2: 0.16, 3: 0.15, 4: 0.59},
 'pts': {0: 9.65, 1: 1.0, 2: 9.95, 3: 5.52, 4: 2.18},
 'all_star': {0: 1, 1: 0, 2: 0, 3: 0, 4: 0},
 'outliers': {0: 0, 1: 0, 2: 0, 3: 0, 4: 0},
 'HOF': {0: 0, 1: 0, 2: 0, 3: 0, 4: 0}}

两个问题可以通过x轴刻度映射+悬停模板补全一次性解决，无需修改原始数据集：

1. 为所有子图x轴配置原始刻度值与显示文本的映射关系，将0替换为「非名人堂球员」、1替换为「名人堂球员」
2. 补全悬停模板配置，主动屏蔽悬停框默认展示的原始x轴值，消除箱体悬停时的0/1冗余显示

修改时无需调整原有绘图逻辑，仅需替换悬停模板、新增x轴配置段即可，修改后的核心代码如下：

# 调整悬停模板，末尾添加<extra></extra>屏蔽默认附加信息
hovertemp = '<b>%{customdata}: </b> %{y} <extra></extra>'


fig.update_traces(
                  showlegend=False,
                  customdata = per_game_player['player'],
                  hovertemplate = hovertemp,
)

# 批量为5个子图配置x轴刻度文本
for col in range(1,6):
    fig.update_xaxes(
        tickvals=[0, 1],
        ticktext=['非名人堂球员', '名人堂球员'],
        row=1, col=col
    )

fig.update_layout(title_text = 'top stats')
fig.show();

配置说明 #

• tickvals参数指定需要显示的原始刻度值，ticktext参数对应每个原始刻度的显示文本，直接实现x轴标签语义化
• 悬停模板末尾添加的<extra></extra>是Plotly固定语法，用于隐藏悬停弹窗默认附带的追踪名称、原始坐标值等冗余信息，正好解决箱体悬停时显示0/1的问题
• 如果需要单独调整某个子图的x轴样式，无需批量循环配置，单独对对应列的x轴调用update_xaxes设置参数即可

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