Angular-Tabellenkalkulationskomponente | ng-hub-ui-spreadsheet
Bearbeitbare Angular-Tabellenkalkulation mit der Tastatur von Excel, rechteckiger Auswahl, einer Zwischenablage, die mit Excel hin und zurück funktioniert, fixierten Bereichen und verbundenen Zellen. MIT, barrierefrei, ohne Bezahlstufe.
API-Referenz
Hier ist der vollständige Vertrag für spreadsheet: alles, was du binden, abhören, projizieren und gestalten kannst, an einem Ort gesammelt. Verdrahte, was du brauchst, und gestalte, was du willst — es ist standalone und Signals-freundlich.
Inputs
Stelle spreadsheet mit 55 Inputs ein. Binde sie wie jeden Angular-@Input.
| Name | Typ | Standard | Beschreibung |
|---|---|---|---|
rowsErforderlich | readonly TRow[] | — | Die Zeilen, so wie Sie sie halten. Das Blatt schreibt nie in sie hinein. |
columnsErforderlich | readonly HubSpreadsheetColumn<TRow>[] | — | Was jede Spalte anzeigt und erlaubt. |
rowKeyErforderlich | (row: TRow) => string | — | Ein stabiler Name pro Zeile, damit ein Speicherzustand seiner Zeile über ein Neuladen hinweg folgt. |
errors | Record<string, string> | {} | Eine Validierungsmeldung pro Zelle, indiziert wie `states`. Sie liegt beim Host, weil die Validierung demjenigen gehört, der weiß, was die Daten bedeuten. Die Zelle wird rot umrandet, und die Meldung öffnet sich als Tooltip beim Hovern oder bei Tastaturfokus. |
invalidDrafts | Record<string, string> | {} | Zweiseitig. Text, den der Leser in einer Zelle zurückgelassen hat, ohne dass er ein Wert ist, den die Spalte speichern kann, mit demselben Schlüssel wie states. Die Zelle zeigt ihn weiter an, umrandet und mit einem Hinweis, dass er nicht gespeichert wurde; erneutes Öffnen bringt ihn zum Korrigieren zurück, Escape verwirft ihn, und Überschreiben der Zelle oder Entfernen ihrer Zeile oder Spalte entfernt ihn. Lesen Sie es, um nicht stillschweigend den alten Wert zu speichern. |
states | Record<string, HubSpreadsheetCellState> | {} | Speicherzustand pro Zelle, indiziert über den Zeilenschlüssel und den Spaltenalias, verbunden durch einen Tabulator. |
decimalMark | ',' | '.' | ',' | Das Zeichen, mit dem dieser Leser Dezimalstellen eingibt. Wird nur befragt, wenn ein eingefügter Wert keine rohe Zahl mitbrachte. |
emptyText | string | '' | Was ein leeres Blatt anzeigt. |
pageSize | number | 10 | Um wie viele Zeilen Bild auf und Bild ab springen. |
readonly | boolean | false | Schaltet jeden Editor ab, unabhängig davon, was die einzelnen Zellen angeben. |
frozenColumns | number | 0 | Wie viele Spalten am Anfangsrand fixiert bleiben, gezählt so, wie Excel Fensterbereiche fixiert. |
frozenRows | number | 0 | Wie viele Zeilen unter der Kopfzeile fixiert bleiben. |
spans | readonly HubGridSpan[] | [] | Verbundene Blöcke, jeweils benannt durch die obere linke Ecke und die Ausdehnung. |
disjointSelection | boolean | true | Ob ein Klick mit Ctrl (Cmd auf dem Mac) einen zweiten Block zur Auswahl hinzufügt statt eine neue zu beginnen. An, weil ein Tabellenprogramm es so macht und weil die Geste frei war: ein einfacher Klick wählt schon aus, Ctrl hatte also nichts zu sagen. Jeder Block ist markiert, Entf leert alle, und jeder gewöhnliche Klick oder Pfeiltaste beginnt die Auswahl neu. Kopiert wird nur, wenn die Blöcke eine Tabelle bilden, sonst wird es verweigert; und der Ausfüllgriff verschwindet, sobald mehr als einer gewählt ist — ein Ausfüllen setzt einen Block fort, und welchen von mehreren, darauf gibt es keine Antwort. |
fillHandle | boolean | false | Whether the sheet offers the fill handle at the corner of the selection. Damit füllt auch Strg+D (Cmd+D auf dem Mac) nach unten. |
canUndo | boolean | false | Ob Rückgängig verfügbar ist. Das Blatt fragt nur ab; den Verlauf führt der Besitzer. |
canRedo | boolean | false | Ob Wiederherstellen verfügbar ist. |
resizableColumns | boolean | false | Ob ein Leser den hinteren Rand einer Spalte ziehen darf, um sie zu verbreitern oder zu verschmälern. |
reorderableColumns | boolean | false | Ob ein Leser eine Kopfzeile ziehen darf, um die Spalte an eine andere Stelle zu setzen. |
reorderableRows | boolean | false | Ob eine Zeile gezogen werden darf, um sie an eine andere Stelle zu setzen. Per Tastatur verschiebt Alt+Umschalt mit Pfeil nach oben oder unten die Zeile des Cursors um eine Stelle, und die neue Position wird vorgelesen. |
rowHandleLabel | string | '' | Der zugängliche Name des Ziehgriffs einer Zeile. |
columnWidths | Record<string, number> | {} | Die Breite jeder Spalte in Pixeln, indiziert über den Alias. Zwei-Wege: Das Blatt schreibt sie, während der Leser zieht, und Sie können sie persistieren. |
minColumnWidth | number | 48 | Die geringste Breite, auf die eine Spalte gezogen werden darf. |
virtual | boolean | false | Zeichnet nur die Zeilen, die das Sichtfenster abdeckt, und reserviert die Höhe der übrigen — für ein Blatt mit Tausenden. Standardmäßig aus, und es kostet etwas: die Zeilen außerhalb der Sicht stehen nicht im Dokument, also erreichen die Suche des Browsers und der Druck nur das Gezeichnete, und die Zeilen müssen gleich hoch sein. Das Einschalten gibt dem Blatt außerdem 24rem Höhe, denn frei wachsend ist es so hoch wie sein Inhalt und dann gibt es nichts zu virtualisieren. |
rowHeight | number | 0 | Wie hoch eine Zeile beim Virtualisieren ist, in Pixeln. Null misst die erste gezeichnete Zeile, was passt, solange die Zeilen gleich sind. Für ein im Verborgenen gebautes Blatt angeben: eine nie gesetzte Zeile misst null, und ein aus null errechnetes Fenster ist das ganze Blatt. |
formulas | boolean | false | Ob eine Zelle, deren Wert mit = beginnt, eine Formel ist. Aus, bis darum gebeten wird: eine Textspalte darf =1+1 durchaus als das enthalten, was jemand geschrieben hat. Eine Formel kann eine Spalte über ihren Alias benennen — =[units] * [price], =SUM([total:]) —, was nach dem Verschieben einer Spalte oder dem Umschreiben einer Überschrift dasselbe bedeutet, oder über eine Koordinate, wie ein Tabellenprogramm sie schreibt — =ROUND(SUM(E1:E4), 2) —, die sagt, wo eine Spalte war, nicht welche sie ist; rewriteRowFormulas() zieht diese mit dem Blatt mit, und ein Verweis auf etwas Gelöschtes wird #REF! statt still die Nachbarspalte zu lesen. Der Doppelpunkt liest die ganze Spalte und lässt die fragende Zelle aus; jeder andere Kreis erscheint als #CYCLE!, statt verfolgt zu werden. |
mergeable | boolean | false | Ob die Leserin Zellen verbinden und wieder trennen darf, angeboten im Kontextmenü — dafür braucht es auch contextMenu. Aus, bis darum gebeten wird, wie jede Strukturänderung. |
editOn | 'click' | 'double-click' | 'double-click' | Was den Editor mit dem Zeiger öffnet. Ein Doppelklick als Vorgabe, die Tabellenkalkulations-Konvention: ein Klick wählt die Zelle und lässt ihren Wert in Ruhe, das erste getippte Zeichen öffnet den Editor und landet darin, und eine Zelle mit Liste oder Datum zeigt eine Marke, die sie mit einem Klick öffnet. Mit click öffnet schon der erste, für ein Blatt, in das geschrieben wird. So oder so öffnet der Editor beim Loslassen und nur, wenn der Zeiger nicht gewandert ist, sodass das Aufziehen eines Bereichs weiterhin funktioniert. |
expansion | TemplateRef<HubSpreadsheetExpansionContext<TRow>> | null | null | Eine Vorlage unter der geöffneten Zeile, mit dem, was die Zeile hinter ihren Zahlen birgt. |
expandedRow | string | null | null | Zweiseitig. Welche Zeile offen ist, über ihren Schlüssel; eine Zeile zugleich. |
expandToggle | boolean | false | Zeichnet einen kleinen Knopf an den Rändern jeder Zeile, die ein Detail öffnet, damit der Leser es ohne eigenen Knopf öffnet. |
expandToggleLabel | string | '' | Der zugängliche Name dieses Knopfes; das Blatt führt kein Wörterbuch. |
rowLevel | (row: TRow) => number | undefined | () => 0 | Wie tief eine Zeile in einer Gliederung sitzt: 1 in einer Falte, 2 in zwei, und 0 oder nichts außerhalb jeder Falte. |
collapsedRows | readonly string[] | [] | Zweiweg. Welche Zeilengruppen gefaltet sind, nach Gruppen-id. |
collapsedColumns | readonly string[] | [] | Zweiweg. Welche Spaltengruppen gefaltet sind, nach Gruppen-id. |
rowToggleLabel | string | '' | Der zugängliche Name des Knopfes einer Zeilengruppe. |
columnToggleLabel | string | '' | Der zugängliche Name des Knopfes einer Spaltengruppe. |
direction | 'auto' | 'ltr' | 'rtl' | 'auto' | In welche Richtung das Blatt läuft. auto folgt der Seite — ein Blatt in einem rechtsläufigen Artikel liest sich wie der Artikel, da dir vererbt wird —, während ltr und rtl es für ein Blatt erzwingen, das gegen die umgebende Seite laufen muss. |
contextMenu | boolean | false | Ob ein Rechtsklick das Menü der strukturellen Änderungen anbietet. Jeder Eintrag muss weiterhin die Berechtigungen bestehen, und das Menü wird nie leer geöffnet. |
columns[].kind | 'text' | 'number' | 'currency' | 'date' | 'boolean' | 'select' | 'text' | Wie die Spalte ihre Werte anzeigt und das Eingegebene zurückliest. Eine select-Spalte öffnet eine Liste und lehnt alles ab, was nicht darin steht; eine boolean-Spalte zeichnet eine Checkbox, die sich mit einem Klick umschaltet; eine Datumsspalte öffnet ein Datumsfeld. |
columns[].formula | string | — | Eine Formel, aus der jede Zelle dieser Spalte entsteht — im Code deklariert statt in den Daten gehalten: eine Zeilensumme, eine Steuer, ein laufender Saldo. Das Gegenteil einer Formel, die eine Leserin tippt und die ein Wert der Zeile ist. Zellen einer solchen Spalte lassen sich gar nicht bearbeiten: eine zu ersetzen verlöre die Formel für genau diese Zeile, und das merkt niemand, bis die Summen nicht mehr stimmen. Braucht formulas am Blatt. |
columns[].placeholder | string | — | Ein Hinweis, der in einer leeren Zelle dieser Spalte angezeigt wird, solange der Zeiger darauf ruht. Nie anstelle eines Werts: Eine Spalte mit dauerhaft sichtbaren Hinweisen liest sich wie eine Spalte mit Inhalt. |
columns[].append | HubSpreadsheetAppend<TRow> | — | Ein zweiter Wert, der nach dem Hauptwert angezeigt und aus einer kurzen Liste gewählt wird: die Einheit nach einer Menge, die Rabattart nach ihrem Betrag. Eine Änderung kommt als commit an, dessen Spaltenschlüssel append.key ist. Kopieren schreibt beide Teile; CSV und XLSX exportieren nur den Hauptwert. |
columns[].options | readonly HubSpreadsheetOption[] | — | Die Antworten, die eine select-Spalte anbietet. Eine Zelle zeigt das passende Label statt des gespeicherten Werts und fällt auf den Rohwert zurück, wenn nichts passt, sodass eine Zeile mit einer ausgemusterten Option lesbar bleibt. |
structure | HubSpreadsheetStructureOptions<TRow> | {} | Welche strukturellen Änderungen der Leser anfordern darf. Alles wird abgelehnt, bis es erlaubt ist. |
retiredColumnKeys | readonly string[] | [] | Aliasse gelöschter Spalten, damit eine neue nie eine tote Identität erbt. |
hubSpreadsheetCell (directive on ng-template)Erforderlich | string | — | Alias der Spalte, deren Zellen von dieser Vorlage statt vom Standard-Renderer gezeichnet werden. Gebunden wird das Direktiven-Attribut selbst: hubSpreadsheetCell="state". |
hubSpreadsheetCellRows (hubSpreadsheetCell) | readonly TRow[] | [] | Dieselben Zeilen, die dem Sheet übergeben werden. Nichts liest sie; sie dienen nur dazu, dass der Compiler die Zeile im Vorlagenkontext typisieren kann. |
hubSpreadsheetCellAction (hubSpreadsheetCell) | string | ((row: TRow) => boolean) | '' | Kennzeichnet die Spalte als eine, deren Zellen sich zu etwas öffnen, und legt den zugänglichen Namen dieses Zugangs fest. Eine Funktion entscheidet pro Zeile. Enter bleibt zum Öffnen reserviert, und die Betätigung wird über opened gemeldet. |
hubSpreadsheetEditor (directive on ng-template)Erforderlich | string | — | Alias der Spalte, deren Editor von dieser Vorlage statt vom integrierten gezeichnet wird. Gebunden wird das Direktiven-Attribut selbst: hubSpreadsheetEditor="assignee". |
hubSpreadsheetEditorRows (hubSpreadsheetEditor) | readonly TRow[] | [] | Dieselben Zeilen, die dem Sheet übergeben werden. Nichts liest sie; sie dienen nur dazu, dass der Compiler die Zeile im Vorlagenkontext typisieren kann. |
hubSpreadsheetControl (directive on ng-container)Erforderlich | HubSpreadsheetControlConfig | — | Rendert einen Zelleneditor über den Control-Adapter, der mit provideHubSpreadsheetControls() registriert wurde. Die Konfiguration wird einmal gelesen, wenn der Editor geöffnet wird. |
value (hub-spreadsheet-field, ng-hub-ui-spreadsheet/signals) | TRow[] | [] | Two-Way-Modell (mit [(value)] verwenden), das die Zeilen als Wert des Signal-Forms-Feldes hält; es wird zurückgeschrieben, sobald der Leser eine Zelle ändert. Löst valueChange aus. |
disabled (hub-spreadsheet-field) | boolean | false | Wird von der Signal-Forms-FormField-Direktive gebunden; deaktiviert alle Editoren. |
errors (hub-spreadsheet-field) | readonly ValidationError.WithOptionalFieldTree[] | [] | Wird von der Signal-Forms-FormField-Direktive gebunden. Hier kommen nur die eigenen Fehler des Array-Feldes an, daher werden sie als Ganzes angezeigt, nicht pro Zelle. hub-spreadsheet-field akzeptiert außerdem columns, rowKey, states, decimalMark, emptyText, pageSize, readonly, frozenColumns, frozenRows und spans mit derselben Bedeutung wie bei hub-spreadsheet und löst selectionChange aus. |
Outputs
Reagiere darauf, was spreadsheet tut — 21 Events, an die du deine Logik anknüpfen kannst.
| Name | Typ | Beschreibung |
|---|---|---|
commit | HubSpreadsheetCommit<TRow> | Eine Zelle hat einen neuen Wert angenommen, der sich vom bisherigen unterscheidet. |
pasted | HubSpreadsheetPaste<TRow> | Ein Block wurde eingefügt, samt Zählung dessen, was außerhalb des Blatts landete und was keine Zahl war. |
cleared | HubSpreadsheetCellRef<TRow>[] | Entf oder Rücktaste wurde über mehreren Zellen oder über einer Listen- bzw. Ja/Nein-Zelle gedrückt; enthält die betroffenen bearbeitbaren Zellen. Eine einzelne Textzelle öffnet stattdessen ihren Editor leer. |
opened | HubSpreadsheetCellRef<TRow> | Die Aktion einer Zelle wurde benutzt — mit dem Zeiger, oder mit Enter, wo es kein Feld zum Bearbeiten gibt. |
selectionChange | HubGridRange | null | Das ausgewählte Rechteck hat sich geändert. |
filled | HubSpreadsheetPaste<TRow> | Ein Ziehen des Ausfüllkästchens ist beendet, gemeldet als ein einziges Ereignis für die ganze Geste. |
undoRequested | void | Der Leser hat Rückgängig angefordert. |
redoRequested | void | Der Leser hat Wiederholen angefordert. |
columnMoved | { from: number; to: number; key: string; keys: string[] } | Eine Spalte wurde an anderer Stelle abgelegt. Gemeldet, nicht angewendet: Die Nutzlast enthält die bereits neu geordneten Aliasse. |
rowMoved | { from: number; to: number; key: string; keys: string[] } | Eine Zeile wurde an eine andere Stelle abgelegt. Gemeldet, nicht angewendet: die Nutzlast trägt die bereits neu geordneten Schlüssel. |
invalidDraftsChange | Record<string, string> | Der ungespeicherte Text hat sich geändert: Der Leser hat eine Zelle mit Text verlassen, den sie nicht speichern kann, oder einen solchen korrigiert, verworfen oder überschrieben. |
mergeRequested | HubSpreadsheetMergeRequest | Es wurde um das Verbinden einer Auswahl gebeten. Die Nutzlast trägt den neuen Block und die Anker der Blöcke, die er schluckt: wer nur anhängt, hat zwei Blöcke auf derselben Zelle. applySpanMerge() erledigt es in einer Zeile. |
unmergeRequested | readonly HubGridCoords[] | Es wurde darum gebeten, die von der Auswahl berührten Blöcke zu trennen, benannt über ihre Anker. applySpanUnmerge() wendet es an. |
selectionRangesChange | readonly HubGridRange[] | Jedes Rechteck der Auswahl, sobald sie sich ändert. Neben selectionChange, das weiterhin das mit dem Cursor meldet: wer die Summe der Auswahl zeigt, braucht alle; wer „Sie sind in B4“ zeigt, nicht. Ein Eintrag, sofern nicht Blöcke mit Ctrl gewählt wurden. |
insertRequested | HubSpreadsheetInsertRequest | The reader asked to add rows or columns. Ein zu langes Einfügen fordert so die fehlenden Zeilen an, mit count als deren Anzahl. |
deleteRequested | HubSpreadsheetDeleteRequest | Der Leser hat angefordert, Zeilen oder Spalten zu entfernen, und nennt die betroffenen Aliasse. |
valueChange (hub-spreadsheet-field) | TRow[] | Wird vom Two-Way-Modell value ausgelöst, wenn sich die Zeilen ändern. |
columnWidthsChange | Record<string, number> | Wird vom Two-Way-Modell columnWidths ausgelöst, wenn der Leser die Breite einer Spalte ändert. |
expandedRowChange | string | null | Wird vom Two-Way-Modell expandedRow ausgelöst, wenn eine Zeile auf- oder zugeklappt wird. |
collapsedColumnsChange | readonly string[] | Wird vom Two-Way-Modell collapsedColumns ausgelöst, wenn Spaltengruppen ein- oder ausgeklappt werden. |
collapsedRowsChange | readonly string[] | Wird vom Two-Way-Modell collapsedRows ausgelöst, wenn Zeilengruppen ein- oder ausgeklappt werden. |
Methoden
Steuere spreadsheet aus dem Code heraus — 19 Methoden auf der programmatischen Schnittstelle.
| Name | Signatur | Rückgabe | Beschreibung |
|---|---|---|---|
HubSpreadsheetComponent.focusCell | focusCell(rowKey: string, column?: string): void | — | Setzt den Cursor und die Tastatur auf eine Zelle, nach Zeilenschlüssel und Spaltenalias. Wartet auf eine gerade hinzugefügte Zeile und landet ohne Alias in ihrer ersten beschreibbaren Zelle, sodass die nächste Taste sie öffnet. |
HubSpreadsheetComponent.editCell | editCell(rowKey: string, column?: string): void | — | Öffnet den Editor einer Zelle per Code und behält ihren Wert, wie F2. Wartet wie focusCell auf eine gerade hinzugefügte Zeile; bei einer nicht bearbeitbaren Zelle setzt es nur den Cursor. |
sheetToXlsx | sheetToXlsx<TRow>(rows, columns, options?: HubXlsxOptions): Uint8Array | Uint8Array | Das Blatt als echtes .xlsx, als Bytes. Zahlen bleiben Zahlen, und eine Datumsspalte wird ein Datum — was ein CSV nicht tragen kann. Geschrieben wird, was die Zelle zeigt: eine Listenspalte exportiert ihr Label, eine Formel ihr Ergebnis, sofern nicht values: 'stored' das Gespeicherte verlangt. |
downloadXlsx | downloadXlsx(filename: string, bytes: Uint8Array): void | — | Gibt der Leserin diese Arbeitsmappe zum Speichern und hängt .xlsx an, wenn es fehlt. Hier, weil jeder Host die gleichen sechs Zeilen schreibt und die Object-URL nicht freigibt. |
xlsxToRecords | xlsxToRecords<TRow>(bytes, columns, options?: HubXlsxReadOptions): Promise<Array<Record<string, string>>> | Promise<Array<Record<string, string>>> | Liest das erste Blatt einer Arbeitsmappe in Zeilen, die nach Spaltenalias benannt sind, und macht die zwei Dinge rückgängig, die ein CSV nie tut: gemeinsame Zeichenketten und Datumsangaben als Tageszahl. Asynchron, weil eine echte Arbeitsmappe komprimiert ist und der Dekompressor der der Plattform ist. |
sheetToCsv | sheetToCsv<TRow>(rows, columns, options?: HubCsvOptions): string | string | Das Blatt als CSV. Ohne angegebenes Trennzeichen kommt es vom Dezimalzeichen — ein Komma kann nicht trennen, was es auch gliedert — also bekommt eine Datei, die dort gelesen wird, wo man 1.234,56 schreibt, Semikolons. |
downloadText | downloadText(filename: string, text: string, type?: string): void | — | Gibt der Leserin eine Textdatei zum Speichern, mit der Byte-Order-Mark, die ein Tabellenprogramm dazu bringt, sie als UTF-8 statt als Zeichensalat zu öffnen. |
csvToRecords | csvToRecords<TRow>(text, columns, options?: HubCsvOptions): Array<Record<string, string>> | Array<Record<string, string>> | Liest ein CSV in Zeilen nach Spaltenalias und schnuppert das Trennzeichen in der ersten Zeile, statt es anzunehmen. Überschriften werden zuerst über die Überschrift, dann über den Alias zugeordnet, ohne Rücksicht auf Groß- und Kleinschreibung oder Leerraum. |
sheetValues | sheetValues<TRow>(rows, columns, options?: HubSheetValuesOptions): HubSpreadsheetValue[][] | HubSpreadsheetValue[][] | Was jede Zelle enthält, mit ausgerechneten Formeln und einer gescheiterten so geschrieben, wie ein Tabellenprogramm sie schreibt. Genau das lesen beide Exporte — offengelegt für einen Host, der seine eigene Datei schreibt. |
evaluateSheet | evaluateSheet<TRow>(input: HubFormulaSheetInput<TRow>): HubFormulaSheet | HubFormulaSheet | Führt jede Formel eines Blattes aus, in der Reihenfolge, die die Abhängigkeiten verlangen, bei Bedarf berechnet und behalten. Ein Kreis wird erkannt, sobald er sich schließt, statt verfolgt zu werden. Offengelegt für einen Host, der die Ergebnisse ohne Darstellung braucht. |
rewriteRowFormulas | rewriteRowFormulas<TRow extends object>(rows, change: HubFormulaShapeChange): TRow[] | TRow[] | Verschiebt jede Koordinate in den Zeilen, wenn das Blatt seine Form ändert: eine verschobene Spalte, eingefügte oder gelöschte Zeilen und Spalten. Ein Verweis auf Gelöschtes wird #REF! statt still die Nachbarspalte zu lesen. Der Host ruft es auf, denn die Zeilen sind seine. |
mergeRequestFor | mergeRequestFor(spans, range): HubSpreadsheetMergeRequest | null | HubSpreadsheetMergeRequest | null | Der Block, zu dem eine Auswahl würde, und die Anker, die er verschluckt; null bei einer einzelnen Zelle. Die verschluckten Anker sind der Teil, den ein Host allein falsch macht: angehängt, ohne sie zu entfernen, beanspruchen zwei Blöcke dieselbe Zelle. |
applySpanMerge | applySpanMerge(spans, request: HubSpreadsheetMergeRequest): HubGridSpan[] | HubGridSpan[] | Die Liste der Blöcke nach dieser Verbindung, ohne die verschluckten. |
applySpanUnmerge | applySpanUnmerge(spans, anchors: readonly HubGridCoords[]): HubGridSpan[] | HubGridSpan[] | Die Liste der Blöcke, nachdem diese aufgelöst sind. |
spreadsheetRecords | spreadsheetRecords<TRow>(rows, columns): HubSpreadsheetRecord[] | HubSpreadsheetRecord[] | Jede Zeile als einfache Daten nach Spaltenalias, damit man mit { price: 12, units: 3 } arbeitet statt Koordinaten über die Position auf eigene Felder abzubilden. |
parseForColumn | parseForColumn<TRow>(text, column, decimalMark: ',' | '.'): HubSpreadsheetValue | undefined | HubSpreadsheetValue | undefined | Was eine getippte oder eingefügte Zeichenkette in einer Spalte wert ist: der Wert, null für eine leere Zelle und undefined für etwas, das die Spalte nicht halten kann — womit der Aufrufer ablehnen kann, statt Unsinn zu speichern. |
nextColumnKey | nextColumnKey(taken: Iterable<string>, prefix?: string): string | string | Ein Alias, der noch nie zu einer anderen Spalte gehört hat: eine neue Spalte verwendet also keinen stillgelegten Namen wieder, und kein gespeicherter Verweis kann auf das Falsche zeigen. |
danglingColumnKeys | danglingColumnKeys<TRow>(referenced: Iterable<string>, columns): string[] | string[] | Verweise, die auf keine Spalte mehr zeigen — also das, was eine Löschung ins Leere zeigen ließe. |
provideHubSpreadsheetControls | provideHubSpreadsheetControls(adapter: HubSpreadsheetControlsAdapter): EnvironmentProviders | EnvironmentProviders | Registriert einen Control-Adapter; jede Listenspalte öffnet dann mit ihm — suchbar, schon offen, mit dem Zeichen, das die Zelle geöffnet hat, in ihrem Suchfeld. Ohne Adapter zeichnet das Blatt seine native Liste, was es allein installierbar hält. |
Templates
Mach es zu deinem — 3 Template-Slots lassen dich eigenes Markup projizieren.
| Name | Beschreibung | Beispiel |
|---|---|---|
hubSpreadsheetEditor | Ersetzt den Editor einer Spalte, benannt über ihren Alias. Das Template bekommt den Wert, das Paar commit und cancel, draft, um einen Wert zu halten, ohne zu schließen, sowie `seed` — das Zeichen, mit dem die Zelle durch Tippen geöffnet wurde und das ins Suchfeld einer Auswahl gehört. Die Tabelle schließt ihn wie ihren eigenen Editor: Escape unverändert, sobald eine darin geöffnete Liste zu ist; Tab mit dem, was draft hält; und ebenso, wenn der Fokus woandershin geht, außer in das Popup, das eines seiner Steuerelemente über aria-controls benennt, wie die Liste von hub-select. Alle anderen Tasten gehören dem Editor, Enter eingeschlossen. Die Tabelle hängt von nichts ab, was Sie hineinsetzen. | <ng-template hubSpreadsheetEditor="assignee" let-value let-seed="seed" let-commit="commit">
<hub-select [items]="people" autoOpen [initialSearchTerm]="seed ?? null" [ngModel]="value" (ngModelChange)="commit($event)" />
</ng-template> |
hubSpreadsheetCell | Zeichnen Sie die Zellen einer Spalte selbst, solange sie nicht bearbeitet werden: ein Abzeichen für einen Zustand, ein Avatar neben einem Namen, eine Reihe von Aktionen. Das Gegenstück zu hubSpreadsheetEditor, das die andere Hälfte des Zellenlebens abdeckt. Die Zwischenablage trägt weiterhin den Wert und nicht die Zeichnung, und die Zelle bleibt das, worauf die Tastatur steht. Über hubSpreadsheetCellRows die Zeilen übergeben, und der Compiler weiß, was `row` ist. | <ng-template hubSpreadsheetCell="state" let-value>
<hub-badge variant="soft" [color]="colourOf(value)">{{ labelOf(value) }}</hub-badge>
</ng-template> |
hubSpreadsheetHeader | Zeichnet den Titel einer Spaltenüberschrift selbst: ein Symbol neben dem Namen, eine Schaltfläche, die die Spalte bearbeitet. Das Gegenstück zu hubSpreadsheetCell für die Überschrift. Das <th> bleibt das des Blatts, mit Breite, Fixierung, Sticky-Position und Alle-auswählen-Kästchen. Eine Schaltfläche, ein Link oder ein Feld darin lässt sich drücken, ohne die Spalte zu ziehen. Die Vorlage erhält die Spalte, ihren index, ihren key und den header als Text. | <ng-template hubSpreadsheetHeader="price" let-column>
{{ column.header }} <button type="button" (click)="editPrice()">Edit</button>
</ng-template> |