Jamdesk Documentation logo

Tabellen

Daten in Zeilen und Spalten organisieren. Unterstützt Markdown-Tabellen und Table-Komponenten mit Sortierung, Hervorhebung und Zellenverbindung.

Tabellen organisieren Daten in Zeilen und Spalten. Verwenden Sie Markdown-Tabellen für schnelle, einfache Tabellen. Verwenden Sie Table-Komponenten für Hervorhebungen, Ausrichtung und weitere Optionen.

Verwendung

<Table>
  <Row header>
    <Cell>Name</Cell>
    <Cell>Type</Cell>
  </Row>
  <Row>
    <Cell>id</Cell>
    <Cell>string</Cell>
  </Row>
</Table>

Markdown-Tabellen

Der schnellste Weg, eine Tabelle zu erstellen. Verwenden Sie Pipes (|), um Spalten zu trennen, und Bindestriche (-) für die Kopfzeile:

| Name | Type | Description |
|------|------|-------------|
| id | string | Unique identifier |
| email | string | User email address |
NameTypeDescription
idstringUnique identifier
emailstringUser email address

Verwenden Sie Markdown-Tabellen für einfache Referenzdaten. Wechseln Sie zur Table-Komponente für Hervorhebungen, Ausrichtung oder visuelle Betonung.

Table-Komponente

Für mehr Kontrolle verwenden Sie die Komponenten <Table>, <Row> und <Cell>:

<Table>
  <Row header>
    <Cell>Name</Cell>
    <Cell>Type</Cell>
    <Cell>Description</Cell>
  </Row>
  <Row>
    <Cell>id</Cell>
    <Cell>string</Cell>
    <Cell>Unique identifier</Cell>
  </Row>
  <Row>
    <Cell>email</Cell>
    <Cell>string</Cell>
    <Cell>User email address</Cell>
  </Row>
</Table>
NameTypeDescription
idstringUnique identifier
emailstringUser email address

Gestreifte Zeilen

Fügen Sie abwechselnde Zeilenhintergründe hinzu, um die Lesbarkeit zu verbessern:

<Table striped>
  <Row header>
    <Cell>Parameter</Cell>
    <Cell>Value</Cell>
  </Row>
  <Row><Cell>timeout</Cell><Cell>30s</Cell></Row>
  <Row><Cell>retries</Cell><Cell>3</Cell></Row>
  <Row><Cell>backoff</Cell><Cell>exponential</Cell></Row>
  <Row><Cell>maxDelay</Cell><Cell>60s</Cell></Row>
</Table>
ParameterValue
timeout30s
retries3
backoffexponential
maxDelay60s

Umrandet und kompakt

Fügen Sie Rahmen zwischen Zellen hinzu und reduzieren Sie das Padding:

<Table bordered compact>
  <Row header>
    <Cell>A</Cell>
    <Cell>B</Cell>
    <Cell>C</Cell>
  </Row>
  <Row>
    <Cell>1</Cell>
    <Cell>2</Cell>
    <Cell>3</Cell>
  </Row>
</Table>
ABC
123

Zeilen hervorheben

Heben Sie ganze Zeilen hervor, um Aufmerksamkeit zu lenken:

<Table>
  <Row header>
    <Cell>Field</Cell>
    <Cell>Required</Cell>
    <Cell>Description</Cell>
  </Row>
  <Row highlight highlightColor="warning">
    <Cell>api_key</Cell>
    <Cell>Yes</Cell>
    <Cell>Your API authentication key</Cell>
  </Row>
  <Row>
    <Cell>limit</Cell>
    <Cell>No</Cell>
    <Cell>Maximum results (default: 100)</Cell>
  </Row>
</Table>
FieldRequiredDescription
api_keyYesYour API authentication key
limitNoMaximum results (default: 100)

Verfügbare Hervorhebungsfarben: primary, success, warning, error, info

Zellen hervorheben

Heben Sie einzelne Zellen für Statusanzeigen hervor:

<Table>
  <Row header>
    <Cell>Service</Cell>
    <Cell>Status</Cell>
  </Row>
  <Row>
    <Cell>API</Cell>
    <Cell highlight highlightColor="success">Operational</Cell>
  </Row>
  <Row>
    <Cell>Database</Cell>
    <Cell highlight highlightColor="warning">Degraded</Cell>
  </Row>
  <Row>
    <Cell>Storage</Cell>
    <Cell highlight highlightColor="error">Outage</Cell>
  </Row>
</Table>
ServiceStatus
APIOperational
DatabaseDegraded
StorageOutage

Zellenausrichtung

Steuern Sie die Textausrichtung pro Zelle:

<Table>
  <Row header>
    <Cell align="left">Left</Cell>
    <Cell align="center">Center</Cell>
    <Cell align="right">Right</Cell>
  </Row>
  <Row>
    <Cell align="left">Text</Cell>
    <Cell align="center">Text</Cell>
    <Cell align="right">$99.99</Cell>
  </Row>
</Table>
LeftCenterRight
TextText$99.99

Spalten- und Zeilenzusammenführung

Verbinden Sie Zellen über Spalten oder Zeilen hinweg:

<Table bordered>
  <Row header>
    <Cell>Category</Cell>
    <Cell>Item</Cell>
    <Cell>Price</Cell>
  </Row>
  <Row>
    <Cell rowSpan={2}>Fruits</Cell>
    <Cell>Apple</Cell>
    <Cell>$1.00</Cell>
  </Row>
  <Row>
    <Cell>Banana</Cell>
    <Cell>$0.50</Cell>
  </Row>
  <Row>
    <Cell colSpan={2}>Subtotal</Cell>
    <Cell>$1.50</Cell>
  </Row>
</Table>
CategoryItemPrice
FruitsApple$1.00
Banana$0.50
Subtotal$1.50

Sichtbare Beschriftung

Zeigen Sie eine barrierefreie Tabellenbeschriftung über der Tabelle an:

<Table caption="Monthly Revenue by Region" captionVisible>
  <Row header>
    <Cell>Region</Cell>
    <Cell align="right">Revenue</Cell>
  </Row>
  <Row>
    <Cell>North America</Cell>
    <Cell align="right">$1.2M</Cell>
  </Row>
</Table>
Monthly Revenue by Region
RegionRevenue
North America$1.2M

Sortierbare Spalten

Aktivieren Sie die Spaltensortierung mit der Prop sortable. Klicken Sie auf eine Spaltenüberschrift, um zu sortieren:

<Table sortable>
  <Row header>
    <Cell>Name</Cell>
    <Cell>Price</Cell>
    <Cell>Stock</Cell>
  </Row>
  <Row><Cell>Widget A</Cell><Cell>$29.99</Cell><Cell>150</Cell></Row>
  <Row><Cell>Gadget B</Cell><Cell>$49.99</Cell><Cell>75</Cell></Row>
  <Row><Cell>Tool C</Cell><Cell>$19.99</Cell><Cell>200</Cell></Row>
  <Row><Cell>Device D</Cell><Cell>$99.99</Cell><Cell>25</Cell></Row>
</Table>
NamePriceStock
Widget A$29.99150
Gadget B$49.9975
Tool C$19.99200
Device D$99.9925

Klicken Sie einmal auf eine Spaltenüberschrift, um aufsteigend zu sortieren, ein zweites Mal für absteigend und ein drittes Mal, um zurückzusetzen. Zahlen werden numerisch sortiert, Text alphabetisch.

Kombinieren Sie sortable mit anderen Props wie striped:

<Table sortable striped>
  <Row header>
    <Cell>Team</Cell>
    <Cell>Wins</Cell>
    <Cell>Losses</Cell>
  </Row>
  <Row><Cell>Eagles</Cell><Cell>12</Cell><Cell>4</Cell></Row>
  <Row><Cell>Bears</Cell><Cell>8</Cell><Cell>8</Cell></Row>
  <Row><Cell>Lions</Cell><Cell>10</Cell><Cell>6</Cell></Row>
</Table>
TeamWinsLosses
Eagles124
Bears88
Lions106

Eigenschaften

Table

PropTypeDefaultDescription
stripedbooleanfalseAbwechselnde Zeilenhintergründe
borderedbooleanfalseRahmen zwischen allen Zellen
compactbooleanfalseReduziertes Zellen-Padding
fullWidthbooleantrueTabelle erstreckt sich über die volle Breite
captionstring-Tabellenbeschriftung
captionVisiblebooleanfalseBeschriftung visuell anzeigen (Standard: nur für Screenreader)
stickyHeaderbooleanfalseKopfzeile beim Scrollen sichtbar halten
sortablebooleanfalseKlick-zum-Sortieren auf Spaltenüberschriften aktivieren

Row

PropTypeDefaultDescription
headerbooleanfalseAls Kopfzeile darstellen
highlightbooleanfalseZeile hervorheben
highlightColorstringprimaryFarbe: primary, success, warning, error, info

Cell

PropTypeDefaultDescription
alignstringleftTextausrichtung: left, center, right
colSpannumber-Anzahl zu überspannender Spalten
rowSpannumber-Anzahl zu überspannender Zeilen
highlightbooleanfalseZelle hervorheben
highlightColorstringprimaryFarbe: primary, success, warning, error, info
headerbooleanfalseKopfzeilen-Styling erzwingen

Wie geht es weiter?

Komponenten-Übersicht

Alle verfügbaren Komponenten durchsehen

MDX-Grundlagen

Erfahren Sie, wie Sie Komponenten in MDX verwenden