pandas.io.formats.style.Styler.set_tooltips

Styler.set_tooltips(ttips, props=None, css_class=None)

设置 Styler 上的字符串 DataFrame，生成 :hover 工具提示。

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

在 1.3.0 版本加入.

Parameters:

ttipsDataFrame

包含字符串的 DataFrame，这些字符串将被转换为工具提示，通过底层 Styler 数据中必须存在的、相同的列和索引值进行映射。None、NaN 值和空字符串将被忽略，并且不会影响渲染的 HTML。

props类列表或字符串，可选

(attr, value) 元组列表或有效的 CSS 字符串。如果为 None，则采用内部默认值，请参见 notes。

css_classbool, default False

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

Returns:

Styler

Notes

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

工具提示 CSS 类别的默认属性为：

• visibility: hidden

• position: absolute

• z-index: 1

• background-color: black

• color: white

• transform: translate(-20px, -20px)

属性 ‘visibility: hidden;’ 是悬停功能的一个关键先决条件，并且应始终包含在任何手动属性规范中，使用 props 参数。

工具提示的设计并非为了效率，它们可能会为较大的表格添加大量的额外 HTML，因为它们还要求 cell_ids 被强制设置为 True。

Examples

基本用法

>>> 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;')
...