المكوّنات · زرّ يحمل تقدّمه
زرّ يحمل تقدّمه
التقدّم داخل الزرّ نفسه، ويمكن إلغاؤه أثناء الرفع
12 تصاميم من هذه العائلة
<div class="bt btr">
<button class="up"><i class="fill" aria-hidden="true"></i>
<span class="tx" data-ar="ارفع الملفّ" data-en="Upload file">ارفع الملفّ</span>
<span class="pc num"></span></button>
<div class="log" role="status" aria-live="polite"></div>
</div>
/* pt-scoped */
/* button-progress — رفع ملفّات */
.btr{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}
.btr .lbl{font-size:8px;color:var(--pt-text-muted);text-align:center}
.btr 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)}
.btr button:disabled{cursor:not-allowed}
.btr button:focus-visible{outline:2px solid var(--pt-focus-ring);outline-offset:2px}
/* أي زرّ ينزل بمقدار بكسل عند الضغط — تأكيد لمسيّ قبل وصول الردّ */
.btr button:not(:disabled):active{transform:translateY(1px)}
@media(prefers-reduced-motion:reduce){.btr button{transition:none}
.btr button:not(:disabled):active{transform:none}
}
/* هدف اللمس 44 بكسلًا على الشاشات اللمسية دون تضخيم سطح المكتب */
@media(pointer:coarse){.btr button{min-height:44px;min-width:44px}
}
/* شكل: مصمت مرتفع، تعبئة خلفية، انحناء متوسّط */
.btr .up{position:relative;overflow:hidden;min-width:168px;padding:10px 16px;border:0;
border-radius:var(--pt-radius-md);background:var(--pt-bg-inset);
border:1px solid var(--pt-border-default);
color:var(--pt-text-primary);font-size:9.5px;font-weight:600;box-shadow:var(--pt-shadow-2)}
.btr .fill{position:absolute;inset-block:0;inset-inline-start:0;width:0;
background:var(--pt-accent-muted)}
.btr .tx, .btr .pc{position:relative;z-index:1}
.btr .pc{font-size:8.5px;color:var(--pt-accent);font-variant-numeric:tabular-nums}
.btr .up.busy{cursor:pointer}
.btr .up.done{border-color:var(--pt-accent);color:var(--pt-accent)}
.btr .log{min-height:14px;font-size:8px;color:var(--pt-text-muted)}
/* يعمل داخل إطار معزول — لا يعتمد على شيء خارجه */
/* pt-remount — يعاد التركيب عند تبديل اللغة */
(function () {
var host = document.querySelector('.btr');
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 up = root.querySelector('.up'), fill = root.querySelector('.fill');
var tx = root.querySelector('.tx'), pc = root.querySelector('.pc'), log = root.querySelector('.log');
var SIZE = 24.8; /* ميغابايت */
var timer = null, p = 0, busy = false;
function reset(msg) {
clearInterval(timer); busy = false; p = 0;
up.classList.remove('busy', 'done');
fill.style.width = '0'; pc.textContent = '';
tx.textContent = ar ? 'ارفع الملفّ' : 'Upload file';
log.textContent = msg || '';
}
up.addEventListener('click', function () {
/* الإلغاء في الزرّ نفسه — إرسال المستخدم يبحث عن زرّ آخر والبيانات
تتحرّك هو سبب هجر عمليات الرفع. */
if (busy) { reset(ar ? 'أُلغي الرفع عند ' + Math.round(p) + '%'
: 'Cancelled at ' + Math.round(p) + '%'); return; }
if (up.classList.contains('done')) { reset(); return; }
busy = true;
up.classList.add('busy');
log.textContent = ar ? 'اضغط مرّة أخرى للإلغاء' : 'Click again to cancel';
timer = setInterval(function () {
p = Math.min(100, p + 4 + Math.round(Math.sin(p / 9) * 2));
fill.style.width = p + '%';
pc.textContent = p + '%';
tx.textContent = ar ? 'جارٍ الرفع' : 'Uploading';
if (p >= 100) {
clearInterval(timer); busy = false;
up.classList.remove('busy'); up.classList.add('done');
tx.textContent = ar ? '✓ اكتمل الرفع' : '✓ Upload complete';
pc.textContent = '';
log.textContent = (ar ? 'حجم الملفّ ' : 'File size ') + SIZE + ' MB';
}
}, 140);
});
}
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(); });
})();
# Progress-in-Button
**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:** Progress-in-Button — Progress lives inside the button, and the upload can be cancelled mid-flight
**Why this component matters:** If an operation can be cancelled, the same control must offer the cancel — sending the user hunting for a separate button while bytes are moving is how uploads get abandoned.
**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.