直接跳到内容

DataFrame 数据框

PnDataFrame 组件将 pandas、dask 和 streamz 的 DataFrameSeries 类型渲染为 HTML 表格。该组件支持 DataFrame.to_html 函数的所有参数。

如果需要显示更大的 DataFrame 或使用高级表格功能和交互性,我们建议使用 PnTabulator 组件或 PnPerspective 组件。

底层实现为panel.pane.DataFrame,参数基本一致,参考文档:https://panel.holoviz.org/reference/panes/DataFrame.html

基本用法

PnDataFrame 使用内置的 HTML 表示来渲染底层的 DataFrame:

参数控制

与所有其他 Panel 对象一样,更改参数将更新视图,使我们能够控制数据框的样式:

HTML 标记

通过将 escape 设置为 False,您可以在 DataFrame 组件中包含 HTML 标记

大型数据框

对于较大的数据框,设置 sizing_mode="stretch_both" 可以确保它们不会溢出很有用。这样做时,可以使用 max_height 指定(最大)高度:

Streamz DataFrames

除了渲染标准的 pandas DataFrameSeries 类型外,PnDataFrame 组件还将渲染更新的 streamz 类型: 注意:

  • 在活动内核中,您应该看到数据框每 0.5 秒更新一次。
  • streamz 当前在 Pyodide/PyScript 中不起作用。

API

属性

属性名说明类型默认值
object被显示的DataFrame对象pandas.DataFrame, dask.DataFrame, streamz.DataFrame None
bold_rows在输出中使行标签加粗boolean True
border在开始的table标签中包含的边框宽度int 0
classes应用于结果HTML表格的CSS类list[str ]None
col_space每列的最小宽度(以CSS长度单位表示)int, str, dict None
decimal识别为小数分隔符的字符,例如欧洲的','str '.'
escape将字符 <, >, 和 & 转换为HTML安全序列boolean True
float_format如果列元素是浮点数,则应用的格式化函数function None
formatters按位置或名称应用于列元素的格式化函数dict, list None
header是否打印列标签boolean True
index是否打印索引(行)标签boolean True
index_names是否打印索引的名称boolean True
justify如何对齐列标签str None
max_rows要显示的最大行数int None
max_cols要显示的最大列数int None
na_repNAN的字符串表示str 'NaN'
render_links将URL转换为HTML链接boolean False
show_dimensions显示DataFrame维度(行数乘以列数)boolean False
sparsify对于具有分层索引的DataFrame,设置为False以在每行打印每个多索引键boolean True
text_align如何对齐非标题单元格str None
sizing_mode尺寸调整模式str 'fixed'
width宽度int, str None
height高度int, str None
max_height最大高度int None

Events

事件名说明类型

Slots

插槽名说明
default自定义默认内容

方法

属性名说明类型

src/examples/panel_vuepy/panes/DataFrame

DataFrame 数据框已经加载完毕