شبكة البيانات
جدول بيانات لتطبيقك. حرّر الخلايا وحدّد النطاقات وصفِّ السجلات وتعامل مع آلاف الصفوف مع تثبيت العمود الأول وملخصات مباشرة.
Renewals
التثبيت
أضف شبكة البيانات المجانية باستخدام CLI الخاص بنا. تتضمن عناصر تحكم BoardUI وأدوات البيانات المساعدة الداخلية التي تستخدمها:
الوضع الداكن جاهز - هذا مكوّن يتبع رموز التصميم الدلالية لـ BoardUI تلقائياً. إعداد تبديل السمة.
تنسخ CLI مصدر المكوّن (مع تبعياته الداخلية) إلى مشروعك وتثبّت أي حزم npm مطلوبة.
npx boardui@latest add data-gridهل تستخدم حزمة واجهة مستخدم مشتركة أو أسماء استيراد مختصرة مخصصة؟ تهيئة مسارات التثبيت قبل تشغيل CLI. تستخدم أمثلة النسخ واللصق الاستيرادات الافتراضية.
الأعمدة والتحرير
مرّر تعريفات ذات أنواع محددة إلى columns، ودالتك data، ومعرّف فريد وثابت getRowId. مرّر onDataChange لتمكين التحرير. يعيد محررو النصوص والأرقام والاختيارات استخدام مدخلات BoardUI وقوائمه. اضبط الحدود باستخدام min و max، أو ارفض القيم باستخدام validate.
استخدام format لعرض الخلايا و formatSummary لتذييلات المجموع أو المتوسط أو العدد. اضبط editable= في أعمدة محددة. يغيّر التنسيق طريقة العرض؛ ويستخدم التحرير والنسخ والتصدير القيم الأصلية.
const columns: DataGridColumn<Account>[] = [ { key: "account", header: "Account", width: 220, validate: (value) => String(value).trim() ? undefined : "Account cannot be empty." }, { key: "stage", header: "Stage", type: "select", options: ["Discovery", "Proposal", "Closed won"] }, { key: "seats", header: "Seats", type: "number", min: 0, summary: "sum" }, { key: "arr", header: "ARR", type: "number", min: 0, editable: false, summary: "sum", formatSummary: (value) => `$${value.toLocaleString("en-US")}` },];
// Omit onDataChange to make every cell read-only.<DataGrid aria-label="Accounts" data={data} columns={columns} getRowId={getRowId} />البحث والتصفية والتصدير
ابحث في جميع الأعمدة، وانقر على عنوان للتبديل بين الترتيب التصاعدي والتنازلي والأصلي، أو صفِّ حسب القيم الدقيقة. تظهر أعمدة الاختيار تلقائيًا في قائمة الفلاتر؛ أضف filterable إلى الأعمدة الأخرى. أخفِ الأعمدة وغيّر حجمها باستخدام الفواصل وبدّل بين الصفوف المريحة والمضغوطة.
يبقى أول عمود مرئي مثبتًا بجانب أرقام الصفوف. في الشاشات الضيقة يتحرك مع الأعمدة الأخرى لتبقى جميع الخلايا قابلة للوصول. تحدّد مربعات الصفوف السجلات بشكل مستقل عن نطاقات الخلايا؛ ويبدّل مربع الرأس جميع الصفوف المصفّاة. يُظهر تحديد الصفوف العدد وإجراءات الحذف والنسخ والتصدير في شريط الأدوات. يستخدم النسخ قيمًا مفصولة بعلامات تبويب؛ وينزّل التصدير ملف CSV، ويستخدم كلاهما الأعمدة المرئية والسجلات المرئية المحددة. يتطلب الحذف onDataChange ويمكن التراجع عنه. امسح التحديد للعودة إلى عناصر البحث والتحكم في العرض. تعكس الملخصات دائمًا السجلات المصفّاة.
لوحة المفاتيح والحافظة
انتقل إلى الشبكة باستخدام Tab واستعمل مفاتيح الأسهم للتنقل بين الخلايا. اضغط Shift لتوسيع النطاق، أو اسحب بالماوس عبر الخلايا. ينتقل Home وEnd عبر الصف؛ أضف ⌘ أو Ctrl للانتقال إلى أول سجل أو آخره. ينتقل Page Up وPage Down بمقدار مساحة عرض. يحدّد ⌘/Ctrl+A جميع الخلايا.
حدّد خلية تحتوي على خيارات لإظهار قائمتها، ثم انقر على السهم لاختيار قيمة. يفتح النقر المزدوج أو Enter أو F2 محرر الخلية. يحفظ Enter وينتقل لأسفل؛ وينتقل Shift+Enter لأعلى. يحفظ Tab وينتقل إلى الخلية التالية. يُلغي Escape التعديل. انسخ نطاقًا والصق بيانات جدول مفصولة بعلامات تبويب باستخدام اختصارات لوحة المفاتيح المعتادة. ترفض القيم غير الصالحة عملية اللصق بالكامل. ينطبق التراجع والإعادة على تعديلات الخلايا واللصق وحذف الصفوف، مع حفظ ما يصل إلى 100 عملية ما دامت الشبكة مركّبة.
امنح كل شبكة aria-label. غلّف المناطق التي تُقرأ من اليمين إلى اليسار باستخدام DirectionProvider؛ تتبع الأعمدة المثبتة والقوائم ومفاتيح الأسهم الأفقية اتجاه القراءة.
10,000 صف في مساحة عرض صغيرة
تحتوي المعاينة أعلاه على 10,000 سجل فعلي. لا يعرض التجسيد الافتراضي ذو الارتفاع الثابت إلا الصفوف داخل مساحة العرض وحولها. يبقى الرأس والملخص خارج الجزء القابل للتمرير؛ ويخفف تمويه تدريجي الحافة العليا أثناء التمرير. اضبط height لتغيير ارتفاع مساحة العرض.
يجري البحث والفرز والتصفية والتلخيص في المتصفح على البيانات المقدمة. يتبع تحديد الخلايا وتحريرها معرّفات الصفوف الثابتة عند انتقال السجلات. احفظ التغييرات في onDataChange معالجًا. أعد تركيب الشبكة باستخدام React key عند الانتقال إلى مجموعة بيانات أخرى لإعادة ضبط حالة العرض وسجل التعديلات.
من اليمين إلى اليسار وللقراءة فقط
استخدام DirectionProvider لضبط اتجاه القراءة. يثبّت هذا المثال المخصص للقراءة فقط العمود الأول على اليمين ويعكس التنقل الأفقي بلوحة المفاتيح. يمكن أن تستخدم تسميات الأعمدة وقيم السجلات أي لغة.