انتقل إلى المحتوى
TopClass UI

شريط التقدم

إلى أين وصلت المهمة: مسار محايد عليه شريط بلون النبرة، يقرؤه قارئ الشاشة شريطَ تقدم من 0 إلى 100.

server - 0 KB

شريط التقدم

server - 0 KB

إلى أين وصلت المهمة: مسار محايد عليه شريط بلون النبرة، يقرؤه قارئ الشاشة شريطَ تقدم من 0 إلى 100.

تثبيت

جرّبه

value
tone
size
indeterminate

الشيفرة

progress.tsx
import { Progress } from 'topclassui/progress'

<div className="grid max-w-sm">
  <Progress aria-label="Upload" />
</div>

لا يعرض أي نص ويحصر القيمة بين 0 و100، فسمِّه بـ aria-label أو aria-labelledby.

كل الحالات، بدون تمرير الفأرة

5 حالات
Empty
Part way
Complete
Indeterminate
Tones

أو استورده من الحزمة

topclassui/progress
import { Progress } from 'topclassui/progress'

ثبّت مرة واحدة:npm i topclassui@beta zod

أمثلة

  • لرفع ملف، أو حصة استخدام، أو خطوة في مهمة طويلة. value نسبة مئوية تُحصر بين 0 و100 قبل أن تصل إلى ARIA أو إلى الشريط؛ وللنطاق المخصص استخدم Meter.
  • indeterminate للانتظار مجهول المدة: لا تُعلن أي قيمة، ويومض شريط قصير.
  • size يحدد ارتفاع المسار من سلّم المسافات، فيتبع الكثافة؛ وcustom لا يضع شيئًا ويحدده صنفك.
  • المسار يملأ حاويته. أعطه عرضًا ثابتًا عبر className، كما يفعل الشريط في صف ملف.
labelled
Storage: 7.2 GB of 10 GB
values
Not started
Uploading
Halfway
Almost there
Done
tones
sizes
indeterminate
file-row
brief.pdf
custom-size
بالعربية، من اليمين إلى اليسار
رفع الملف

الخصائص

خصائص Progress
الخاصيةالنوعالافتراضيالحدودالوصف
aria-labelstring--The name read out when no visible text names the bar.
aria-labelledbystring--The id of the visible text that names the bar.
indeterminatebooleanfalse-For a wait of unknown length: no value is announced and a short bar pulses.
sizexs | sm | md | lg | xl | custom"md"-The shared size scale, which sets the track height; custom emits none.
toneprimary | neutral | success | warning | danger | info"primary"-The colour of the bar; the track stays neutral in every tone.
valuenumber, min 0, max 1000min 0, max 100How far along, as a percentage; anything outside 0-100 is clamped.

لوحة المفاتيح وإمكانية الوصول

لا شيء يُشغَّل: ليس تفاعليًا بمفرده.

  • الاسم إلزامي: النوع يرفض شريط تقدم بلا aria-label ولا aria-labelledby.
  • يكتب role="progressbar" بحد أدنى 0 وحد أقصى 100 والقيمة بعد حصرها؛ والشريط غير المحدد لا يحمل أي قيمة.
  • الشريط يأخذ لون نص النبرة، وإطار line-strong يحدد نهاية النطاق. وتحت الألوان القسرية يكون المسار Canvas والشريط CanvasText، وتقليل الحركة يوقف الوميض.

من اليمين إلى اليسار

الشريط ينمو من بداية السطر: من اليمين في العربية، دون صنف خاص بذلك.

الخادم والمتصفح

يُعرض على الخادم ولا يرسل أي JavaScript.

الملفات: index.tsx.

على الشارة: server - 0 KB.