pandas.DataFrame.to_html

DataFrame.to_html(buf=None, *, columns=None, col_space=None, header=True, index=True, na_rep='NaN', formatters=None, float_format=None, sparsify=None, index_names=True, justify=None, max_rows=None, max_cols=None, show_dimensions=False, decimal='.', bold_rows=True, classes=None, escape=True, notebook=False, border=None, table_id=None, render_links=False, encoding=None)[source]

Отображение DataFrame в виде HTML-таблицы.

Параметры:

buf:str, Path или StringIO-подобный объект, по умолчанию None

Буфер для записи. Если None, результат возвращается в виде строки.

columns:массив-подобный объект, по умолчанию None

Подмножество столбцов для записи. По умолчанию записываются все столбцы.

col_space:строка или целое число, список или словарь целых чисел или строк, по умолчанию None

Минимальная ширина каждого столбца в единицах CSS. Целое число предполагается в единицах px.

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

Выводить ли метки столбцов, по умолчанию True.

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

Выводить ли метки индекса (строки).

na_rep:строка, по умолчанию ‘NaN’

Строковое представление NaN, которое будет использоваться.

formatters:список, кортеж или словарь функций с одним параметром, по умолчанию None

Функции форматирования для применения к элементам столбцов по позиции или имени. Результат каждой функции должен быть строкой unicode. Список/кортеж должен иметь длину, равную количеству столбцов.

float_format:функция с одним параметром, по умолчанию None

Функция форматирования для применения к элементам столбцов, если они являются числами с плавающей запятой. Эта функция должна возвращать строку unicode и будет применяться только к не-NaN элементам, при этом NaN обрабатывается na_rep.

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

Установить в False для DataFrame с иерархическим индексом, чтобы печатать каждый ключ многоуровневого индекса в каждой строке.

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

Выводит имена индексов.

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

Как выравнивать метки столбцов. Если None, используется вариант из конфигурации печати (управляемый set_option), по умолчанию ‘right’. Допустимые значения:

• left

• right

• center

• justify

• justify-all

• start

• end

• inherit

• match-parent

• initial

• unset.

max_rows:целое число, необязательно

Максимальное количество строк для отображения в консоли.

max_cols:целое число, необязательно

Максимальное количество столбцов для отображения в консоли.

show_dimensions:bool, по умолчанию False

Отобразить размеры DataFrame (количество строк по количеству столбцов).

decimal:строка, по умолчанию ‘.’

Символ, распознаваемый как десятичный разделитель, например ‘,’ в Европе.

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

Сделать метки строк жирными в выводе.

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

CSS класс(ы) для применения к результирующей HTML-таблице.

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

Преобразовать символы <, > и & в безопасные для HTML последовательности.

notebook:{True, False}, по умолчанию False

Будет ли сгенерированный HTML предназначен для IPython Notebook.

border:целое число

Атрибут border=border включен в открывающий тег <table>. Значение по умолчанию pd.options.display.html.border.

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

Указанный css id включен в открывающий тег <table>.

render_links:bool, по умолчанию False

Преобразовать URL-адреса в HTML-ссылки.

encoding:строка, по умолчанию “utf-8”

Установить кодировку символов.

Возвращаемое значение:

str или None

Если buf равен None, возвращает результат как строку. В противном случае возвращает None.

См. также

to_string

Преобразовать DataFrame в строку.

Примеры

>>> df = pd.DataFrame(data={'col1': [1, 2], 'col2': [4, 3]})
>>> html_string = '''<table border="1" class="dataframe">
...   <thead>
...     <tr style="text-align: right;">
...       <th></th>
...       <th>col1</th>
...       <th>col2</th>
...     </tr>
...   </thead>
...   <tbody>
...     <tr>
...       <th>0</th>
...       <td>1</td>
...       <td>4</td>
...     </tr>
...     <tr>
...       <th>1</th>
...       <td>2</td>
...       <td>3</td>
...     </tr>
...   </tbody>
... </table>'''
>>> assert html_string == df.to_html()