Jamdesk Documentation logo

Tabellen

Organisieren Sie Daten in Zeilen und Spalten mit Markdown-Tabellen und Table-Komponenten – inklusive Sortierung, Hervorhebung und Zusammenführung.

Tabellen organisieren Daten in Zeilen und Spalten. Jamdesk unterstützt zwei Ansätze: Markdown-Tabellen für schnelle, einfache Tabellen und Table-Komponenten für erweiterte Funktionen wie Hervorhebung und Ausrichtung.

Verwendung

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

Markdown-Tabellen

Die schnellste Möglichkeit, 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 |
NameTypBeschreibung
idstringEindeutiger Bezeichner
emailstringE-Mail-Adresse des Benutzers

Markdown-Tabellen eignen sich hervorragend für einfache Referenzdaten. Die Table-Komponente bietet mehr Kontrolle, wenn Sie Hervorhebungen, Ausrichtung oder visuelle Akzente benötigen.

Table-Komponente

Verwenden Sie für mehr Kontrolle 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>
NameTypBeschreibung
idstringEindeutiger Bezeichner
emailstringE-Mail-Adresse des Benutzers

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>
ParameterWert
timeout30s
retries3
backoffexponential
maxDelay60s

Umrandet und kompakt

Fügen Sie Rahmen zwischen den Zellen hinzu und reduzieren Sie den Innenabstand:

<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 darauf 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>
FeldErforderlichBeschreibung
api_keyJaIhr API-Authentifizierungsschlüssel
limitNeinMaximale Anzahl an Ergebnissen (Standard: 100)

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

Zellen hervorheben

Heben Sie einzelne Zellen als Statusindikatoren 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
APIBetriebsbereit
DatenbankEingeschränkt
SpeicherAusfall

Zellenausrichtung

Steuern Sie die Textausrichtung für jede 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>
LinksZentriertRechts
TextText$99.99

Spalten- und Zeilenzusammenführung

Führen Sie Zellen über mehrere Spalten oder Zeilen zusammen:

<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>
KategorieArtikelPreis
ObstApfel$1.00
Banane$0.50
Zwischensumme$1.50

Sichtbare Beschriftung

Zeigen Sie oberhalb der Tabelle eine barrierefreie Tabellenbeschriftung 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>
Monatlicher Umsatz nach Region
RegionUmsatz
Nordamerika$1.2M

Sortierbare Spalten

Aktivieren Sie die interaktive Spaltensortierung mit der Eigenschaft sortable. Benutzer können auf Spaltenüberschriften klicken, 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>
NamePreisBestand
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, erneut für die absteigende Sortierung und ein drittes Mal, um die Sortierung zurückzusetzen. Zahlen werden numerisch, Texte alphabetisch sortiert.

Sortable funktioniert mit weiteren Funktionen wie gestreiften Zeilen:

<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>
TeamSiegeNiederlagen
Eagles124
Bears88
Lions106

Eigenschaften

Table

EigenschaftTypStandardBeschreibung
stripedbooleanfalseAbwechselnde Zeilenhintergründe
borderedbooleanfalseRahmen zwischen allen Zellen
compactbooleanfalseReduzierter Zellinnenabstand
fullWidthbooleantrueTabelle erstreckt sich über die gesamte Breite
captionstring-Text der Tabellenbeschriftung
captionVisiblebooleanfalseBeschriftung visuell anzeigen (Standard: nur für Screenreader)
stickyHeaderbooleanfalseKopfzeile beim Scrollen sichtbar halten
sortablebooleanfalseSortierung der Spaltenüberschriften per Klick aktivieren

Row

EigenschaftTypStandardBeschreibung
headerbooleanfalseAls Kopfzeile rendern
highlightbooleanfalseZeile hervorheben
highlightColorstringprimaryFarbe: primary, success, warning, error, info

Cell

EigenschaftTypStandardBeschreibung
alignstringleftTextausrichtung: left, center, right
colSpannumber-Zu überspannende Spalten
rowSpannumber-Zu überspannende Zeilen
highlightbooleanfalseZelle hervorheben
highlightColorstringprimaryFarbe: primary, success, warning, error, info
headerbooleanfalseKopfzeilenformatierung erzwingen

Wie geht es weiter?

Übersicht der Komponenten

Alle verfügbaren Komponenten durchsuchen

MDX-Grundlagen

Erfahren Sie, wie Sie Komponenten in MDX verwenden