المكوّنات · قائمة بسحب للتحديث
قائمة بسحب للتحديث
مقاومة متزايدة، وعتبة تُطلق التحديث، ودوران يعلن الحالة
7 تصاميم من هذه العائلة
<div class="ap aplp"><div class="ph">
<div class="sb"><span class="tm num"></span>
<span class="r" aria-hidden="true"><span>▲</span><span>◗</span><span class="bt num"></span></span></div>
<div class="scr">
<div class="pull"><span class="sp" aria-hidden="true"></span>
<span class="msg" role="status" aria-live="polite"></span></div>
<div class="body"><ul class="ml"></ul></div>
</div>
<div class="safe"></div>
</div></div>
/* pt-scoped */
/* applist-pull — تطبيق بريد */
.aplp{width:100%;height:100%;display:flex;align-items:center;
justify-content:center;padding:6px;font-size:10px;color:var(--pt-text-secondary);
overflow:hidden}
.aplp .ph{position:relative;width:198px;height:100%;max-height:224px;display:flex;
flex-direction:column;overflow:hidden;background:var(--pt-bg-base);
border:1px solid var(--pt-border-default);border-radius:20px;
box-shadow:var(--pt-shadow-3)}
/* شريط الحالة — ليس تزيينًا: يثبت أعلى الشاشة فلا يبدأ المحتوى عند الحافّة */
.aplp .sb{flex:none;display:flex;align-items:center;justify-content:space-between;
padding:5px 12px 2px;font-size:7px;color:var(--pt-text-muted);
font-variant-numeric:tabular-nums}
.aplp .sb .r{display:flex;gap:3px}
.aplp .scr{flex:1;min-height:0;display:flex;flex-direction:column;overflow:hidden}
.aplp .body{flex:1;min-height:0;overflow-y:auto;overflow-x:hidden;
-webkit-overflow-scrolling:touch}
.aplp .body::-webkit-scrollbar{width:0}
/* المنطقة الآمنة السفلية — شريط الإيماءات يأكل ما تحته */
.aplp .safe{flex:none;height:9px;display:grid;place-items:center}
.aplp .safe::after{content:'';width:52px;height:3px;border-radius:99px;
background:var(--pt-border-strong)}
.aplp h6{margin:0;font-size:10px;color:var(--pt-text-primary);font-weight:600;line-height:1.4}
.aplp p{margin:0;font-size:8px;color:var(--pt-text-muted);line-height:1.65}
.aplp .num{font-variant-numeric:tabular-nums}
.aplp button{font:inherit;cursor:pointer;
transition:background 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)}
.aplp button:focus-visible, .aplp a:focus-visible, .aplp input:focus-visible{
outline:2px solid var(--pt-focus-ring);outline-offset:-1px}
/* هدف اللمس: 44 بكسلًا على الشاشات اللمسية، ومساحة نقر ممتدّة على غيرها */
@media(pointer:coarse){.aplp .tap{min-width:44px;min-height:44px}
}
.aplp .tap{position:relative}
.aplp .tap::before{content:'';position:absolute;inset:-6px}
@media(prefers-reduced-motion:reduce){.aplp *{transition:none!important;animation:none!important}
}
.aplp .scr{position:relative}
.aplp .pull{position:absolute;inset-inline:0;inset-block-start:0;height:38px;z-index:1;
display:flex;flex-direction:column;align-items:center;justify-content:center;gap:2px;
font-size:7px;color:var(--pt-text-muted)}
.aplp .sp{width:13px;height:13px;border-radius:50%;
border:2px solid var(--pt-border-strong);border-top-color:var(--pt-accent)}
.aplp.busy .sp{animation:aplpSpin .7s linear infinite}
@keyframes aplpSpin{to{transform:rotate(360deg)}}
@media(prefers-reduced-motion:reduce){.aplp.busy .sp{animation:none}
}
.aplp .body{position:relative;z-index:2;background:var(--pt-bg-base);
transition:transform var(--pt-motion-duration-normal) var(--pt-motion-easing-emphasized)}
.aplp .body.free{transition:none}
.aplp .ml{list-style:none;margin:0;padding:0}
.aplp .ml li{display:flex;gap:8px;align-items:flex-start;padding:7px 12px;
border-bottom:1px solid var(--pt-border-subtle)}
.aplp .ml .dt{flex:none;width:6px;height:6px;border-radius:50%;margin-top:4px;
background:var(--pt-accent)}
.aplp .ml li.read .dt{background:transparent}
.aplp .ml .f{font-size:8.5px;color:var(--pt-text-primary);font-weight:600}
.aplp .ml li.read .f{font-weight:400;color:var(--pt-text-secondary)}
.aplp .ml .s{font-size:7.5px;color:var(--pt-text-muted)}
.aplp .ml .tm4{flex:none;font-size:6.5px;color:var(--pt-text-muted);
font-variant-numeric:tabular-nums}
/* يعمل داخل إطار معزول — لا يعتمد على شيء خارجه */
/* pt-remount — يعاد التركيب عند تبديل اللغة */
(function () {
var host = document.querySelector('.aplp');
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, d) { return Number(v).toLocaleString('en-US', {
minimumFractionDigits: d || 0, maximumFractionDigits: d || 0 }); };
var money = function (usd, d) {
return ar ? n(usd * 3.75, d) + ' ر.س' : '$' + n(usd, d);
};
var set = function (sel, txt) {
var el = root.querySelector(sel); if (el) el.textContent = txt; return el;
};
/* الساعة بأرقام لاتينية دائمًا — قرار موحّد في المشروع كلّه */
(function clock() {
var t = root.querySelector('.tm');
if (!t) return;
function tick() {
var d = new Date();
t.textContent = String(d.getHours()).padStart(2, '0') + ':' +
String(d.getMinutes()).padStart(2, '0');
setTimeout(tick, 20000);
}
tick();
})();
var bt = root.querySelector('.bt');
if (bt) bt.textContent = '84%';
/* اهتزاز خفيف حيث يوجد — تأكيد لمسيّ لا يعتمد عليه شيء */
var buzz = function (ms) { try { if (navigator.vibrate) navigator.vibrate(ms || 8); } catch (e) {} };
var MAIL = [
{ f: 'فريق المنتج', s: 'ملاحظات مراجعة التصميم', t: '09:41', r: false },
{ f: 'المصرف', s: 'إشعار عملية شراء', t: '08:12', r: true },
{ f: 'نورة العتيبي', s: 'اجتماع الأحد التاسعة', t: 'أمس', r: false },
{ f: 'بوّابة التوظيف', s: 'تحديث على طلبك', t: 'أمس', r: true },
{ f: 'الدعم الفنّي', s: 'تمّ حلّ التذكرة', t: 'الأحد', r: true }
];
var body = root.querySelector('.body'), ul = root.querySelector('.ml');
var msg = root.querySelector('.msg');
var newCount = 0;
function draw() {
ul.innerHTML = MAIL.map(function (m) {
return '<li class="' + (m.r ? 'read' : '') + '"><span class="dt"></span>' +
'<span style="flex:1;min-width:0"><span class="f">' + m.f + '</span><br>' +
'<span class="s">' + m.s + '</span></span><span class="tm4">' + m.t + '</span></li>';
}).join('');
}
draw();
var THRESH = 34, MAX = 58;
var y0 = 0, dy = 0, pulling = false, busy = false;
body.addEventListener('pointerdown', function (e) {
// لا يبدأ إلّا من رأس القائمة: التحديث من منتصفها يسرق موضع القراءة
if (busy || body.scrollTop > 0) return;
pulling = true; y0 = e.clientY; body.classList.add('free');
});
body.addEventListener('pointermove', function (e) {
if (!pulling) return;
var raw = e.clientY - y0;
if (raw <= 0) { dy = 0; body.style.transform = ''; return; }
/* مقاومة متزايدة بعد العتبة: السحب يبدو محدودًا لا لانهائيًّا */
dy = raw < THRESH ? raw : THRESH + (raw - THRESH) * 0.32;
dy = Math.min(MAX, dy);
body.style.transform = 'translateY(' + dy + 'px)';
msg.textContent = dy >= THRESH ? (ar ? 'أفلت للتحديث' : 'Release to refresh')
: (ar ? 'اسحب للتحديث' : 'Pull to refresh');
});
['pointerup', 'pointercancel'].forEach(function (ev) {
body.addEventListener(ev, function () {
if (!pulling) return;
pulling = false; body.classList.remove('free');
if (dy < THRESH) { body.style.transform = ''; msg.textContent = ''; return; }
busy = true;
root.classList.add('busy');
body.style.transform = 'translateY(' + THRESH + 'px)';
msg.textContent = ar ? 'جارٍ التحديث…' : 'Refreshing…';
buzz();
setTimeout(function () {
newCount++;
MAIL.unshift({ f: 'رسالة جديدة ' + newCount, s: 'وصلت الآن', t: 'الآن', r: false });
draw();
busy = false; root.classList.remove('busy');
body.style.transform = '';
msg.textContent = ar ? 'وصلت رسالة واحدة' : '1 new message';
setTimeout(function () { msg.textContent = ''; }, 1400);
}, 1200);
});
});
}
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(); });
})();
# Pull-to-Refresh List
**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:** Pull-to-Refresh List — Increasing resistance, a release threshold, and a spinner that announces state
**Why this component matters:** Add resistance past the threshold so the pull feels bounded, and only trigger at scrollTop zero — starting a refresh from mid-list steals the user’s reading position.
**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.