شبكة البيانات

جدول بيانات لتطبيقك. حرّر الخلايا وحدّد النطاقات وصفِّ السجلات وتعامل مع آلاف الصفوف مع تثبيت العمود الأول وملخصات مباشرة.

Renewals

Total Results10,000 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

Northwind Freight
Owen Park
Latin America
Closed won
40
$9,600
49%
Lumen Freight
Tyler Hayes
Europe
Closed won
105
$37,800
90%
Cedar Freight
Tyler Hayes
Latin America
Proposal
230
$96,600
64%
Brightline Freight
Marcus Johnson
Asia Pacific
Proposal
115
$41,400
78%
Harbor Freight
Daniel Kim
Latin America
Committed
10
$4,200
72%
Pinecrest Freight
Marcus Johnson
Europe
Closed won
470
$169,200
72%
Atlas Freight
Sarah Bennett
Latin America
Discovery
45
$16,200
95%
Summit Freight
Owen Park
Asia Pacific
Negotiation
255
$107,100
93%
Fieldstone Freight
Marcus Johnson
Europe
Discovery
660
$237,600
82%
Evergreen Freight
Marcus Johnson
Latin America
Negotiation
46
$13,800
56%
Meridian Freight
Owen Park
Asia Pacific
Discovery
119
$42,840
73%
Redwood Freight
Daniel Kim
Europe
Committed
192
$80,640
90%
Westbridge Freight
Tyler Hayes
North America
Proposal
265
$63,600
41%
Sum3.3M
Sum$1.1B
Avg67.5%
A1Count 1

التثبيت

أضف شبكة البيانات المجانية باستخدام 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 لضبط اتجاه القراءة. يثبّت هذا المثال المخصص للقراءة فقط العمود الأول على اليمين ويعكس التنقل الأفقي بلوحة المفاتيح. يمكن أن تستخدم تسميات الأعمدة وقيم السجلات أي لغة.

Total Results2 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

نورث ويند
أوروبا
40
لومن
آسيا
105
Sum145
A1Count 1Read-only