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。

Added in version 1.3.0.

参数:
bufstr, 路径对象, 类文件对象, 可选

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

table_uuidstr, 可选

为 <table> HTML 元素分配的 id 属性,格式为:

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

如果未指定,则使用 Styler 最初分配的值。

table_attributesstr, 可选

<table> HTML 元素中分配的属性,格式为:

<table .. <table_attributes> >

如果未指定,则默认为 Styler 的现有值。

sparse_index布尔值, 可选

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

Added in version 1.4.0.

sparse_columns布尔值, 可选

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

Added in version 1.4.0.

bold_headers布尔值, 可选

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

Added in version 1.4.0.

标题str, 可选

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

Added in version 1.4.0.

max_rowsint, 可选

将渲染的最大行数。默认为 pandas.options.styler.render.max_rows/max_columns

Added in version 1.4.0.

max_columnsint, 可选

将要渲染的最大列数。默认为 pandas.options.styler.render.max_columns,即 None。

如果元素总数很大,行和列可能会减少。此值设置为 pandas.options.styler.render.max_elements,即 262144(18 位浏览器渲染)。

Added in version 1.4.0.

编码str, 可选

文件输出(如果可用,还包括元标签)的字符编码设置。默认为 pandas.options.styler.render.encoding 值为 “utf-8”。

doctype_html布尔值, 默认为 False

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

exclude_styles布尔值, 默认为 False

是否包含 <style> 元素以及所有相关的元素 classid 标识符,还是仅包含 <table> 元素而不带样式标识符。

**kwargs

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

返回:
str 或 None

如果 buf 是 None,则以字符串形式返回结果。否则返回 None

参见

DataFrame.to_html

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

示例

>>> 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>
...