简码 [table id=N /] 用于在文章、页面或者文字小工具中显示一个表格。可以在编辑文章或页面的时候手工输入，也可以通过编辑栏上的“表格”按钮自动输入。简码中可以包含一些参数，通过控制这些参数就可以控制所插入表格的一些属性和行为。

简码中可以包含以下参数。所有参数可以简单地（无所谓顺序）添加到简码中，例如：

[table id=1 alternating_row_colors=false column_widths="40px|50px|80px|40px" /]

如果你使用了参数，那么它会对应地覆盖你在相应表格的“编辑表格”页面对 表格属性 所作的设置！（例如：如果在“编辑表格”页面将使用JS库 前面的方框选中，那么使用参数 use_tablesorter=false 将会覆盖这个设置。其结果就是将无法对表格进行排序等操作。）

普通用户多半用不上这些参数。一般情况下，如果需要更改显示设置，推荐从“编辑表格”页面（对该表格进行编辑时的页面下方有一些设置可选）进行相应的设置。

id (整数) (必须)

其中“ID”表示需要显示的表格的内部编号 ID（由“整数”表示，可以在“表格列表”或表格编辑页面中查看）。（使用这个参数时最好不要使用引号，就像所有示例中展示的那样，这样能够避免 WordPress 搜索功能出错。）

column_widths (字符串) (可选)

表示列宽的字符串，用 | 符号（管道符）隔开，例如：

column_widths="40px|50px|30px|40px"

或者

column_widths="20%|60%|20%"

该参数在需要设定某个表格的特定列宽时非常好用。

alternating_row_colors (布尔值) (可选)

表格在显示的时候是否要根据奇偶行来交替改变行的背景颜色（即所谓“斑马条带化”）（参考CSS类 odd 和 even）

row_hover (布尔值) (可选)

当鼠标在表格的行上悬停时是否使用不同的背景颜色来高亮显示该行

table_head (布尔值) (可选)

如果为 true，则表格第一行将会使用 <th> HTML 标记（普通行是 <td> 标记），并置于 <thead> HTML 标记之中

first_column_th (布尔值) (可选)

在 HTML 标记 <thead> 中是否用 <th> 来标记表格的第一列（在管理后台中没有该参数的对应选项！）

table_foot (布尔值) (可选)

在 HTML 标记 <tfoot> 中是否用 <th> 来标记表格的最后一行

print_name (布尔值) (可选)

是否在表格的上方/下方显示表格名称

print_name_position (字符串) (可选)

显示表格名称的位置：可以是 “above” 或者 “below”

print_description (布尔值) (可选)

是否在表格的上方/下方显示表格描述

print_description_position (字符串) (可选)

显示表格描述的位置：可以是 “above” 或者 “below”

use_datatables (布尔值) (可选)

是否在该表格中启用 DataTables JavaScript 库（一个 jQuery 插件）（只有当表格第一行使用 <th> HTML 标记的时候才有效，不管是在表格的“编辑”页面设定的，还是使用前面介绍的简码参数 table_head 设定的）。

例如，如果某个表格（假设 ID 为 123）需要展示在多个地方，比如文章内容以及侧边栏。当它在文章内容中显示时，希望启用诸如搜索、过滤和排序等 DataTables 功能，但是在侧边栏的时候就不希望有这些功能，就可以将常规的简码，

[table id=123 /]

改为

[table id=2 use_datatables="false" /]

以达到目的。

当然，也可以使用下面的参数来禁用其中某几项 DataTables 特性。

datatables_sort, datatables_paginate, datatables_lengthchange, datatables_filter, datatables_info (布尔值) (可选)

是否为该表格激活 DataTables JavaScript 库的对应功能（更多相关信息请参考 TablePress 文档：数据表格部分，或者访问 DataTables 官方网站）

show_rows, hide_rows, show_columns, hide_columns (字符串) (可选)

这些参数可以用于覆盖在后台设定的显示设置（只对该指令覆盖的范围有效）。例如：

[table id=2 hide_columns="1,2,3" show_rows="4,5,6" /]

将会隐藏该表格的前三行而显示第4、5和6行，而不管在后台编辑该表格时是怎么设置的。除了可以手动输入每个行或列的编号，还有一个参数值 “all” 能够用于影响所有的行/列。

如果需要的话，这些参数也可以同时使用。例如：

hide_columns="3,4,5" show_columns="8,9"

cellspacing, cellpadding, border (整数) (可选)

对应于下面 HTML 表格代码中的参数：

<table cellspacing="0" cellpadding="0" border="0">
<tr>
<td>...</td>
</tr>
</table>

默认情况下没有设置这些参数，因为使用 CSS 可以更好的控制这些设置。不过某些特殊情况下它们可能有用。

这是 WordPress 表格插件 TablePress 的简体中文说明文档的第一篇，介绍了简码（Shortcode）的各种参数和使用方法。请访问 TablePress 使用及开发文档页面获取其它方面的说明文档。©

本文发表于水景一页。永久链接：<https://cnzhx.net/blog/tablepress-doc_shortcode_table/>。转载请保留此信息及相应链接。