pandas.io.formats.style.Styler

classpandas.io.formats.style.Styler(data, precision=None, table_styles=None, uuid=None, caption=None, table_attributes=None, cell_ids=True, na_rep=None, uuid_len=5, decimal=None, thousands=None, escape=None, formatter=None)[source]

Помогает стилизовать DataFrame или Series в соответствии с данными с помощью HTML и CSS.

Параметры

data:Series или DataFrame

Данные, которые нужно стилизовать - либо Series, либо DataFrame.

precision:int, необязательно

Точность для округления чисел с плавающей запятой. Если не указано, по умолчанию используется pandas.options.styler.format.precision.

Изменено в версии 1.4.0.

table_styles:подобный списку, по умолчанию None

Список словарей {селектор: (атрибут, значение)}; см. Примечания.

uuid:строка, по умолчанию None

Уникальный идентификатор для предотвращения столкновений CSS; генерируется автоматически.

caption:строка, кортеж, по умолчанию None

Строка подписи, добавляемая к таблице. Кортеж используется только для двойных подписей в LaTeX.

table_attributes:строка, по умолчанию None

Элементы, отображаемые в открывающем <table> теге помимо автоматического (по умолчанию) id.

cell_ids:bool, по умолчанию True

Если True, каждая ячейка будет иметь атрибут id в своём теге HTML. Атрибут id принимает вид T_<uuid>_row<num_row>_col<num_col>, где <uuid> - уникальный идентификатор, <num_row> - номер строки, а <num_col> - номер столбца.

na_rep:строка, необязательно

Представление для пропущенных значений. Если na_rep равно None, специальное форматирование не применяется, и используется значение по умолчанию pandas.options.styler.format.na_rep.

Новое в версии 1.0.0.

uuid_len:int, по умолчанию 5

Если uuid не указано, длина uuid для случайной генерации выражается в шестнадцатеричных символах в диапазоне [0, 32].

Новое в версии 1.2.0.

decimal:строка, необязательно

Символ, используемый в качестве десятичного разделителя для чисел с плавающей запятой, комплексных и целых чисел. Если не указано, используется pandas.options.styler.format.decimal.

Новое в версии 1.3.0.

thousands:строка, необязательно, по умолчанию None

Символ, используемый в качестве разделителя тысяч для чисел с плавающей запятой, комплексных и целых чисел. Если не указано, используется pandas.options.styler.format.thousands.

Новое в версии 1.3.0.

escape:строка, необязательно

Используйте ‘html’, чтобы заменить символы &, <, >, ', и " в строке отображения ячейки безопасными для HTML последовательностями. Используйте ‘latex’, чтобы заменить символы &, %, $, #, _, {, }, ~, ^, и \ в строке отображения ячейки безопасными для LaTeX последовательностями. Если не указано, используется pandas.options.styler.format.escape.

Новое в версии 1.3.0.

formatter:строка, вызываемая функция, словарь, необязательно

Объект для определения того, как отображаются значения. См. Styler.format. Если не указано, используется pandas.options.styler.format.formatter.

Новое в версии 1.4.0.

См. также

DataFrame.style

Возвращает объект Styler, содержащий методы для построения стилизованного представления DataFrame в HTML.

Примечания

Большинство стилей будет применяться путём передачи функций стилей в Styler.apply или Styler.applymap. Функции стилей должны возвращать значения со строками, содержащими CSS 'attr: value' которые будут применяться к указанным ячейкам.

Если используется в Jupyter Notebook, Styler определяет _repr_html_ для автоматического отображения. В противном случае вызовите Styler.to_html, чтобы получить сгенерированный HTML.

Классы CSS присоединяются к сгенерированному HTML

• Имена индексов и столбцов включают index_name и level<k> где k - его уровень в MultiIndex

• Ячейки меток индекса включают

  • row_heading

  • row<n> где n - числовая позиция строки

  • level<k> где k - уровень в MultiIndex

• Ячейки меток столбцов включают * col_heading * col<n> где n - числовая позиция столбца * level<k> где k - уровень в MultiIndex

• Пустые ячейки включают blank

• Ячейки данных включают data

• Усеченные ячейки включают col_trim или row_trim.

Любые, или все, или эти классы могут быть переименованы, используя аргумент css_class_names в Styler.set_table_classes, задавая значение, такое как {“row”: “MY_ROW_CLASS”, “col_trim”: “”, “row_trim”: “”}.

Атрибуты

env	(Jinja2 jinja2.Environment)
template_html	(Jinja2 Шаблон)
template_html_table	(Jinja2 Шаблон)
template_html_style	(Jinja2 Шаблон)
template_latex	(Jinja2 Шаблон)
loader	(Jinja2 Загрузчик)

Методы

apply(func[, axis, subset])	Применение функции форматирования в стиле CSS по столбцам, строкам или таблице.
apply_index(func[, axis, level])	Применение функции форматирования в стиле CSS к меткам индекса или заголовкам столбцов по уровням.
applymap(func[, subset])	Применение функции форматирования в стиле CSS к ячейкам по элементу.
applymap_index(func[, axis, level])	Применение функции форматирования в стиле CSS к меткам индекса или заголовкам столбцов по элементу.
background_gradient([cmap, low, high, axis, ...])	Заливка фона в стиле градиента.
bar([subset, axis, color, cmap, width, ...])	Отображение столбчатой диаграммы в фоновых цветах ячеек.
clear()	Сброс Styler, удаление ранее примененных стилей.
concat(other)	Добавление другого Styler для объединения вывода в одну таблицу.
export()	Экспорт примененных стилей текущего Styler.
format([formatter, subset, na_rep, ...])	Форматирование текстовых значений ячеек.
format_index([formatter, axis, level, ...])	Форматирование текстовых значений меток индекса или заголовков столбцов.
from_custom_template(searchpath[, ...])	Функция-фабрика для создания подкласса Styler.
hide([subset, axis, level, names])	Скрытие всего индекса/заголовков столбцов или отдельных строк/столбцов.
hide_columns([subset, level, names])	Скрытие заголовков столбцов или отдельных ключей в столбцах.
hide_index([subset, level, names])	(УСТЕРЕЖДЁН) Скрытие всего индекса или отдельных ключей в индексе.
highlight_between([subset, color, axis, ...])	Выделение определенного диапазона стилем.
highlight_max([subset, color, axis, props])	Выделение максимального значения стилем.
highlight_min([subset, color, axis, props])	Выделение минимального значения стилем.
highlight_null([color, subset, props, ...])	Выделение пропущенных значений стилем.
highlight_quantile([subset, color, axis, ...])	Выделение значений, определенных квантилем, стилем.
pipe(func, *args, **kwargs)	Применение func(self, *args, **kwargs), и возвращение результата.
relabel_index(labels[, axis, level])	Переименование меток индекса или заголовков столбцов на указанные значения.
render([sparse_index, sparse_columns])	(УСТЕРЕЖДЁН) Рендеринг Styler включая все примененные стили в HTML.
set_caption(caption)	Устанавливает текст, добавляемый к элементу HTML <caption>.
set_na_rep(na_rep)	(УСТЕРЕЖДЁН) Установка представления пропущенных данных в Styler.
set_precision(precision)	(УСТЕРЕЖДЁН) Установка точности отображения значений.
set_properties([subset])	Устанавливает заданные CSS-свойства каждому элементу HTML <td> для заданного подмножества.
set_sticky([axis, pixel_size, levels])	Добавление CSS для постоянного отображения меток индекса или столбцов в окне прокрутки.
set_table_attributes(attributes)	Устанавливает атрибуты таблицы, добавляемые к элементу HTML <table>.
set_table_styles([table_styles, axis, ...])	Устанавливает стили таблицы, включенные в элемент HTML <style>.
set_td_classes(classes)	Устанавливает атрибут class элементов HTML <td>.
set_tooltips(ttips[, props, css_class])	Устанавливает DataFrame строк на Styler, генерируя всплывающие подсказки :hover.
set_uuid(uuid)	Устанавливает uuid, применяемый к атрибутам HTML-элементов id.

text_gradient([cmap, low, high, axis, ...])	Отобразить текст в стиле градиента.
to_excel(excel_writer[, sheet_name, na_rep, ...])	Записать Styler в лист Excel.
to_html([buf, table_uuid, table_attributes, ...])	Записать Styler в файл, буфер или строку в формате HTML-CSS.
to_latex([buf, column_format, position, ...])	Записать Styler в файл, буфер или строку в формате LaTeX.
to_string([buf, encoding, sparse_index, ...])	Записать Styler в файл, буфер или строку в текстовом формате.
use(styles)	Установить стили в текущем Styler.
where(cond, value[, other, subset])	(УСТАРЕЛО) Применить CSS-стили на основе условной функции поэлементно.