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.

NameTypStandardBeschreibung
HubTranslationServiceService-Injizierbarer Service zur Verwaltung von Übersetzungen. Methoden: getTranslation(), setTranslations()
HubOverlayServiceService-Service zum programmatischen Erstellen und Verwalten von Overlays
HubPopupServiceService-Vereinfachter Service zum Erstellen von Popup-Elementen
HubTooltipDirectiveDirective-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.

NameTypBeschreibung
TranslatePipePipeÜbersetzt einen Schlüssel mithilfe des HubTranslationService. Verwendung: {{ "key" | translate }}
GetPipePipeRuft den Wert einer verschachtelten Eigenschaft ab. Verwendung: {{ object | get:"path.to.property" }}
IsStringPipePipePrüft, ob der Wert ein String ist. Verwendung: {{ value | isString }}
IsObjectPipePipePrüft, ob der Wert ein Objekt ist. Verwendung: {{ value | isObject }}
IsObservablePipePipePrüft, ob der Wert ein Observable ist. Verwendung: {{ value | isObservable }}
UcfirstPipePipeSchreibt den ersten Buchstaben groß. Verwendung: {{ "hello" | ucfirst }} → "Hello"
UnwrapAsyncPipePipeEntpackt Observable- oder Promise-Werte in Templates

Templates

Mach es zu deinem — 4 Template-Slots lassen dich eigenes Markup projizieren.

NameBeschreibungBeispiel
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 ObjektinterpolateString("Hello {{name}}", { name: "World" }) → "Hello World"
getValue()Ruft eine verschachtelte Eigenschaft mithilfe der Punktnotation abgetValue(obj, "user.profile.name")
equals()Tiefer Gleichheitsvergleich für Objekte und Arraysequals({ a: 1 }, { a: 1 }) → true