---
title: التخصيص
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/web/web-sdk/customization
locale: ar
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 البرتغالية كلغة افتراضية.
:::

راجع [مرجع API > التعدادات](/dual-api/developers/sdks-and-tools/web/web-sdk/api-reference/enums) للاطلاع على القائمة الكاملة لقيم `LocaleTypes` المدعومة.

## المظهر

خصّص إطار الالتقاط باستخدام `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`. إذا كنت بحاجة إلى واجهة مستخدم مملوكة بالكامل، راجع خيار [معيار الالتقاط](/developers/sdks-and-tools/capture-standard) (التكامل عبر API بدون واجهة).
:::