Erstellen Sie mit Blueprint einen datenintensiven Arbeitsbereich: mit verifizierten Typografie- und Intent-Tokens, einer Tabelle mit auswählbarem Datensatz, einem Prüfbereich und vollständigem React-Quellcode.
Vorschau der Benutzeroberfläche des Palantir Blueprint-Designsystems
Nach Name oder Typ filtern, einen Datensatz auswählen, die Zeilendichte ändern, das Erscheinungsbild wechseln und eine Prüfnotiz validieren, bevor der lokale Status aktualisiert wird.
Natives Blueprint 6.21.0 mit React 18.3.1. Originale, responsive Arbeitsbereichskomposition; weder Server noch gespeicherte Prüfung. · Implementierungsreferenz
02
Designreferenz für das Palantir Blueprint-Designsystem
Blueprint Core 6.21.0 veröffentlicht CSS und native React-Komponenten. Dies sind ausgewählte Tokenwerte für das helle Design; verwende statt einer manuellen Umkehrung das dunkle Design der Bibliothek. Layoutentscheidungen der Anwendung sind im Beispiel CSS gekennzeichnet.
Ein um Daten herum gestalteter Arbeitsbereich für das Palantir Blueprint-Designsystem
Kompakte Steuerelemente mit eindeutiger Lesereihenfolge
Blueprint eignet sich, wenn eine Ansicht eine Sammlung, Filter, Statusangaben und kontextbezogene Aktionen kombiniert. Im Beispiel befindet sich die Datensatztabelle links und der ausgewählte Datensatz rechts. So lassen sich Datensätze vergleichen, ohne für jeden eine neue Seite zu öffnen. Im Detailbereich befindet sich die bearbeitbare Prüfnotiz; die Tabelle dient der schnellen Übersicht.
Verwende den Paketvertrag von v6
Das Beispiel wird mit @blueprintjs/core 6.21.0 kompiliert. Sein CSS-Namespace lautet bp6, und seine veröffentlichten semantischen Tokens beginnen mit --bp-. Ein älteres bp5-Stylesheet ist kein Ersatz für die Komponenten von v6 unter CSS. Importiere das Paket-Stylesheet einmal am Einstiegspunkt der Anwendung und beschränke anschließend die Layoutregeln der Anwendung auf eine separate Klasse.
Farbintentionen und Farbrollen des Palantir Blueprint-Designsystems
Datensatzstatus und Auswahl getrennt halten
Ein Tag mit Warnkennzeichnung bedeutet, dass der Datensatz geprüft werden muss; die primär eingefärbte Zeile kennzeichnet die Auswahl. Diese Bedeutungen sind voneinander unabhängig. Wenn ein Datensatz als geprüft markiert wird, ändern sich Beschriftung und Farbintention zu „Erfolg“, während die Auswahl auf demselben Datensatz bleibt. Für jeden Status verwendet die Tabelle zusätzlich Text, damit die Bedeutung nicht allein von der Farbe abhängt.
Den Dunkelmodus an der Komponentengrenze anwenden
Das Beispiel versieht seinen Wrapper mit bp6-dark, sodass native Komponenten ihre dunkle Darstellung verwenden können. Die Werte für das helle Design oben sind eine Referenzaufnahme und keine Aufforderung, jede Komponente zu überschreiben. Wenn du ein Portal wie Dialog einführst, stelle sicher, dass dessen gerenderter Inhalt denselben Designkontext erhält; ein Wrapper, der das Portal nicht enthält, reicht nicht aus.
Typografie für Datensätze und Metadaten im Palantir Blueprint-Designsystem
Lies zuerst die Fließtext-Skalierung, bevor du Überschriften auswählst
Die veröffentlichten Schriftgrößen für Fließtext umfassen 10, 12, 14 und 16px; die mittlere Fließtextgröße beträgt 14px. Datensatznamen bleiben auf der primären Lesestufe. IDs und Datensatztypen verwenden ergänzenden Text, während numerische Datensatzanzahlen tabellarische Ziffern nutzen, damit sich verändernde Werte leicht vergleichen lassen. Der Leitfaden empfiehlt keine 10px für primäre Inhalte.
Dem Detailbereich eine kompakte Hierarchie geben
Der Detailbereich verwendet eine Überschrift mit 20px sowie eine Definitionsliste für ID, zuständige Person, Typ und Anzahl. Beschriftungen und Werte sind stabil in zwei Spalten angeordnet. Die Prüfnotiz folgt nach einer Trennlinie auf diese Angaben, damit sie nicht mit einem Tabellenfilter verwechselt wird.
Tabelle, Filter und Detailbereich im Palantir Blueprint-Designsystem
Die Semantik der Tabelle beibehalten
HTMLTable stellt eine native Tabelle im Blueprint-Stil bereit. Schaltflächen in der ersten Zelle wählen Datensätze aus und sind weiterhin per Tastatur erreichbar; im Beispiel ist ein ausschließlich mit dem Mauszeiger bedienbarer Zeilen-Handler nicht der einzige Weg zur Auswahl. Die interaktive prop sorgt für eine Hover-Darstellung der Zeilen, und condensed ändert unabhängig von der Filterung die Dichte.
Den kontrollierten Datenfluss sichtbar machen
Einen Datensatz anhand seines angezeigten Namens finden.
Dieselbe Sammlung mit der Typauswahl eingrenzen.
Die Namensschaltfläche auswählen, um den Detailbereich zu laden.
Eine Prüfnotiz eingeben und die lokale Prüfung absenden.
Abstände, Oberflächen und Dichte im Palantir Blueprint-Designsystem
Eine kleinere Einheit verwenden, ohne alle Abstände winzig zu machen
Das veröffentlichte Token für Oberflächenabstände beträgt 4px. Der Arbeitsbereich verwendet Vielfache davon: 12px zwischen Filtersteuerelementen, 20px zwischen Sammlung und Detailbereich sowie 24px rund um das Desktop-Beispiel. Dies sind Kompositionsentscheidungen aus CSS. Der Token für einen Rahmenradius von 4px sorgt für eine zurückhaltende Geometrie von Steuerelementen und Oberflächen.
Das Layout ändern, bevor Beschriftungen geopfert werden
Am Anwendungs-Breakpoint von 800px im Beispiel wird der Inspektor unter die Sammlung verschoben. Die Filter umbrechen, der Innenabstand des Hauptbereichs wird auf 16px reduziert und die Tabelle erhält bei Bedarf einen eigenen horizontalen Scrollbereich. Dieser Breakpoint gilt für diesen Arbeitsbereich und wird nicht als offizieller, universeller Blueprint-Breakpoint dargestellt.
Palantir Blueprint Designsystemprüfung und leere Zustände
Die Validierung gehört zum Prüfvorgang
Beim Absenden einer leeren Notiz erhalten InputGroup und FormGroup die Fehlerabsicht (danger), es wird erklärender Hilfetext angezeigt und der Fokus auf das Feld gesetzt. Durch die Eingabe von Text wird der Fehler behoben. Bei einer gültigen Übermittlung wird nur der ausgewählte lokale Datensatz geändert, die Notiz geleert und ein Erfolgs-Callout angezeigt, das ausdrücklich darauf hinweist, dass keine Daten gesendet wurden.
Die Möglichkeit zur Wiederherstellung gehört direkt neben die leere Sammlung
Der Callout für keine Treffer bietet die Option „Filter löschen“. Damit werden sowohl die Suchanfrage als auch die Typauswahl zurückgesetzt und die gesamte Sammlung wieder angezeigt. Es werden keine Zeilen gelöscht und der Inspektor bleibt unverändert. Die folgenden Zustandsgrenzen sind beabsichtigt:
Durch die Auswahl ändert sich der geprüfte Datensatz, nicht dessen Prüfstatus.
Der Kompaktmodus ändert die Dichte, nicht die Reihenfolge der Datensätze.
Das Design ändert die visuelle Darstellung, nicht die aktuellen Filter.
Eine erfolgreiche lokale Prüfung ändert einen Datensatz und gibt das Ergebnis bekannt.
Palantir Blueprint Designsystem: Fokus und barrierefreie Komponentennutzung
Jedes native Steuerelement beschriften
InputGroup erhält einen zugänglichen Namen für die Suche und eine id für das beschriftete Prüffeld. HTMLSelect hat einen eigenen Namen, Switch zeigt sichtbare Beschriftungen an und jeder Datensatz wird über eine echte Schaltfläche geöffnet. Verwenden Sie diese Bibliotheks-APIs, statt die Steuerelemente durch gestaltete div-Elemente zu ersetzen.
Eine sichtbare Fokusmarkierung beibehalten
Die Paketdokumentation sieht eine Fokusbreite von 2px und einen Fokusabstand von 2px vor. Die Fokusmarkierung muss auf Cards und ausgewählten Zeilen sichtbar bleiben. Tastaturnutzende sollten die Filter, Zeilenschaltflächen und das Prüfungsformular in Dokumentreihenfolge erreichen können. Der Statusabsatz und der Erfolgs-Callout des Beispiels vermitteln Ergebnisse, ohne die lesende Person auf einen anderen Bildschirm zu versetzen.
Palantir Blueprint Designsystem: Installation und Anwendungsgrenzen
Denselben Quellcode wie im Beispiel ausführen
Der vollständige App-Quellcode und die Anwendung CSS sind unten enthalten. App wird in das Stammelement eingebunden, das von der Vite React-Vorlage erzeugt wird. Die Installation des festgelegten Kernpakets stellt die nativen Komponenten und das Paket CSS bereit; für das textbasierte Beispiel ist kein verborgenes Design-Asset erforderlich.
Die Prüfung um einen echten Persistenzvertrag erweitern
Speichern Sie dies als src/main.jsx und das nächste Beispiel als src/blueprint.css.
Der Aufruf von createRoot verwendet das Stammelement in der Vite-React-Datei index.html.
blueprint.css — responsives Layout des Arbeitsbereichs
Die Layoutregeln der Anwendung ergänzen die importierten nativen Komponenten von CSS. Der Breakpoint von 800px und der 260px breite Inspektor sind explizite Festlegungen dieses Beispiels.
Die native Vorschau wurde mit React 18.3.1 und Blueprint 6.21.0 erstellt und ausgeführt. Verwenden Sie eine von Ihrer gewählten Vite-Version unterstützte Node.js-Version. Beide Anwendungsdateien sind oben enthalten.
sh
npm create vite@latest blueprint-review -- --template react
cd blueprint-review
npm install
npm install [email protected][email protected] @blueprintjs/[email protected]
# Replace src/main.jsx and add src/blueprint.css using the complete examples.
npm run dev
Ein Prompt für dein Projekt
Agenten-Prompt
Verwenden Sie Blueprint 6.21.0, um einen Arbeitsbereich zur Datensatzprüfung zu erstellen. Lesen Sie die bereitgestellten Tokens und das vollständige Beispiel React/CSS. Behalten Sie die native HTMLTable, beschriftete InputGroup/FormGroup, Status-Tags und per Tastatur erreichbare Zeilenauswahl bei. Filter, Auswahl, Dichte, Darstellung und Prüfstatus müssen voneinander unabhängig bleiben. Ergänzen Sie den tatsächlichen Speicherdienst erst, wenn dessen API vorliegt; zeigen Sie ausstehende und fehlgeschlagene Antworten an, ohne die Notiz zu verlieren. Behalten Sie den responsiven Inspektor und die sichtbaren Fokusmarkierungen bei.
05
Palantir Blueprint Designsystem: Quellen und Geltungsbereich
OpenDesign Anwendungsleitfaden für Blueprint 6.21.0 mit einem eigens erstellten Beispiel zur Datensatzprüfung, das das tatsächliche Paket React verwendet. Datensatznamen und Prüfergebnisse sind lokale Beispieldaten. Das Layout des Arbeitsbereichs ist Anwendungscode; die Referenzwerte stammen aus der versionierten, veröffentlichten Paketversion.