البرومبتات · حقل الهوية والإقامة

حقل الهوية والإقامة

يميّز المواطن عن المقيم من أول رقم، ويتحقّق من رقم التحقّق

الأداة

الإطار

الوضع

اللغة

كيف تستخدمه: انسخه كما هو وألصقه في محادثة جديدة مع الأداة التي اخترتها. لا تختصره — كل بند فيه يمنع خطأً شائعًا، وحذف بند يعيد الخطأ الذي كُتب لأجله.أو خذ الكود جاهزًا ←

← لوحة الموارد البشريةشريط بحساب وإشعارات →

# National ID / Iqama Field

**Role:** You are an Arabic-first UI designer and front-end engineer. Read the whole
specification before writing a single line, then follow it literally. If two requirements
conflict, favour usability over visual effect.

**Goal:** National ID / Iqama Field — Tells citizen from resident by the first digit, and validates the checksum

**Why this component matters:** The first digit identifies the document type; the last is a checksum computed from the preceding nine. Validating in the browser prevents typos that would otherwise surface days later inside government systems.

**Direction:** Genuine RTL — not a mirrored Latin layout. Use logical properties
(`margin-inline-start`, `padding-inline`, `inset-inline-start`, `text-align: start`),
never physical ones (`margin-left`, `left`). The layout must flip with `dir` on its own,
with no duplicated rules.

**Typography:** Cairo for Arabic, IBM Plex Sans for Latin. Arabic line-height must be
`0.18` higher than the Latin equivalent — dots, hamzas and maddas need more vertical room.
Arabic font-size runs `1.06×` the Latin size at the same optical weight.

**Numerals:** Western digits in both languages (`1,234.50`). Only the currency changes:
`ر.س` **after** the number in Arabic, `$` **before** it in English. Jordanian dinar
uses **three** decimal places, not two.

**Colors:** Dark mode — background `#0D142B` · surfaces `#211F54` · borders `#545C91` · text `#918FC2`.
Accent `#ADA9E8` must never exceed 8% of the screen area.

**Language:** Bilingual — every string carries both Arabic and English, and the layout
flips with `dir` automatically.

**States:** `default` · `hover` · `focus` · `active` · `disabled` · `loading` · `error`.
Do not design the resting state alone.

**Accessibility:** Contrast ratio at least `4.5:1`, complete keyboard navigation,
visible focus rings, and honour `prefers-reduced-motion`.

**Output:** Clean HTML and CSS in two separate files. No frameworks, no libraries,
no external dependencies.

**Important:** This component has no equivalent in any global library. Do not imitate a
Latin pattern and translate its labels — build it from Gulf market requirements directly.

## Checksum algorithm

```js
/** Validates a Saudi national ID or Iqama number (10 digits, modified Luhn) */
export function validSaudiId(id) {
  const s = String(id).trim();
  if (!/^[12]\d{9}$/.test(s)) return false;   // starts with 1 or 2, ten digits
  let sum = 0;
  for (let i = 0; i < 9; i++) {
    let d = +s[i];
    if (i % 2 === 0) {                        // double every other digit
      d *= 2;
      if (d > 9) d -= 9;
    }
    sum += d;
  }
  return (10 - (sum % 10)) % 10 === +s[9];
}
```

`validSaudiId('1084215761')` ← `true` · `validSaudiId('1084215762')` ← `false`