pandas.io.formats.style.Styler.set_tooltips

Styler.set_tooltips(ttips, props=None, css_class=None)[source]

Установите DataFrame строк для Styler создания :hover всплывающих подсказок.

Эти всплывающие подсказки на основе строк применимы только к <td> HTML-элементам и не могут использоваться для заголовков столбцов или индексов.

Добавлена в версии 1.3.0.

Параметры

ttips:DataFrame

DataFrame, содержащий строки, которые будут преобразованы во всплывающие подсказки, сопоставленные по идентичным значениям столбцов и индексов, которые должны существовать в базовых данных Styler. Значения None, NaN и пустые строки будут проигнорированы и не повлияют на рендер HTML.

props:list-like или str, необязательно

Список кортежей (attr, value) или допустимая строка CSS. Если None принимает внутренние значения по умолчанию, описанные в примечаниях.

css_class:str, необязательно

Имя класса всплывающей подсказки, используемого в CSS, должно соответствовать стандартам HTML. Полезно только при интеграции всплывающих подсказок с внешним CSS. Если None использует внутреннее значение по умолчанию ‘pd-t’.

Возвращает

self:Styler

Примечания

Всплывающие подсказки создаются путем добавления <span class=”pd-t”></span> к каждой ячейке данных, а затем путем манипулирования CSS на уровне таблицы для подключения псевдо-hover и псевдо-после селекторов для получения требуемых результатов.

Значения свойств по умолчанию для класса CSS всплывающей подсказки:

• visibility: hidden

• position: absolute

• z-index: 1

• background-color: black

• color: white

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

Свойство ‘visibility: hidden;’ является ключевым условием для функции hover и всегда должно включаться в любой спецификации свойств вручную, используя аргумент 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;')
...