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>
元素以及所有相关的元素class
和id
标识符,还是仅包含<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" > </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> ...