pandas.io.formats.style.Styler#

class pandas.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)[源代码]#

使用HTML和CSS根据数据帮助设置DataFrame或Series的样式。

参数
data系列或DataFrame

要设置样式的数据-系列或DataFrame。

precision整型,可选

要舍入的浮点数的精度。如果未指定,则默认为 pandas.options.styler.format.precision

在 1.4.0 版更改.

table_styles类似列表,默认为无

{选择器:(Attr,Value)}词典列表;请参阅注释。

uuid字符串,默认为无

用于避免CSS冲突的唯一标识符;自动生成。

caption字符串、元组、默认无

要附加到表的字符串标题。元组仅用于 Latex 双字幕。

table_attributes字符串,默认为无

在开幕式中显示的项目 <table> 除自动(默认情况下)id之外的标签。

cell_ids布尔值,默认为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整型,默认为5

如果 uuid 如果未指定,则 uuid 在范围内随机生成以十六进制字符表示的 [0,32] 。

1.2.0 新版功能.

decimal字符串,可选

用作浮点数、复数和整数的小数分隔符的字符。如果没有被赋予用途 pandas.options.styler.format.decimal

1.3.0 新版功能.

thousands字符串,可选,默认为无

用作浮点数、复数和整数的千位分隔符的字符。如果没有被赋予用途 pandas.options.styler.format.thousands

1.3.0 新版功能.

escape字符串,可选

使用‘html’替换字符 &<>' ,以及 " 在具有HTML安全序列的单元格显示字符串中。使用‘LaTeX’替换字符 &%$#_{{}}~^ ,以及 \ 在具有 Latex 安全序列的单元格显示字符串中。如果没有被赋予用途 pandas.options.styler.format.escape

1.3.0 新版功能.

formatter字符串、可调用、DICT、可选

对象以定义值的显示方式。看见 Styler.format 。如果没有被赋予用途 pandas.options.styler.format.formatter

1.4.0 新版功能.

参见

DataFrame.style

返回一个Styler对象,该对象包含用于为DataFrame生成带样式的HTML表示形式的方法。

注意事项

大多数样式设置将通过将样式函数传递给 Styler.applyStyler.applymap 。样式函数应返回值,其中的字符串包含css 'attr: value' 这将应用于所指示的单元格。

如果在Jupyter笔记本中使用,Styler定义了一个 _repr_html_ 以自动呈现自身。否则,调用Styler.to_html以获取生成的HTML。

将CSS类附加到生成的HTML

  • 索引和列名包括 index_namelevel<k> 哪里 k 它的级别是否在多索引中

  • 索引标签单元格包括

    • row_heading

    • row<n> 哪里 n 是行的数字位置。

    • level<k> 哪里 k 是多重索引中的级别

  • 列标签单元格包括 * col_heading * col<n> 哪里 n 是列*的数字位置 level<k> 哪里 k 是多重索引中的级别

  • 空白单元格包括 blank

  • 数据单元格包括 data

  • 修剪后的单元格包括 col_trimrow_trim

任何类、所有类或这些类都可以使用 css_class_names 中的参数 Styler.set_table_classes ,给出一个值,如 {{"row": "MY_ROW_CLASS", "col_trim": "", "row_trim": ""}}

属性

env

(JJIA2 JJIA2.环境)

template_html

(JJIA2模板)

template_html_table

(JJIA2模板)

template_html_style

(JJIA2模板)

template_latex

(JJIA2模板)

loader

(JJIA2装载机)

方法:

apply \(函数[, axis, subset] )

按列、按行或按表应用css样式函数。

apply_index \(函数[, axis, level] )

对索引或列标题逐级应用css样式函数。

applymap \(函数[, subset] )

以元素方式应用一个css样式函数。

applymap_index \(函数[, axis, level] )

对索引或列标题按元素应用css样式函数。

background_gradient \([cmap, low, high, axis, ...] )

以渐变样式为背景上色。

bar \([subset, axis, color, cmap, width, ...] )

在单元格背景中绘制条形图。

clear \()

重置 Styler ,删除以前应用的所有样式。

concat \(其他)

追加另一个样式器以将输出合并到单个表中。

export \()

导出应用于当前样式器的样式。

format \([formatter, subset, na_rep, ...] )

设置单元格的文本显示值的格式。

format_index \([formatter, axis, level, ...] )

设置索引标签或列标题的文本显示值的格式。

from_custom_template \(搜索路径[, ...] )

用于创建子类的工厂函数 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 \(函数,*args, * *kwargs)

应用 func(self, *args, **kwargs) ,并返回结果。

render \([sparse_index, sparse_columns] )

(已弃用)呈现 Styler 包括所有应用于HTML的样式。

set_caption \(标题)

设置添加到 <caption> Html元素。

set_na_rep \(NA_REP)

(已弃用)将缺少的数据表示设置为 Styler

set_precision \(精度)

(已弃用)设置用于显示值的精度。

set_properties \([subset] )

将定义的css属性设置为 <td> 给定子集中的HTML元素。

set_sticky \([axis, pixel_size, levels] )

添加css以在滚动框架中永久显示索引或列标题。

set_table_attributes \(属性)

设置添加到 <table> Html元素。

set_table_styles \([table_styles, axis, ...] )

设置包含在 <style> Html元素。

set_td_classes \(类)

设置添加到 class 的属性 <td> Html元素。

set_tooltips \(tTips[, props, css_class] )

将字符串的DataFrame设置为 Styler 生成 :hover 工具提示。

set_uuid \(UUID)

设置应用于的UUID id HTML元素的属性。

text_gradient \([cmap, low, high, axis, ...] )

以渐变样式为文本上色。

to_excel \(EXCEL_编写器[, 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 \(样式)

设置当前样式器上的样式。

where \(条件,值[, other, subset] )

(已弃用)基于条件函数以元素方式应用css样式。