pandas.io.formats.style.Styler.set_tooltips

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

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

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

Введено в версии 1.3.0.

Параметры:

ttips:DataFrame

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

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

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

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

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

Возвращает:

Styler

Примечания

Всплывающие подсказки создаются путем добавления <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;' является ключевым условием для функции 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;')
...