您可以在管理控制台面板的平台部分中的主题页面上定义主题。您可以使用自定义主题为嵌入式信息中心、Look 和探索自定义字体系列、文本颜色、背景颜色、按钮颜色、图块颜色和其他视觉元素，以及嵌入式信息中心和对话式分析界面中图块的修改窗口。
本页面介绍以下内容：
- 使用嵌入式主题的实例要求
- 主题页面简介
- Looker 默认主题
- 如何将主题应用于嵌入式信息中心和探索
- 如何创建、复制、修改和删除自定义主题
- 如何为信息中心和探索设置默认主题
- 如何将默认主题以外的主题应用于所选信息中心和探索
- 如何应用
_theme网址参数来选择信息中心主题元素
如需了解如何为信息中心和探索设置默认主题，或如何将主题应用于特定信息中心或探索，请参阅嵌入使用入门 - 应用自定义主题文档页面。
使用嵌入式主题的实例要求
请注意，在 Looker 实例上管理嵌入式主题时，需要满足以下要求：
- 如果您的实例是 Looker（原始版本）实例，则必须由 Looker 启用相应功能，您才能为嵌入式信息中心、Look 和探索自定义主题。请与 Google Cloud 销售专家联系，更新您的许可，以便使用此功能。
- 如果您的实例是 Looker (Google Cloud Core) 实例，则嵌入式主题适用于企业版和嵌入式 版本，但不适用于标准版。
- Looker 用户必须具有管理员角色或包含
manage_themes权限的角色。
主题页面简介
您可以在管理控制台面板的平台部分中的主题页面上管理实例的主题。
如果您的实例启用了内部信息中心主题 预览版功能，主题页面会显示内部和嵌入式标签页，分别用于管理 Looker 信息中心和嵌入式内容的主题。
默认主题
Looker 默认主题会在您的实例上自动创建，无法删除或修改。除非 Looker 管理员指定其他主题作为默认主题，否则 Looker 主题将用作默认主题。
Looker 主题设置分为以下几个部分，您可以通过选择主题旁边的查看按钮或创建主题副本来查看这些设置：
主题
| 设置名称 | 值 |
|---|---|
| 名称 | Looker |
常规
本部分的设置适用于嵌入式信息中心、嵌入式探索和对话式分析界面。
| 设置名称 | 值 | 备注 |
|---|---|---|
| 按键颜色 | #1A73E8 |
信息中心会为主要按钮和过滤器控件使用此颜色。探索会为主要按钮、横幅和强调内容使用此颜色。 |
| 文本颜色 | #3e3f40 |
|
| 背景颜色 | #f6f8fa |
|
| 字体系列 | Roboto, Noto Sans JP, Noto Sans CJK KR, Noto Sans Arabic UI, Noto Sans Devanagari UI, Noto Sans Hebrew, Noto Sans Thai UI, Helvetica, Arial, sans-serif | 这些字体由 Looker 应用提供，建议使用这些字体，因为它们既可在浏览器中使用，也可在呈现图片时使用。Looker 会使用字体系列列表中支持某个字符的第一个字体，因此应首先列出优先级较高或专用字体。Looker 会使用字体的“UI”变体（如有），以便对字符进行细微修改，使其更好地适应视觉组件的边界。 |
| 字体来源 | 无 |
信息中心页面
| 设置名称 | 值 |
|---|---|
| 颜色集合 | 无 |
| 标题字号 | None |
| 上外边距 | None |
| 下外边距 | None |
| 左右外边距 | None |
信息中心板块
| 设置名称 | 值 |
|---|---|
| 标题颜色 | #3a4245 |
| 文本颜色 | #3a4245 |
| 文本正文颜色 | 无 |
| 背景颜色 | #ffffff |
| 文本背景颜色 | None |
| 标题对齐 | 居中 |
| 标题字号 | 无 |
| 方框阴影 | 无 |
| 列间距大小 | 无 |
| 行间距大小 | 无 |
| 边框半径 | 无 |
信息中心控件
| 设置名称 | 值 |
|---|---|
| 显示信息中心标题 | 是 |
| 显示信息中心标题 | 是 |
| 将信息中心标题居中 | 否 |
| 显示过滤器栏 | 是 |
| 显示过滤器切换开关 | 是 |
探索页面
| 设置名称 | 值 |
|---|---|
| 显示标题 | 是 |
| 显示标题 | 是 |
| 显示上次运行时间 | 是 |
| 显示时区 | 是 |
| 显示“运行”按钮 | 是 |
| 显示设置按钮 | 是 |
| 显示信息中心上次更新时间指示图标 | 是 |
| 显示重新加载数据图标 | 是 |
| 显示更多选项按钮 | 是 |
Look 页面
| 设置名称 | 值 |
|---|---|
| 显示标题 | 是 |
| 显示标题 | 是 |
| 显示上次运行时间 | 是 |
| 显示时区 | 是 |
| 显示“运行”按钮 | 是 |
| 显示设置按钮 | 是 |
以下是信息中心、信息中心图块的修改窗口以及采用 Looker 主题的“探索”的示例。
采用 Looker 主题的信息中心示例
采用 Looker 主题的信息中心图块修改窗口示例
采用 Looker 主题的“探索”页面示例
如何应用主题和嵌入设置
您可以使用自定义主题和网址参数，更改嵌入式信息中心或探索的默认主题外观。显示嵌入式信息中心或探索时，Looker 会按以下顺序应用设置：
- 从默认主题的设置开始
- 应用网址的
theme参数中指定的自定义主题（如果有）中的设置 - 应用
_theme网址参数中指定的属性（如果有，仅适用于信息中心）
每个项都会覆盖之前的项，这意味着嵌入设置会覆盖默认主题设置，而自定义主题会覆盖嵌入设置和默认主题。
不过，对于 _theme 网址参数，只有 _theme 参数中指定的元素会覆盖其他主题或嵌入设置中的元素。其余自定义主题设置和嵌入设置仍将使用。例如，如果您在嵌入式信息中心的网址中添加 _theme={"show_filters_bar":false} 实参，则即使您已在嵌入设置或自定义主题中开启显示过滤条件，系统也不会显示过滤条件栏。但系统仍会使用自定义主题或嵌入设置中的其他设置。
下载的信息中心会显示所有已应用的自定义主题。
创建自定义主题
如需为嵌入式信息中心、Look 和探索创建自定义主题，请在主题管理页面中选择嵌入标签页，然后点击添加主题。
接下来，在新主题页面上，为您要自定义的每项设置添加样式和颜色规范。
除了主题标题（必须是唯一的）之外，所有字段都会自动填充默认主题中的值。您可以更改任何设置，这些设置将在以下部分中进行介绍。选择保存主题，以保留更改并保存新主题。
主题
名称：主题名称必须是唯一的，并且只能包含字母数字字符和下划线。如果您在主题名称中输入空格，则在保存主题时，空格将被替换为下划线。
常规
本部分的设置同时适用于嵌入式信息中心和嵌入式探索。
主色：信息中心会为主要按钮和过滤器控件使用此颜色。探索会为字段选择器链接和图标、主要按钮、横幅和强调内容使用此颜色。
文字颜色：探索和信息中心内文字的十六进制颜色代码。
背景颜色：探索和信息中心页面背景的十六进制颜色代码。
字体系列：字体系列的名称。此字体将用于信息中心内的所有文本，包括可视化图表中的图块标题、文本图块和图例。此字体也将用于“探索”中的所有文本。如果字体名称中包含空格，请用英文引号将名称引起来，例如“Open Sans”。
- 如果您使用的是常见的网页安全字体，只需在字体系列字段中输入字体名称，并将字体来源字段留空即可。如果您想使用不太常见的字体，请在字体系列字段中输入字体名称，然后使用字体来源字段（下文有相关说明）提供您想使用的字体定义的网址。
字体来源：除非您想使用自定义字体（即非常见网页安全字体），否则请将此字段留空。Font Source 必须是完整的网址，以 https 开头，并指向 @font-face 的 src 实参中指定的 url 值。我们建议使用 Web 开放字体格式 (.woff) 文件，因为 Internet Explorer 11 不支持 .woff2 文件。
- 例如，对于 PT Sans Narrow，您可以在字体系列字段中输入“PT Sans Narrow”，然后在字体来源字段中输入
https://fonts.gstatic.com/s/ptsansnarrow/v7/UyYrYy3ltEffJV9QueSi4RdbPw3QSf9R-kE0EsQUn2A.woff。
采用自定义主题的嵌入式“探索”示例
以下示例展示了具有自定义主题的嵌入式探索。主色设置为 #e82042，字体系列设置为 Verdana。
在嵌入式设置中运行“探索”时，“探索”中的文本会以指定的字体系列字体 Verdana 显示。强调色、按钮和链接会以指定的主色 #e82042 显示：
运行探索后，运行按钮的轮廓和文本会以指定的主色 #e82042 显示：
具有自定义主题的嵌入式信息中心图块修改窗口示例
除了上一部分中所述的“探索”元素之外，当您修改信息中心图块时，横幅会以主色设置 (#e82042) 中指定的色调和字体系列设置 (Verdana) 中指定的字体显示：
信息中心页面
颜色集合：您可以选择颜色集合，这是一组相互协调、搭配效果良好的调色板。为信息中心分配颜色集合后，信息中心所有图块中的所有数据系列都会根据集合中的调色板进行着色，从而确保数据系列的颜色在整个信息中心内协调一致。
背景颜色：信息中心背景和文本图块背景的十六进制颜色代码。
上外边距：可选择为信息中心顶部的外边距设置特定值。从下拉菜单中的预定义选项中进行选择。边距以像素 (px) 为单位。
下外边距：可选择为信息中心底部的外边距设置特定值。从下拉菜单中的预定义选项中进行选择。边距以像素 (px) 为单位。
左右外边距：您可以选择为信息中心的左右外边距设置特定值。从下拉菜单中的预定义选项中进行选择。边距以像素 (px) 为单位。
信息中心板块
标题颜色：以下元素的十六进制颜色代码：
- 信息中心标题
- 信息中心板块的标题
- Markdown 标题和 1 级标题文本
- KPI（单值）可视化图表和单值（旧版）可视化图表的文本颜色
文字颜色：以下元素的十六进制颜色代码：
- 信息中心内的文字，包括可视化图表中的图例
- Markdown 图块的字幕和正文（1 级标题文本除外）
- 文本图块上的 1 级标题、2 级标题和普通文本
- KPI（单值）可视化图表和单值（旧版）可视化图表中的图块图标
正文颜色：以下元素的十六进制颜色代码：
背景颜色：除文本图块外，所有图块背景的十六进制颜色代码。（文本图块使用与信息中心相同的背景颜色，该颜色在信息中心页面部分中使用背景颜色进行设置。）
标题对齐方式：将图块标题设置为左对齐、右对齐或居中对齐。
标题字号：您可以选择从一组预定义的字号（以像素为单位）中调整信息中心图块的字号。
Box Shadow：使用 CSS 语法在信息中心图块周围创建阴影。您可以从预定义的框阴影中进行选择，也可以创建自定义框阴影。如需创建自定义方框阴影，请输入所需的 horizontal-offset vertical-offset blur-radius spread-radius color ，然后选择输入自定义样式以应用设置。右侧会显示盒阴影设置的预览。
列间距大小：您可以根据需要，从一组预定义的像素大小中选择一个，以调整信息中心功能块列之间的间距大小。
行间距大小：您可以根据需要，从一组预定义的像素大小中选择一个，调整信息中心功能块行之间的间距大小。
边框半径：可选择调整信息中心图块的边框半径，以创建方形或圆角。
信息中心控件
显示信息中心标题：停用此选项可隐藏整个信息中心标题，包括所有信息中心过滤条件和控件。停用此选项后，所有其他信息中心控件选项都会被取消选择并停用。
显示信息中心标题：选中此复选框可显示信息中心的标题。
将信息中心标题居中：选中此复选框，即可在信息中心内居中显示信息中心标题。如果未启用此选项，信息中心标题会左对齐。只有在显示信息中心标题选项已启用的情况下，此选项才可用。
显示过滤条件栏：选中此复选框可在信息中心顶部显示过滤条件栏。如果未选中此选项，则显示过滤条件切换开关选项会被取消选中并停用，从而隐藏信息中心过滤条件图标。
显示过滤条件切换开关：选中该复选框可显示信息中心过滤条件图标。
显示信息中心上次更新时间指示图标：选中此复选框可显示信息中心上次更新时间指示图标。
显示重新加载数据图标：选中此复选框可显示信息中心重新加载数据图标。
显示“更多选项”按钮：选中此复选框可显示三点状信息中心菜单。清除此选项后，信息中心菜单选项将不可用。
探索页面
在自定义主题中，您可以调整嵌入式“探索”页面上的以下元素：
显示标题：停用此选项可隐藏嵌入式“探索”的整个标题，包括标题、上次运行指示器、数据时区、运行按钮和探索操作齿轮菜单。
显示标题：停用此选项可隐藏嵌入式“探索”的标题。
显示上次运行时间：停用此选项可隐藏探索的运行时间。
显示时区：停用此选项可在嵌入式探索中隐藏数据的时区。
显示“运行”按钮：停用此选项可隐藏嵌入式探索中的运行按钮。
显示操作按钮：停用此选项可在嵌入式“探索”中隐藏“探索”操作齿轮菜单。
Look 页面
在自定义主题背景中，您可以调整嵌入式 Look 的以下元素：
显示标题：停用此选项可隐藏嵌入式 Look 的整个标题，包括标题、上次运行指示器、数据时区、运行按钮和探索操作齿轮菜单。
显示标题：停用此选项可隐藏嵌入式 Look 的标题。
显示上次运行时间：停用此选项可隐藏 Look 的运行时间。
显示时区：停用此选项可隐藏嵌入式 Look 中数据的时区。
显示“运行”按钮：停用此选项可隐藏嵌入式 Look 上的“运行”按钮。停用在嵌入式 Look 中显示过滤条件后，此切换开关将不会显示运行按钮。
显示操作按钮：停用此选项可隐藏嵌入式 Look 上的“探索”操作齿轮菜单。
复制主题
您可以复制现有主题，方法是选择该主题的菜单，然后选择复制主题。
复制主题时，新主题的名称默认为所复制主题的名称，后跟“（副本）”。请务必手动将此名称更改为仅包含字母数字字符和下划线的新唯一名称，并务必移除括号。
您可以像创建新主题时那样修改其余设置。如需了解这些设置，请参阅前面介绍的主题设置。请务必选择保存，以保留所有主题设置。
修改主题
Looker 主题会在您的实例上自动创建，且无法修改。（如果您想修改 Looker 主题，可以创建该主题的副本，然后修改副本。）
对于所有其他主题，您可以选择关联的修改按钮来更新主题设置。
您可以像创建新主题时那样修改设置。如需了解这些设置，请参阅前面介绍的主题设置。请务必选择保存，以保留更新。
删除主题
您可以删除除 Looker 主题或设为默认的主题之外的任何主题。如需删除某个主题，请选择该主题的菜单，然后选择删除主题。
删除主题后，任何在网址中指定了该主题的嵌入式信息中心都将使用默认主题。
为嵌入式信息中心和探索设置默认主题
嵌入式 Look 不支持自定义主题。自定义主题仅适用于嵌入式信息中心和嵌入式探索。
如需为实例上的嵌入式信息中心和探索指定默认主题，请选择相应主题的菜单，然后选择设为默认。
默认主题用于 Looker 实例上的嵌入式信息中心和探索，除非您为单个信息中心或探索指定了不同的设置。如需详细了解如何将主题和嵌入设置应用于嵌入式信息中心或探索，请参阅本页面上的如何应用主题和嵌入设置部分。
将主题应用于特定嵌入式信息中心和探索
嵌入式 Look 不支持自定义主题。自定义主题仅适用于嵌入式信息中心和嵌入式探索。
如果您希望信息中心或“探索”使用默认主题以外的主题，可以在嵌入式信息中心或“探索”的网址中指定其他主题。为此，请将参数 theme= 以及主题名称添加到嵌入网址的末尾。例如，如果您有一个名为“Red”的主题，则可以在嵌入式信息中心网址末尾添加 theme=Red：
https://example.cloud.looker.com/embed/dashboards/246?theme=red
对于探索，您需要在嵌入式探索网址末尾添加 theme=Red：
none
https://example.cloud.looker.com/embed/explore/model_name/explore_name?theme=red
网址中的主题元素不区分大小写，因此您可以使用 theme=Red 或 theme=red。
使用 _theme 网址参数应用各个信息中心主题元素
您可以使用 _theme 网址参数为嵌入式信息中心自定义各个主题元素，例如 tile_background_color 和 show_title。
_theme 网址参数的格式如下：
_theme={"<property>":value}
例如，您可以使用 _theme={"show_filters_bar":false} 隐藏嵌入式信息中心的过滤条件栏。完整网址可能如下所示：
https://example.cloud.looker.com/embed/dashboards/236?_theme={"show_filters_bar":false}
使用英文逗号指定多个主题属性：
_theme={"show_title":false,"show_filters_bar":false,"text_tile_text_color":"blue"}
颜色值必须用引号括起来，并且可以用颜色名称或十六进制颜色代码表示。如果使用十六进制代码，请务必使用 # 符号的网址编码版本，即 %23。例如，以下两个网址参数都指定了红色：
_theme={"title_color":"red","text_tile_text_color":"%23FF0000"}
将 _theme 对象用于嵌入式信息中心时，请注意以下事项：
- 在
_theme网址参数中指定的任何元素都会覆盖任何其他主题中该元素的设置。这使得_theme参数成为优化主题或嵌入设置的便捷方式。例如，假设您有一个隐藏了过滤条件栏的自定义主题，但您有一个信息中心，其中显示过滤条件栏会很有意义。您可以为信息中心使用自定义主题，然后在嵌入式信息中心的网址中添加_theme={"show_filters_bar":true}参数，以便在该信息中心内显示过滤条件栏，同时保留所有其他自定义主题设置。如需详细了解如何将主题和嵌入设置应用于嵌入式信息中心，请参阅本页面上的如何应用主题和嵌入设置部分。 - 对于编程脚本，您必须对
_theme参数进行网址编码。 - 以 PDF 格式传送嵌入式信息中心时，系统不会应用
_theme参数。 - 如果您以 PDF 格式下载信息中心，则会应用
_theme参数。