---
type: how-to
title: 给组件做白标
summary: 用你自己的措辞、颜色和链接替换组件外壳的措辞、颜色和链接，一个在仪表盘里撰写的 Apex 档功能。
---

[游戏自定义](/docs/game-customization/overview) 改变组件里面的游戏。白标改变 **组件外壳**，即每个挑战周围的外饰：它的措辞、它的颜色和品牌标记，以及它品牌条里的链接。你在仪表盘里撰写覆盖，Caputchin 把它们提供给每一次组件挂载，无需改代码、无需 fork。

白标是一个 **Apex 档** 的功能。

## 它住在哪里

打开一个团队，或一个站点密钥，前往它的 **白标** 页（在设置下）。它用和游戏自定义同一个编辑器，但它针对组件外壳、而非某个特定游戏，所以它适用于组件所运行的每一个挑战。

## 三个维度

白标有和一个游戏同样的三个维度，应用到外壳的内置字段集上：

| 维度 | 它控制什么 |
|---|---|
| **语言** | 外壳的字符串：验证标签、品牌字标、状态和关闭标签，以及无障碍标签。 |
| **皮肤** | 外壳的颜色和它的品牌徽标。 |
| **配置** | 品牌条的链接目标：主页链接和法律链接。 |

你只覆盖你想要的那些字段；你原封不动的一切都保持 Caputchin 的默认。

## 范围与默认

白标覆盖以和 [游戏自定义](/docs/game-customization/overview#troop-and-site-key-scope) 同样的方式解析，最具体者胜：一个 **站点密钥** 的预设胜过 **团队** 的基线，团队的基线又胜过 Caputchin 的捆绑默认，逐个值计算。在团队上设一次基线，并逐密钥覆盖例外。每个组（每种语言、亮和暗各一个、那个单一的配置组）有一个默认，你在编辑器里标记它。一个模式为 `any` 的皮肤在两种背景上都工作，显示在亮组和暗组下，并能被设为其中一个或两个的默认。你可以扩展一个捆绑预设、只改你需要的那些字段。同样的字段类型和预设模型驱动两者；见 [模式参考](/docs/references/customization-schema)。

## 它如何传播

保存一个预设会在几秒内在每一个受影响的组件挂载上生效。组件在加载时短暂地等你的覆盖，然后如果拉取很慢就回退到捆绑的外观，于是一个慢网络绝不会让一位访客盯着一个空白组件。

## 外壳交付的语言

组件外壳（每次验证周围的外饰，而非它里面的游戏）为这 11 种语言交付内置的 **语言** 预设，以英语为默认。一位 [浏览器语言](/docs/widget-customization/resolution) 是其中之一的访客会自动看到那种语言的外壳；其他任何人都回退到英语。这是外壳自己的覆盖范围，并独立于一个游戏的语言，后者由每个游戏的作者各自选择。

| 语言 | 标签 |
|---|---|
| 英语（默认） | `en` |
| 中文（简体） | `zh-Hans` |
| 西班牙语 | `es` |
| 阿拉伯语 | `ar` |
| 葡萄牙语 | `pt` |
| 法语 | `fr` |
| 德语 | `de` |
| 俄语 | `ru` |
| 日语 | `ja` |
| 韩语 | `ko` |
| 印尼语 | `id` |

你不配置这些；它们默认开启。两件事替你处理好了：一种从右到左的语言（阿拉伯语）自动把外壳的布局翻转为 `rtl`，而那些 CJK 语言（中文、日语、韩语）用访客的系统字体渲染，两边都无需设置。

要 **更改** 这些里面任何一种的措辞，或 **添加** 一种未列出的语言，就用上面的语言维度：为那个语言标签编辑或创建一个预设，就和你覆盖任何其他外壳字符串一样。

## 另见

- [组件如何解析它的语言和皮肤](/docs/widget-customization/resolution)：一位访客看到哪种语言和皮肤。
- [用 CSS 给组件设样式](/docs/widget-customization/css-parts)：调整白标不覆盖的布局和细节。
- [模式参考](/docs/references/customization-schema)：外壳的内置字段和字段类型。
- [我们的理念](/docs/understanding-caputchin/philosophy)：白标坐落在自定义阶梯的何处，以及只有它能做什么。