---
title: 自定义
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/web/web-sdk/customization
locale: zh-CN
generated_by: markdown-export
---

Web SDK 支持两个维度的自定义：语言和视觉主题。

## 语言

通过 `setLocale` 方法配置采集框中信息提示的语言。使用 `LocaleTypes` 枚举：

- `LocaleTypes.PT_BR` — 葡萄牙语（巴西）
- `LocaleTypes.ES_MX` — 西班牙语（墨西哥）
- `LocaleTypes.ES_ES` — 西班牙语（西班牙）
- `LocaleTypes.EN_US` — 英语（美国）

```javascript
import {
  UnicoCheckBuilder,
  LocaleTypes
} from "unico-webframe"

unicoCameraBuilder.setLocale(LocaleTypes.EN_US);
```

:::info
- 使用此功能可能需要远程激活。如需使用，请通知您的项目经理或 Unico 支持团队。
- 如未配置，SDK 默认使用葡萄牙语。
:::

有关支持的 `LocaleTypes` 值的完整列表，请参阅 [API 参考 > 枚举](/dual-api/developers/sdks-and-tools/web/web-sdk/api-reference/enums)。

## 主题

使用 `UnicoThemeBuilder` 自定义采集框。创建一个实例并调用自定义采集框各属性的方法：

```javascript
const unicoTheme = new UnicoThemeBuilder()
  .setColorSilhouetteSuccess("#0384fc")
  .setBackgroundColor("#dff1f5")
  .setColorText("#0384fc")
  .setBackgroundColorComponents("#0384fc")
  .setColorTextComponents("#dff1f5")
  .setBackgroundColorBoxMessage("#fff")
  .setColorTextBoxMessage("#fff")
  .setBackgroundColorButtons("#0384fc")
  .setColorTextButtons("#dff1f5")
  .setColorCancelButton("#0384fc")
  .setColorProgressBar("#0384fc")
  .setFontFamily("Arial, sans-serif") // v3.19.2+
  .setHtmlPopupLoading(`<div style="position: absolute; top: 45%; right: 50%; transform:
    translate(50%, -50%); z-index: 10; text-align: center;">Loading...</div>`)
  .build();
```

生成主题对象后，将其传递给 `setTheme`：

```javascript
unicoCameraBuilder.setTheme(unicoTheme);
```

:::info[setHtmlPopupLoading]
`setHtmlPopupLoading` 参数专用于文件采集流程。
:::

:::warning[自定义范围]
除 `UnicoThemeBuilder` 提供的内容外，没有其他可用的自定义维度。如需完全自定义的 UI，请参阅 [Capture Standard](/developers/sdks-and-tools/capture-standard) 选项（无头 API 集成）。
:::