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_heading
row<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
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样式。