المكوّنات · مفاتيح تبديل
مفاتيح تبديل
الحالة معلنة للقارئ الشاشيّ، والاعتماد بينها محسوب
12 تصاميم من هذه العائلة
<div class="bt btt">
<ul class="sw">
<li><span class="t" data-ar="الإشعارات" data-en="Notifications">الإشعارات</span>
<button role="switch" aria-checked="true" class="master" aria-label="الإشعارات"><i></i></button></li>
<li><span class="t" data-ar="صوت التنبيه" data-en="Alert sound">صوت التنبيه</span>
<button role="switch" aria-checked="true" class="dep" aria-label="صوت التنبيه"><i></i></button></li>
<li><span class="t" data-ar="ملخّص أسبوعي" data-en="Weekly digest">ملخّص أسبوعي</span>
<button role="switch" aria-checked="false" class="dep" aria-label="ملخّص أسبوعي"><i></i></button></li>
</ul>
<p class="note" role="status" aria-live="polite"></p>
</div>
/* pt-scoped */
/* button-toggle — إعدادات تطبيق */
.btt{width:100%;height:100%;display:flex;flex-direction:column;
align-items:center;justify-content:center;gap:9px;padding:10px;
font-size:10px;color:var(--pt-text-secondary);overflow:hidden}
.btt .lbl{font-size:8px;color:var(--pt-text-muted);text-align:center}
.btt button{font:inherit;cursor:pointer;display:inline-flex;align-items:center;
justify-content:center;gap:5px;white-space:nowrap;
transition:background var(--pt-motion-duration-fast) var(--pt-motion-easing-standard),
border-color var(--pt-motion-duration-fast) var(--pt-motion-easing-standard),
color var(--pt-motion-duration-fast) var(--pt-motion-easing-standard),
transform var(--pt-motion-duration-fast) var(--pt-motion-easing-standard),
box-shadow var(--pt-motion-duration-fast) var(--pt-motion-easing-standard)}
.btt button:disabled{cursor:not-allowed}
.btt button:focus-visible{outline:2px solid var(--pt-focus-ring);outline-offset:2px}
/* أي زرّ ينزل بمقدار بكسل عند الضغط — تأكيد لمسيّ قبل وصول الردّ */
.btt button:not(:disabled):active{transform:translateY(1px)}
@media(prefers-reduced-motion:reduce){.btt button{transition:none}
.btt button:not(:disabled):active{transform:none}
}
/* هدف اللمس 44 بكسلًا على الشاشات اللمسية دون تضخيم سطح المكتب */
@media(pointer:coarse){.btt button{min-height:44px;min-width:44px}
}
/* شكل: مفاتيح منزلقة، انحناء كامل، قائمة عمودية */
.btt .sw{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:7px;
min-width:172px}
.btt .sw li{display:flex;align-items:center;justify-content:space-between;gap:12px}
.btt .t{font-size:9.5px;color:var(--pt-text-secondary)}
.btt li.off .t{color:var(--pt-text-muted)}
.btt [role=switch]{position:relative;width:32px;height:18px;padding:0;flex:none;
border-radius:var(--pt-radius-full);border:1px solid var(--pt-border-default);
background:var(--pt-bg-inset)}
.btt [role=switch] i{position:absolute;inset-block-start:2px;inset-inline-start:2px;
width:12px;height:12px;border-radius:50%;background:var(--pt-text-muted);
transition:inset-inline-start var(--pt-motion-duration-fast) var(--pt-motion-easing-emphasized),
background var(--pt-motion-duration-fast) var(--pt-motion-easing-standard)}
.btt [role=switch][aria-checked=true]{background:var(--pt-accent);border-color:var(--pt-accent)}
.btt [role=switch][aria-checked=true] i{inset-inline-start:16px;background:var(--pt-color-ink-900)}
.btt [role=switch]:disabled{opacity:.4;cursor:not-allowed}
@media(prefers-reduced-motion:reduce){.btt [role=switch] i{transition:none}
}
.btt .note{margin:0;min-height:12px;font-size:8px;color:var(--pt-text-muted);text-align:center}
/* يعمل داخل إطار معزول — لا يعتمد على شيء خارجه */
/* pt-remount — يعاد التركيب عند تبديل اللغة */
(function () {
var host = document.querySelector('.btt');
if (!host) return;
var snapshot = host.innerHTML;
var timers = [];
var ac = null;
/* الجسم كما كتبه المولِّد. يستقبل بدائل مظلَّلة لـ root وdocument
والمؤقّتات، فينظّف نفسه دون أن يعرف أنه قابل لإعادة التركيب. */
function run(root, document, setTimeout, setInterval) {
var ar = document.documentElement.lang !== 'en';
var n = function (v) { return Number(v).toLocaleString('en-US'); };
var master = root.querySelector('.master');
var deps = [].slice.call(root.querySelectorAll('.dep'));
var note = root.querySelector('.note');
function flip(b) {
var on = b.getAttribute('aria-checked') === 'true';
b.setAttribute('aria-checked', String(!on));
return !on;
}
function sync() {
/* التابع يُعطَّل ويُشرح سبب تعطيله — لا يُترك ظاهرًا وهو لا يفعل شيئًا */
var on = master.getAttribute('aria-checked') === 'true';
deps.forEach(function (d) {
d.disabled = !on;
d.closest('li').classList.toggle('off', !on);
});
note.textContent = on ? '' : (ar ? 'أوقِف الإشعارات يوقف ما تحته'
: 'Turning notifications off disables the rest');
}
master.addEventListener('click', function () { flip(master); sync(); });
deps.forEach(function (d) {
d.addEventListener('click', function () { if (!d.disabled) flip(d); });
});
sync();
}
function mount() {
ac = new AbortController();
var real = window.document;
/* وسيط يمرّر كل شيء إلى المستند الحقيقي، ويعلّق كل مستمع بإشارة
تُقطع عند إعادة التركيب — فلا يبقى مستمع من نسخة ماتت. */
var doc = new Proxy(real, {
get: function (t, k) {
if (k === 'addEventListener') {
return function (type, fn, opts) {
var o = (opts && typeof opts === 'object') ? Object.assign({}, opts)
: { capture: !!opts };
o.signal = ac.signal;
return t.addEventListener(type, fn, o);
};
}
var v = t[k];
return typeof v === 'function' ? v.bind(t) : v;
}
});
function track(fn) {
return function (f, ms) { var id = fn(f, ms); timers.push(id); return id; };
}
run(host, doc, track(window.setTimeout.bind(window)),
track(window.setInterval.bind(window)));
}
function unmount() {
if (ac) ac.abort();
// المعرّفان يتشاركان فضاءً واحدًا في المتصفّح، فالإلغاء المزدوج آمن
timers.forEach(function (id) { window.clearTimeout(id); window.clearInterval(id); });
timers = [];
host.innerHTML = snapshot;
}
mount();
addEventListener('pt-lang', function () { unmount(); mount(); });
})();
# Toggle Switches
**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:** Toggle Switches — State announced to screen readers, with computed dependency between switches
**Why this component matters:** A switch needs role="switch" and aria-checked, not colour alone. And when one option depends on another, disable the dependant and say why — do not let it sit enabled but inert.
**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.