Table
جدول أصلي بمحوّل تفاعلي اختياري.
- المتصفحات
- Chrome 123+Firefox 121+Safari 17.5+
- الفئة
- 0
- الحجم المضغوط
- 617 B
- ميزانية التخطيط القسري
- 0 ms
- ميزانية axe
- 0
- متوافق مع SSR
- نعم
- العقد المنشور
- بيئة الاختبار
المختبر
Table
مثال جدول أصلي
| الاسم | الدور | الحالة |
|---|---|---|
| Alice Chen | مسؤول | نشط |
| Bob Smith | محرّر | نشط |
| Carol Lee | مشاهد | مدعو |
| ثلاثة أعضاء · عضوان نشطان | ||
فرز وترشيح وتوسيع
| الدور | التفاصيل | ||
|---|---|---|---|
| Alice Chen | مسؤول | ||
| alice@example.com · نشط | |||
| Bob Smith | محرّر | ||
| bob@example.com · نشط | |||
| Carol Lee | مشاهد | ||
| carol@example.com · مدعو | |||
| عدد الأعضاء: 3 · عدد المحدّدين: 0 | |||
ترويسات وتذييل وأعمدة ثابتة
| عضو | الدور | البريد الإلكتروني | الحالة |
|---|---|---|---|
| العضو 1 | محرّر | member1@example.com | نشط |
| العضو 2 | محرّر | member2@example.com | نشط |
| العضو 3 | محرّر | member3@example.com | نشط |
| العضو 4 | محرّر | member4@example.com | نشط |
| العضو 5 | محرّر | member5@example.com | نشط |
| العضو 6 | محرّر | member6@example.com | نشط |
| العضو 7 | محرّر | member7@example.com | نشط |
| العضو 8 | محرّر | member8@example.com | نشط |
| العضو 9 | محرّر | member9@example.com | نشط |
| العضو 10 | محرّر | member10@example.com | نشط |
| العضو 11 | محرّر | member11@example.com | نشط |
| العضو 12 | محرّر | member12@example.com | نشط |
| العضو 13 | محرّر | member13@example.com | نشط |
| العضو 14 | محرّر | member14@example.com | نشط |
| العضو 15 | محرّر | member15@example.com | نشط |
| العضو 16 | محرّر | member16@example.com | نشط |
| العضو 17 | محرّر | member17@example.com | نشط |
| العضو 18 | محرّر | member18@example.com | نشط |
| العضو 19 | محرّر | member19@example.com | نشط |
| العضو 20 | محرّر | member20@example.com | نشط |
| العضو 21 | محرّر | member21@example.com | نشط |
| العضو 22 | محرّر | member22@example.com | نشط |
| العضو 23 | محرّر | member23@example.com | نشط |
| العضو 24 | محرّر | member24@example.com | نشط |
| أربعة وعشرون عضوًا | |||
import { Table } from "@gunkin/uiify";
const rows = [
{ id: "alice", name: "Alice Chen", role: "Admin", status: "Active" },
{ id: "bob", name: "Bob Smith", role: "Editor", status: "Active" },
{ id: "carol", name: "Carol Lee", role: "Viewer", status: "Invited" },
];
export default function Example() {
return (
<Table.Root className="" variant="outline" size="sm">
<Table.Caption>Team members</Table.Caption>
<Table.Header>
<Table.Row id="team-head">
<Table.ColumnHeader id="team-name">Name</Table.ColumnHeader>
<Table.ColumnHeader id="team-role">Role</Table.ColumnHeader>
<Table.ColumnHeader id="team-status">Status</Table.ColumnHeader>
</Table.Row>
</Table.Header>
<Table.Body>
{rows.map((row) => (
<Table.Row id={row.id} key={row.id}>
<Table.RowHeader>{row.name}</Table.RowHeader>
<Table.Cell>{row.role}</Table.Cell>
<Table.Cell>{row.status}</Table.Cell>
</Table.Row>
))}
</Table.Body>
<Table.Footer>
<Table.Row id="team-total">
<Table.Cell colSpan={3}>3 members · 2 active</Table.Cell>
</Table.Row>
</Table.Footer>
</Table.Root>
);
}@layer components {
[data-uiify-table] {
inline-size: 100%;
border-collapse: separate;
border-spacing: 0;
background: var(--card);
color: var(--card-foreground);
font-size: var(--text-sm);
}
[data-uiify-table][data-layout="fixed"] {
table-layout: fixed;
}
[data-uiify-table] :is(th, td) {
padding-block: 0.75rem;
padding-inline: 1rem;
text-align: start;
vertical-align: middle;
border-block-end: 1px solid var(--border);
background: inherit;
}
[data-uiify-table] :is(th, td)[data-align="center"] {
text-align: center;
}
[data-uiify-table] :is(th, td)[data-align="end"] {
text-align: end;
}
[data-uiify-table] :is(thead, tfoot) {
background: var(--secondary);
font-weight: 600;
}
[data-uiify-table] tbody tr {
background: var(--card);
}
[data-uiify-table] tbody tr:hover {
background: var(--secondary);
}
[data-uiify-table] tbody tr[data-selected] {
background: var(--accent);
}
[data-uiify-table] caption {
padding-block: 0.75rem;
text-align: start;
color: var(--muted-foreground);
}
[data-uiify-table][data-size="sm"] :is(th, td) {
padding-block: 0.5rem;
padding-inline: 0.75rem;
}
[data-uiify-table][data-size="lg"] :is(th, td) {
padding-block: 1rem;
padding-inline: 1.25rem;
}
[data-uiify-table][data-variant="outline"] {
border: 1px solid var(--border);
border-radius: var(--radius-lg);
}
[data-uiify-table][data-variant="ghost"] {
background: transparent;
}
[data-uiify-table] :is(thead, tfoot, tr)[data-sticky] {
position: sticky;
inset-block-start: var(--uiify-table-sticky-offset, 0);
z-index: 2;
}
[data-uiify-table] tfoot[data-sticky] {
inset-block: auto var(--uiify-table-sticky-offset, 0);
}
[data-uiify-table] :is(th, td)[data-sticky] {
position: sticky;
z-index: 1;
}
[data-uiify-table] :is(th, td)[data-sticky="start"] {
inset-inline-start: var(--uiify-table-sticky-offset, 0);
}
[data-uiify-table] :is(th, td)[data-sticky="end"] {
inset-inline-end: var(--uiify-table-sticky-offset, 0);
}
[data-uiify-table] :is(thead, tfoot)[data-sticky] :is(th, td)[data-sticky] {
z-index: 3;
}
[data-uiify-table] th > button {
display: inline-flex;
align-items: center;
gap: 0.5rem;
padding: 0;
border: 0;
background: transparent;
color: inherit;
font: inherit;
cursor: pointer;
}
[data-uiify-table] th[aria-sort="ascending"] > button::after {
content: "↑" / "";
}
[data-uiify-table] th[aria-sort="descending"] > button::after {
content: "↓" / "";
}
[data-uiify-table] [data-part="expanded-row"] {
background: var(--secondary);
}
[data-uiify-table] :is(button, tr):focus-visible {
outline: 2px solid var(--ring);
outline-offset: -2px;
}
}import { Table } from "@gunkin/uiify";
const rows = [
{ id: "alice", name: "Alice Chen", role: "Admin", status: "Active" },
{ id: "bob", name: "Bob Smith", role: "Editor", status: "Active" },
{ id: "carol", name: "Carol Lee", role: "Viewer", status: "Invited" },
];
export default function Example() {
return (
<Table.Root
className={
"[inline-size:100%] [border-collapse:separate] [border-spacing:0] bg-card text-card-foreground text-sm data-" +
"[layout=fixed]:table-fixed [&_:is(th,td)]:[padding-block:0.75rem] [&_:is(th,td)]:[padding-inline:1rem] [&_:" +
"is(th,td)]:text-start [&_:is(th,td)]:[vertical-align:middle] [&_:is(th,td)]:[border-block-end-width:1px] [&" +
"_:is(th,td)]:[border-block-end-style:solid] [&_:is(th,td)]:[border-block-end-color:var(--border)] [&_:is(th" +
",td)]:[background:inherit] [&_:is(th,td)[data-align=center]]:text-center [&_:is(th,td)[data-align=end]]:tex" +
"t-end [&_:is(thead,tfoot)]:bg-secondary [&_:is(thead,tfoot)]:[font-weight:600] [&_tbody_tr]:bg-card [&_tbod" +
"y_tr:hover]:bg-secondary [&_tbody_tr[data-selected]]:bg-accent [&_caption]:[padding-block:0.75rem] [&_capti" +
"on]:text-start [&_caption]:text-muted-foreground [&[data-size=sm]_:is(th,td)]:[padding-block:0.5rem] [&[dat" +
"a-size=sm]_:is(th,td)]:[padding-inline:0.75rem] [&[data-size=lg]_:is(th,td)]:[padding-block:1rem] [&[data-s" +
"ize=lg]_:is(th,td)]:[padding-inline:1.25rem] data-[variant=outline]:[border-width:1px] data-[variant=outlin" +
"e]:border-solid data-[variant=outline]:border-border data-[variant=outline]:rounded-lg data-[variant=ghost]" +
":bg-transparent [&_:is(thead,tfoot,tr)[data-sticky]]:sticky [&_:is(thead,tfoot,tr)[data-sticky]]:[inset-blo" +
"ck-start:var(--uiify-table-sticky-offset,_0)] [&_:is(thead,tfoot,tr)[data-sticky]]:z-[2] [&_tfoot[data-stic" +
"ky]]:[inset-block:auto_var(--uiify-table-sticky-offset,_0)] [&_:is(th,td)[data-sticky]]:sticky [&_:is(th,td" +
")[data-sticky]]:z-[1] [&_:is(th,td)[data-sticky=start]]:[inset-inline-start:var(--uiify-table-sticky-offset" +
",_0)] [&_:is(th,td)[data-sticky=end]]:[inset-inline-end:var(--uiify-table-sticky-offset,_0)] [&_:is(thead,t" +
"foot)[data-sticky]_:is(th,td)[data-sticky]]:z-[3] [&_th>button]:inline-flex [&_th>button]:items-center [&_t" +
"h>button]:[gap:0.5rem] [&_th>button]:p-0 [&_th>button]:border-0 [&_th>button]:border-current [&_th>button]:" +
"border-none [&_th>button]:bg-transparent [&_th>button]:text-inherit [&_th>button]:[font-style:inherit] [&_t" +
"h>button]:[font-variant:inherit] [&_th>button]:[font-weight:inherit] [&_th>button]:[font-stretch:inherit] [" +
"&_th>button]:text-[length:inherit] [&_th>button]:leading-[inherit] [&_th>button]:font-[family-name:inherit]" +
" [&_th>button]:cursor-pointer [&_th[aria-sort=ascending]>button::after]:content-[\"↑\"_/_\"\"] [&_th[aria-sort=" +
"descending]>button::after]:content-[\"↓\"_/_\"\"] [&_[data-part=expanded-row]]:bg-secondary [&_:is(button,tr):f" +
"ocus-visible]:[outline:2px_solid_var(--ring)] [&_:is(button,tr):focus-visible]:[outline-offset:-2px]"
}
variant="outline"
size="sm"
>
<Table.Caption>Team members</Table.Caption>
<Table.Header>
<Table.Row id="team-head">
<Table.ColumnHeader id="team-name">Name</Table.ColumnHeader>
<Table.ColumnHeader id="team-role">Role</Table.ColumnHeader>
<Table.ColumnHeader id="team-status">Status</Table.ColumnHeader>
</Table.Row>
</Table.Header>
<Table.Body>
{rows.map((row) => (
<Table.Row id={row.id} key={row.id}>
<Table.RowHeader>{row.name}</Table.RowHeader>
<Table.Cell>{row.role}</Table.Cell>
<Table.Cell>{row.status}</Table.Cell>
</Table.Row>
))}
</Table.Body>
<Table.Footer>
<Table.Row id="team-total">
<Table.Cell colSpan={3}>3 members · 2 active</Table.Cell>
</Table.Row>
</Table.Footer>
</Table.Root>
);
}/* app.css */
@layer reset, ui, app, tokens, base, demo, components, utilities, theme;
@import "@gunkin/uiify/styles/reset";
@import "@gunkin/uiify/components/behavior.css";
@import "@gunkin/uiify/styles/tokens";
@import "@gunkin/uiify/styles/tailwind";
@import "tailwindcss/utilities.css";
@theme { --spacing: 0.25rem; --font-weight-normal: 400; --font-weight-medium: 500; --font-weight-semibold: 600; --font-weight-bold: 700; }
@source inline('[inline-size:100%] [border-collapse:separate] [border-spacing:0] bg-card text-card-foreground text-sm data-[layout=fixed]:table-fixed [&_:is(th,td)]:[padding-block:0.75rem] [&_:is(th,td)]:[padding-inline:1rem] [&_:is(th,td)]:text-start [&_:is(th,td)]:[vertical-align:middle] [&_:is(th,td)]:[border-block-end-width:1px] [&_:is(th,td)]:[border-block-end-style:solid] [&_:is(th,td)]:[border-block-end-color:var(--border)] [&_:is(th,td)]:[background:inherit] [&_:is(th,td)[data-align=center]]:text-center [&_:is(th,td)[data-align=end]]:text-end [&_:is(thead,tfoot)]:bg-secondary [&_:is(thead,tfoot)]:[font-weight:600] [&_tbody_tr]:bg-card [&_tbody_tr:hover]:bg-secondary [&_tbody_tr[data-selected]]:bg-accent [&_caption]:[padding-block:0.75rem] [&_caption]:text-start [&_caption]:text-muted-foreground [&[data-size=sm]_:is(th,td)]:[padding-block:0.5rem] [&[data-size=sm]_:is(th,td)]:[padding-inline:0.75rem] [&[data-size=lg]_:is(th,td)]:[padding-block:1rem] [&[data-size=lg]_:is(th,td)]:[padding-inline:1.25rem] data-[variant=outline]:[border-width:1px] data-[variant=outline]:border-solid data-[variant=outline]:border-border data-[variant=outline]:rounded-lg data-[variant=ghost]:bg-transparent [&_:is(thead,tfoot,tr)[data-sticky]]:sticky [&_:is(thead,tfoot,tr)[data-sticky]]:[inset-block-start:var(--uiify-table-sticky-offset,_0)] [&_:is(thead,tfoot,tr)[data-sticky]]:z-[2] [&_tfoot[data-sticky]]:[inset-block:auto_var(--uiify-table-sticky-offset,_0)] [&_:is(th,td)[data-sticky]]:sticky [&_:is(th,td)[data-sticky]]:z-[1] [&_:is(th,td)[data-sticky=start]]:[inset-inline-start:var(--uiify-table-sticky-offset,_0)] [&_:is(th,td)[data-sticky=end]]:[inset-inline-end:var(--uiify-table-sticky-offset,_0)] [&_:is(thead,tfoot)[data-sticky]_:is(th,td)[data-sticky]]:z-[3] [&_th>button]:inline-flex [&_th>button]:items-center [&_th>button]:[gap:0.5rem] [&_th>button]:p-0 [&_th>button]:border-0 [&_th>button]:border-current [&_th>button]:border-none [&_th>button]:bg-transparent [&_th>button]:text-inherit [&_th>button]:[font-style:inherit] [&_th>button]:[font-variant:inherit] [&_th>button]:[font-weight:inherit] [&_th>button]:[font-stretch:inherit] [&_th>button]:text-[length:inherit] [&_th>button]:leading-[inherit] [&_th>button]:font-[family-name:inherit] [&_th>button]:cursor-pointer [&_th[aria-sort=ascending]>button::after]:content-["↑"_/_""] [&_th[aria-sort=descending]>button::after]:content-["↓"_/_""] [&_[data-part=expanded-row]]:bg-secondary [&_:is(button,tr):focus-visible]:[outline:2px_solid_var(--ring)] [&_:is(button,tr):focus-visible]:[outline-offset:-2px]');
@layer base { :root { --uiify-control-text: var(--text-sm); } @media (pointer: coarse) { :root { --uiify-control-text: var(--text-base); } } }
/* Authored animation and registered properties used by the Tailwind skin.
* Visual rules belong in utility recipes; only at-rule definitions live here. */
@layer components {
@keyframes uiify-presence-in {
from {
opacity: 0;
scale: var(--presence-scale);
}
}
}
@layer components {
@keyframes uiify-presence-out {
to {
opacity: 0;
scale: var(--presence-scale);
}
}
}
@property --uiify-spinner-tail {
syntax: "<angle>";
inherits: false;
initial-value: 0deg;
}
@property --uiify-spinner-length {
syntax: "<angle>";
inherits: false;
initial-value: 36deg;
}
@layer components {
@keyframes uiify-spinner-rotate {
to {
transform: rotate(360deg);
}
}
}
@layer components {
@keyframes uiify-spinner-orbit {
0% {
--uiify-spinner-tail: 0deg;
--uiify-spinner-length: 36deg;
}
50% {
--uiify-spinner-tail: 90deg;
--uiify-spinner-length: 324deg;
}
100% {
--uiify-spinner-tail: 360deg;
--uiify-spinner-length: 36deg;
}
}
}
@layer components {
@keyframes uiify-skeleton-pulse {
50% {
opacity: 0.45;
}
}
}
@layer components {
@keyframes uiify-skeleton-shimmer {
to {
background-position: -200% 0;
}
}
}
@layer components {
@keyframes uiify-skeleton-reveal {
from {
opacity: 0;
}
to {
opacity: 1;
}
}
}
@property --candle-body-height {
syntax: "<percentage>";
inherits: true;
initial-value: 0%;
}
@property --candle-body-top {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --candle-slot {
syntax: "<percentage>";
inherits: true;
initial-value: 100%;
}
@property --candle-wick-height {
syntax: "<percentage>";
inherits: true;
initial-value: 0%;
}
@property --candle-wick-top {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --candle-x {
syntax: "<percentage>";
inherits: true;
initial-value: 0%;
}
@property --candle-scale {
syntax: "<number>";
inherits: true;
initial-value: 1;
}
@property --line-y {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --line-prev-y {
syntax: "<percentage>";
inherits: true;
initial-value: 50%;
}
@property --line-count {
syntax: "<integer>";
inherits: false;
initial-value: 1;
}
@property --line-scale {
syntax: "<number>";
inherits: true;
initial-value: 1;
}
@layer components {
@keyframes uiify-otp-input-caret-blink {
50% {
opacity: 0;
}
}
}API
Table.Root (native)
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
layout | "auto" | "fixed" | "auto" | تخطيط جدول أصلي. يستخدم التحديد والفرز وتوسيع الصفوف نقطة الدخول الصريحة TableClient. |
size | "sm" | "md" | "lg" | — | تباعد الخلايا من ورقة الأنماط المختارة. |
variant | "solid" | "outline" | "ghost" | — | نمط السطح من ورقة الأنماط المختارة. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.Footer
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
sticky | boolean | — | يثبّت التذييل عند نهاية محور الكتل في حاوية التمرير. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.RowHeader / Table.Cell / Table.ColumnHeader
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
align | "start" | "center" | "end" | "start" | المحاذاة المنطقية للنص في هذه الخلية. |
sticky | "start" | "end" | — | يثبّت خلية عند حافة المحور السطري المنطقية. للخلايا الثابتة المتجاورة، عيّن --uiify-table-sticky-offset على كل خلية. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
TableClient.ExpandTrigger / TableClient.ExpandedRow
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
rowId* | string | — | مفتاح صف مشترك يصل زر التوسيع بعنصر <tr> الأصلي. ضع <td colSpan={columnCount}> داخل الصف الموسّع. |
TableClient.Root — @gunkin/uiify/components/table/client
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
aria-label | string | — | اسم الجدول للتقنيات المساعدة، حين لا يوجد عنوان أو وصف مرئي يسمّيه. |
aria-labelledby | string | — | معرّف العنصر الذي يوفّر تسمية الجدول. |
selectionMode | "none" | "single" | "multiple" | "none" | يحدّد إمكان تحديد الصفوف وعددها في المرة الواحدة؛ يعرض "none" جدولًا ثابتًا عاديًا دون دور grid. |
selectionBehavior | "toggle" | "replace" | — | يحدّد إن كان النقر على صف يضيفه إلى التحديد أم يستبدل التحديد الحالي. |
defaultSelectedKeys | Iterable<string> | — | معرّفات الصفوف المحدّدة مبدئيًا، مع إبقاء التحديد غير متحكّم به داخل المكوّن. |
selectedKeys | Iterable<string> | — | معرّفات الصفوف المحدّدة حاليًا، ليصبح التحديد متحكّمًا به من الجهة المستدعية. |
onSelectionChange | (selectedKeys: Set<string>) => void | — | تُستدعى بمجموعة معرّفات الصفوف المحدّدة الجديدة كلما تغيّر التحديد. |
defaultSortDescriptor | SortDescriptor | null | — | العمود واتجاه الفرز المبدئيان، مع إبقاء حالة الفرز غير متحكّم بها داخل المكوّن. |
sortDescriptor | SortDescriptor | null | — | العمود واتجاه الفرز الحاليان، ليصبح الفرز متحكّمًا به. |
onSortChange | (descriptor: SortDescriptor | null) => void | — | تُستدعى بواصف الفرز الجديد، أو null، عند تفعيل ترويسة عمود قابل للفرز. |
expandedKeys / defaultExpandedKeys | Iterable<string> | — | مفاتيح الصفوف الموسّعة المتحكّم بها أو المبدئية. |
onExpandedChange | (keys: Set<string>) => void | — | تبلّغ عن طلبات التوسيع. وتنتظر الصفوف المتحكّم بها تحديث المفاتيح. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.Header
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
sticky | boolean | false | يثبّت هذا القسم في حاوية التمرير؛ يستخدم Header بداية محور الكتل، وFooter نهايته. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.Body
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
children | ReactNode | — | صفوف جسم الجدول. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.Row
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
id* | string | — | معرّف ثابت للصف يُستخدم مفتاحًا للتحديد ومعرّفًا للعنصر. |
disabled | boolean | false | يمنع تحديد الصف أو تركيزه بلوحة المفاتيح. |
selected | boolean | — | يعلّم الصف كمحدّد في بنية HTML المعروضة على الخادم قبل أن يتولى مخزن التحديد المسؤولية. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.ColumnHeader
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
id* | string | — | معرّف العمود الذي تشير إليه واصفات الفرز. |
allowsSorting | boolean | false | يجعل الترويسة تبدّل فرز عمودها وتكشف aria-sort. |
sortDirection | "ascending" | "descending" | null | — | اتجاه الفرز المعروض لهذا العمود، ويُستخدم في بنية الخادم الأولية حين يُسمح بالفرز. |
onClick | React.MouseEventHandler<HTMLTableCellElement> | — | تعمل قبل الفرز؛ ويمنع preventDefault() تغيير الفرز. |
children | ReactNode | — | تسمية الترويسة. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.Cell
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
children | ReactNode | — | محتويات الخلية. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.Caption
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
children | ReactNode | — | نص الوصف الذي يشرح الجدول. |
render | ReactElement | ((props, state) => ReactElement) | — | استبدل العنصر المعروض مع الحفاظ على توصيلات السلوك وإمكانية الوصول. |
Table.RowSelect
| الخاصية | النوع | افتراضي | الوصف |
|---|---|---|---|
rowId* | string | — | معرّف الصف الذي يحدّده مربع الاختيار هذا أو يلغي تحديده. |
لوحة المفاتيح
| المفتاح | الإجراء |
|---|---|
| Tab | تركيز عناصر تحكم الفرز والتحديد والتوسيع في TableClient |
| Enter / Space | تفعيل زر الفرز أو التوسيع المركّز؛ وتبديل مربع اختيار |
| Arrow keys | التنقل بين صفوف الجسم القابلة للتحديد في TableClient |
إمكانية الوصول
يعرض Table الافتراضي عناصر <table> و<caption> و<thead> و<tbody> و<tfoot> الأصلية دون JavaScript على العميل؛ استخدم ColumnHeader وRowHeader لدلالات الترويسات. تضيف نقطة الدخول /client الفرز والتحديد والتنقل بين الصفوف بلوحة المفاتيح والتوسيع المتحكّم به، وتكشفها عبر aria-sort وaria-expanded وaria-controls. ExpandedRow هو <tr> أصلي؛ ضع داخله Cell مع colSpan. ويظل الترشيح والترتيب من مسؤولية المستهلك.
نقاط التنسيق
data-uiify-tabledata-partdata-layoutdata-sizedata-variantdata-stickydata-selecteddata-disabled--uiify-table-sticky-offset