使用自定义格式设置主题
Tableau 安装了许多格式设置选项,以便您可以自定义可视化项和仪表板以满足您的需求。如果您对许多工作簿使用相同的格式,或者您有更适合您的业务的特殊字体和颜色,则可以使用自定义格式设置主题来节省时间。自定义主题可快速将您的格式设置选择应用到整个 Tableau 工作簿。
您可以通过导入指定格式设置选择的 JSON 文件将自定义主题添加到 Tableau 工作簿。同样,如果您正在查看工作簿并且想要在另一个工作簿上使用相同的主题,则可以导出自定义主题文件。
注意:此功能仅在 Tableau Desktop 2025.1 中可用。
导入自定义主题
- 打开 Tableau Desktop 并创建工作表。
- 从工具栏中选择“格式”。
- 选择“导入自定义主题...”

- 选择要导入的 JSON 文件并选择“打开”。
出现一个对话框,其中有以下选项:“覆盖” 或者“保留”您所做的任何现有格式设置编辑。

您可以选择让自定义主题覆盖在导入自定义主题之前对 Tableau 工作簿所做的任何格式设置更改。您还可以选择在导入自定义主题之前保留通过格式设置窗格所做的更改。
注意:如果您选择让自定义主题覆盖现有的格式设置编辑,它将只会覆盖您在 JSON 文件中包含的样式更改。它也不会覆盖通过富文本编辑器所做的样式更改。
覆盖:自定义主题文件将覆盖对 Tableau 工作簿所做的任何格式设置。
保留:自定义主题文件将保留对 Tableau 工作簿所做的任何格式设置。
- 选择“覆盖”或“保留”。
您的自定义主题将导入并将格式设置应用到您的工作簿。
导出自定义主题
您可以通过两种方式导出自定义主题:可以导出自定义主题文件,也可以导出应用了自定义主题的工作簿。当您导出主题时,导出文件将包含您在所选工作表上所做的格式设置选择。例如,如果您在工作簿中两个不同的工作表上有不同的格式设置选择,则导出的自定义主题文件将反映导出文件时所选工作表的格式设置选择。仅会导出自定义主题文件中支持且存在的样式元素。
导出包含自定义主题的 JSON 文件
- 从工具栏中选择“格式”。
- 选择“导出自定义主题...”

- 导航到要保存自定义主题文件的文件夹,然后按“保存”。
您现在可以在本地找到自定义主题文件。该主题文件可以导入到其他工作簿并与其一起使用。
导出应用了自定义主题的工作簿
从工作表的工具栏中选择“文件”,然后选择“另存为”。
或者,您可以选择“导出打包工作簿”。
- 将工作簿另存为 .twb 或 .twbx 文件。
当您在 Tableau 中重新打开工作簿时,将应用自定义主题。
创建 JSON 主题文件
JSON 文件是定义自定义主题中的样式的地方。您可以使用自己喜欢的文本编辑器创建一个文件,确保其中包含自定义主题所需的样式元素。使用示例文件作为创建文件的模板。
有许多第三方资源可以帮助您验证文件,例如 https://www.jsonschemavalidator.net。
在此处复制验证主题文件所需的 JSON 架构文件。
自定义主题文件中要包含的元素
您的自定义主题文件应包含版本、基本主题、样式元素、样式属性和格式设置选择。
版本
自定义主题文件的第一行应该包含版本。从 Tableau 25.1 开始,版本号为 1.0.0,该行应如下所示:“version”: “1.0.0”。
版本号可能会在 Tableau 的未来版本中更新。
基本主题
自定义主题文件的第二个条目应该包含基本主题。基本主题对应于 Tableau 中现有的工作簿主题,并且基于不同版本的 Tableau Desktop。json 主题文件中指定的任何格式设置样式都将应用于基础主题之上。
| 基本主题 | 对应 | 主题文件中的条目 |
|---|---|---|
| 平滑 | Tableau Desktop 版本 10.x 及更高版本 | "base-theme": "smooth" |
| 清理 | Tableau Desktop 版本 8.0.x – 9.3.x | "base-theme": "clean" |
| 现代 | Tableau Desktop 版本 3.5 – 7.0。 | "base-theme": "modern" |
| 经典 | Tableau Desktop 版本 1.0 – 3.2 | "base-theme": "classic" |
有关工作簿主题的详细信息,请参见升级或更改工作簿主题(仅限 Tableau Desktop)
样式元素
样式元素指定在什么级别应用格式设置选择。例如,所有字体、筛选器标题或仅工具提示字体。请参见样式元素表以获取可供指定的元素列表。
样式属性
样式属性指定您想要应用格式设置选择的样式元素的部分。例如,所有样式元素的字体颜色和字体大小。
请务必检查您所使用的样式元素的属性列表。例如,虽然荧光笔样式元素支持背景颜色样式属性,但荧光笔标题元素却不支持。
格式设置选择
格式设置选择指定您想要应用于样式元素和样式属性的内容。例如,字体颜色、字体系列和字体大小。格式设置选择必须以字符串或整数形式输入,具体取决于样式属性。颜色必须以十六进制颜色代码输入,例如 #FF0000。
字符串输入类型包含文本。
整数输入类型包含整数。
自定义主题文件示例
{ "version": "1.0.0",
"base-theme": "smooth",
"styles": {
"all": {
"font-color": "#d16302",
"font-family": "Tableau Bold"
},
"worksheet": {
"font-color": "#d16302",
"font-family": "Tableau Bold",
"font-size": 14
},
"worksheet-title": {
"font-color": "#d16302",
"font-family": "Tableau Bold",
"font-size": 14
},
"view": {
"background-color": "#ffb370"
}
}
}
自定义主题支持的样式元素
此表包含受支持的样式元素及其对应受支持的样式属性的列表。尽管目前 Tableau 中并非所有样式元素都支持自定义主题,但我们将在未来的版本中添加更多样式元素。当您导入自定义主题文件时,其样式元素将应用于工作簿中的所有工作表。
| 样式元素 | 描述 | 样式属性 | 输入类型 | 格式设置选择 |
|---|---|---|---|---|
| all | 设置整个工作簿的所有字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| worksheet | 设置工作表默认字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| worksheet-title | 设置工作表标题字体的格式 。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| tooltip | 设置工具提示字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| dashboard-title | 设置仪表板标题的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| font-weight | 字符串 | 指定为 normal或 bold 的字符串。 | ||
| story-title | 设置故事标题字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| header | 设置标题字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| legend | 设置图例正文字体和背景颜色的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| background-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。此元素还支持两个附加数字以实现透明度,例如 #FF000080。 | ||
| legend-title | 设置所有工作表上的图例标题字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| filter | 设置所有工作表上的筛选器正文字体和背景颜色的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| background-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。此元素还支持两个附加数字以实现透明度,例如 #FF000080。 | ||
| filter-title | 设置所有工作表上的筛选器标题字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| parameter-ctrl | 设置所有工作表上的参数正文字体和背景颜色的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| background-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。此元素还支持两个附加数字以实现透明度,例如 #FF000080。 | ||
| parameter-ctrl-title | 设置所有工作表上的参数控件标题字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| highlighter | 设置所有工作表上的荧光笔正文字体和背景颜色的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| background-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。此元素还支持两个附加数字以实现透明度,例如 #FF000080。 | ||
| Highlighter-title | 设置所有工作表上的荧光笔控件标题字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| font-size | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| page-ctrl-title | 设置所有工作表上的页面卡标题字体的格式。 | font-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| font-family | 字符串 | 最大长度为 50 个字符的字符串。 | ||
| gridline | 设置视图上的网格线的格式。 | line-visibility | 字符串 | 指定为 on 或 off.的字符串。 |
| line-pattern | 字符串 | 指定为 dotted、dashed 或 solid 的字符串。 | ||
| line-width | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| line-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。此元素还支持两个附加数字以实现透明度,例如 #FF000080。 | ||
| zeroline | 设置视图上的零线的格式。 | line-visibility | 字符串 | 指定为 on 或 off.的字符串。 |
| line-pattern | 字符串 | 指定为 dotted、dashed 或 solid 的字符串。 | ||
| line-width | 整数 | 最小值为 1,最大值为 99 的整数。 | ||
| line-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。此元素还支持两个附加数字以实现透明度,例如 #FF000080。 | ||
| mark | 设置视图上的标记颜色的格式。 | mark-color | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
| view | 设置视图的背景颜色的格式。 | 字符串 | 遵循十六进制颜色代码格式的字符串,例如 #FF0000。 |
导入自定义主题文件时出现问题
我的一些样式元素没有被应用
仅当字体随 Tableau 安装或字体存在于您的环境中时,才会显示字体。
如果您通过富文本编辑器而不是通过格式设置窗格应用了格式设置更新,则如果您在应用自定义主题时选择覆盖现有格式设置,则格式设置将保留。发生这种情况是因为样式系统格式设置。
无法导入主题文件
错误消息将告诉您错误的位置(例如,字体颜色)。在样式元素表中找到样式元素,并确保样式元素中的输入符合输入类型指南。例如,颜色是字符串数据类型,必须遵循十六进制颜色代码的格式,例如 #FF0000。
有许多第三方资源可以帮助您验证主题文件,例如 https://www.jsonschemavalidator.net。
在此处复制验证主题文件所需的 JSON 架构文件。
允许的最大文件大小为 15000 字节(或 15 KB)。请减少文件大小,然后重试。
文件路径的长度不能超过 256 个字符。减少文件路径的长度并重试。
文件名只能包含字母数字字符、点、破折号、空格和下划线。移除文件名中的所有无效字符,然后重试。
