Angular Utility-Bibliothek | ng-hub-ui-utils
Angular Utility-Bibliothek mit Pipes, Fokusmanagement, Overlays, Transitions und Übersetzungs-Helfern, die von wiederverwendbaren UI-Komponenten gemeinsam genutzt werden.
API-Referenz
Hier ist der vollständige Vertrag für utils: 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 utils mit 5 Inputs ein. Binde sie wie jeden Angular-@Input.
| Name | Typ | Standard | Beschreibung |
|---|---|---|---|
HubTranslationService | Service | - | Injizierbarer Service zur Verwaltung von Übersetzungen. Methoden: getTranslation(), setTranslations() |
HubOverlayService | Service | - | Service zum programmatischen Erstellen und Verwalten von Overlays |
HubPopupService | Service | - | Vereinfachter Service zum Erstellen von Popup-Elementen |
HubTooltipDirective | Directive | - | Direktive ([hubTooltip]), die bei Hover oder Fokus einen positionierten, thematisierbaren Tooltip anzeigt. Eingaben: hubTooltip (Text), hubTooltipPlacement, hubTooltipDelay, hubTooltipOffset. Dank der präfigierten Namen kann sie sich ein Element mit Direktiven teilen, die ein eigenes placement deklarieren, etwa [hubDropdown]. |
TooltipDirective (deprecated) | Directive | - | Veraltet zugunsten von [hubTooltip]. Ihre präfixlosen Eingaben (tooltip, placement, delay, offset) beansprucht jede andere Direktive oder Komponente am Element, die dieselben Namen deklariert. Funktioniert unverändert weiter; die Migration erfolgt Attribut für Attribut. |
Outputs
Reagiere darauf, was utils tut — 7 Events, an die du deine Logik anknüpfen kannst.
| Name | Typ | Beschreibung |
|---|---|---|
TranslatePipe | Pipe | Übersetzt einen Schlüssel mithilfe des HubTranslationService. Verwendung: {{ "key" | translate }} |
GetPipe | Pipe | Ruft den Wert einer verschachtelten Eigenschaft ab. Verwendung: {{ object | get:"path.to.property" }} |
IsStringPipe | Pipe | Prüft, ob der Wert ein String ist. Verwendung: {{ value | isString }} |
IsObjectPipe | Pipe | Prüft, ob der Wert ein Objekt ist. Verwendung: {{ value | isObject }} |
IsObservablePipe | Pipe | Prüft, ob der Wert ein Observable ist. Verwendung: {{ value | isObservable }} |
UcfirstPipe | Pipe | Schreibt den ersten Buchstaben groß. Verwendung: {{ "hello" | ucfirst }} → "Hello" |
UnwrapAsyncPipe | Pipe | Entpackt Observable- oder Promise-Werte in Templates |
Templates
Mach es zu deinem — 4 Template-Slots lassen dich eigenes Markup projizieren.
| Name | Beschreibung | Beispiel |
|---|---|---|
hubFocusTrap() | Fängt den Tastaturfokus innerhalb eines Elements ein. Nützlich für Modals und Dialoge. | hubFocusTrap(zone, element, stopFocusTrap$, refocusOnClick) |
interpolateString() | Ersetzt {{ placeholders }} durch Werte aus einem Objekt | interpolateString("Hello {{name}}", { name: "World" }) → "Hello World" |
getValue() | Ruft eine verschachtelte Eigenschaft mithilfe der Punktnotation ab | getValue(obj, "user.profile.name") |
equals() | Tiefer Gleichheitsvergleich für Objekte und Arrays | equals({ a: 1 }, { a: 1 }) → true |