pandas.io.formats.style.Styler.set_tooltips #

造型器。set_tooltips ( ttips , props = None , css_class = None ) [来源] #

Styler在生成工具提示时设置字符串的 DataFrame :hover

这些基于字符串的工具提示仅适用于<td>HTML 元素,不能用于列或索引标题。

1.3.0 版本中的新增功能。

参数
提示数据框

DataFrame 包含将转换为工具提示的字符串,由基础 Styler 数据上必须存在的相同列和索引值映射。 None、NaN 值和空字符串将被忽略,并且不会影响呈现的 HTML。

props list-like 或 str,可选

(attr, value) 元组列表或有效的 CSS 字符串。如果None采用注释中描述的内部默认值。

css_class str,可选

CSS 中使用的工具提示类的名称应符合 HTML 标准。仅当将工具提示与外部 CSS 集成时才有用。如果None使用内部默认值“pd-t”。

返回
造型器

笔记

通过将<span class=”pd-t”></span>添加到每个数据单元格,然后操作表级 CSS 以附加伪悬停和伪选择器后来创建工具提示,以生成所需的结果。

工具提示 CSS 类的默认属性是:

  • 可见性:隐藏

  • 位置:绝对

  • z 索引:1

  • 背景颜色:黑色

  • 白颜色

  • 变换:翻译(-20px,-20px)

属性“可见性:隐藏;”是悬停功能的关键先决条件,并且应始终使用参数包含在任何手动属性规范中props

工具提示的设计目的并不高效率,并且可以为较大的表格添加大量额外的 HTML,因为它们还要求cell_ids 强制为True

例子

基本应用

>>> df = pd.DataFrame(data=[[0, 1], [2, 3]])
>>> ttips = pd.DataFrame(
...    data=[["Min", ""], [np.nan, "Max"]], columns=df.columns, index=df.index
... )
>>> s = df.style.set_tooltips(ttips).to_html()

有选择地控制工具提示的视觉显示

>>> df.style.set_tooltips(ttips, css_class='tt-add', props=[
...     ('visibility', 'hidden'),
...     ('position', 'absolute'),
...     ('z-index', 1)])  
>>> df.style.set_tooltips(ttips, css_class='tt-add',
...     props='visibility:hidden; position:absolute; z-index:1;')
...