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.apply或Styler.applymap。样式函数应返回值,其中的字符串包含css'attr: value'这将应用于所指示的单元格。如果在Jupyter笔记本中使用,Styler定义了一个
_repr_html_以自动呈现自身。否则,调用Styler.to_html以获取生成的HTML。将CSS类附加到生成的HTML
索引和列名包括
index_name和level<k>哪里 k 它的级别是否在多索引中索引标签单元格包括
row_headingrow<n>哪里 n 是行的数字位置。level<k>哪里 k 是多重索引中的级别
列标签单元格包括 *
col_heading*col<n>哪里 n 是列*的数字位置level<k>哪里 k 是多重索引中的级别空白单元格包括
blank数据单元格包括
data修剪后的单元格包括
col_trim或row_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, ...] )使用样式高亮显示由分位数定义的值。
应用
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
idHTML元素的属性。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样式。