pandas.io.formats.style.Styler.to_html

Styler.to_html(buf=None, *, table_uuid=None, table_attributes=None, sparse_index=None, sparse_columns=None, bold_headers=False, caption=None, max_rows=None, max_columns=None, encoding=None, doctype_html=False, exclude_styles=False, **kwargs)

将 Styler 以 HTML-CSS 格式写入文件、缓冲区或字符串。

在 1.3.0 版本加入.

Parameters:

buf字符串, 路径对象, 文件类对象, 可选

字符串、路径对象（实现了 os.PathLike[str]）或实现了字符串 write() 函数的文件类对象。如果为 None，则结果将作为字符串返回。

table_uuidbool, default False

分配给 <table> HTML 元素的 id 属性，格式为：

<table id="T_<table_uuid>" ..>

如果未给定，则使用 Styler 最初分配的值。

table_attributesbool, default False

要在 <table> HTML 元素中分配的属性，格式为：

<table .. <table_attributes> >

如果未给定，则默认为 Styler 现有的值。

sparse_indexbool, optional

是否稀疏显示分层索引。设置为 False 会为每一行中分层键的每个显式级别元素进行显示。默认为 pandas.options.styler.sparse.index 的值。

在 1.4.0 版本加入.

sparse_columnsbool, optional

是否稀疏显示分层索引。设置为 False 会为每一列中分层键的每个显式级别元素进行显示。默认为 pandas.options.styler.sparse.columns 的值。

在 1.4.0 版本加入.

bold_headersbool, optional

为表样式标题单元格添加 “font-weight: bold;” CSS 属性。

在 1.4.0 版本加入.

captionbool, default False

在渲染 Styler 之前设置或覆盖其标题。

在 1.4.0 版本加入.

max_rowsint, optional

将要渲染的行数上限。默认为 pandas.options.styler.render.max_rows/max_columns。

在 1.4.0 版本加入.

max_columnsint, optional

将要渲染的列数上限。默认为 pandas.options.styler.render.max_columns，即 None。

如果总元素数量庞大，行数和列数可能会被减少。此值设置为 pandas.options.styler.render.max_elements，即 262144（18 位浏览器渲染）。

在 1.4.0 版本加入.

encodingbool, default False

文件输出（以及可用时的元标记）的字符编码设置。默认为 pandas.options.styler.render.encoding 值 “utf-8”。

doctype_htmlbool，默认 False

是输出包含所有 HTML 元素的完整结构化 HTML 文件，还是仅输出核心的 <style> 和 <table> 元素。

exclude_stylesbool，默认 False

是包含 <style> 元素及其所有关联的元素 class 和 id 标识符，还是仅包含没有样式标识符的 <table> 元素。

**kwargs

任何额外的关键字参数都会传递给 jinja2 self.template.render 过程。当您需要为自定义模板提供额外变量时，此功能非常有用。

Returns:

str 或 None

如果 buf 为 None，则将结果作为字符串返回。否则返回 None。

参见

DataFrame.to_html

以 HTML 格式将 DataFrame 写入文件、缓冲区或字符串。

Examples

>>> df = pd.DataFrame({'A': [1, 2], 'B': [3, 4]})
>>> print(df.style.to_html())  
<style type="text/css">
</style>
<table id="T_1e78e">
  <thead>
    <tr>
      <th class="blank level0" >&nbsp;</th>
      <th id="T_1e78e_level0_col0" class="col_heading level0 col0" >A</th>
      <th id="T_1e78e_level0_col1" class="col_heading level0 col1" >B</th>
    </tr>
...