Библиотека утилит для Angular | ng-hub-ui-utils
Библиотека утилит для Angular с pipe, управлением фокусом, оверлеями, переходами и хелперами перевода, общими для переиспользуемых UI-компонентов.
Справочник API
Вот полный контракт utils: всё, что можно привязать, прослушать, спроецировать и тематизировать, собрано в одном месте. Подключите то, что нужно, и оформите так, как хотите — это standalone и дружит с сигналами.
Входные свойства
Настройте utils с помощью 5 входных свойств. Привязывайте их, как любой @Input в Angular.
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
HubTranslationService | Service | - | Injectable service для управления переводами. Методы: getTranslation(), setTranslations() |
HubOverlayService | Service | - | Service для программного создания и управления overlays |
HubPopupService | Service | - | Упрощённый service для создания popup-элементов |
HubTooltipDirective | Directive | - | Директива ([hubTooltip]), показывающая позиционируемую и тематизируемую подсказку при наведении или фокусе. Входы: hubTooltip (текст), hubTooltipPlacement, hubTooltipDelay, hubTooltipOffset. Префиксы позволяют ей делить элемент с директивами, объявляющими собственный placement, например [hubDropdown]. |
TooltipDirective (deprecated) | Directive | - | Устарела в пользу [hubTooltip]. Её входы без префикса (tooltip, placement, delay, offset) забирает любая другая директива или компонент на элементе, объявляющие те же имена. Продолжает работать без изменений; миграция — атрибут за атрибутом. |
События
Реагируйте на то, что делает utils, — 7 событий, к которым можно подключить вашу логику.
| Имя | Тип | Описание |
|---|---|---|
TranslatePipe | Pipe | Переводит ключ с помощью HubTranslationService. Использование: {{ "key" | translate }} |
GetPipe | Pipe | Получает значение вложенного свойства. Использование: {{ object | get:"path.to.property" }} |
IsStringPipe | Pipe | Проверяет, является ли значение строкой. Использование: {{ value | isString }} |
IsObjectPipe | Pipe | Проверяет, является ли значение объектом. Использование: {{ value | isObject }} |
IsObservablePipe | Pipe | Проверяет, является ли значение Observable. Использование: {{ value | isObservable }} |
UcfirstPipe | Pipe | Делает первую букву заглавной. Использование: {{ "hello" | ucfirst }} → "Hello" |
UnwrapAsyncPipe | Pipe | Разворачивает значения Observable или Promise в шаблонах |
Шаблоны
Сделайте его своим — 4 слотов шаблона позволяют проецировать собственную разметку.
| Имя | Описание | Пример |
|---|---|---|
hubFocusTrap() | Удерживает фокус клавиатуры внутри элемента. Полезно для modals и диалогов. | hubFocusTrap(zone, element, stopFocusTrap$, refocusOnClick) |
interpolateString() | Заменяет {{ placeholders }} значениями из объекта | interpolateString("Hello {{name}}", { name: "World" }) → "Hello World" |
getValue() | Получает вложенное свойство с использованием точечной нотации | getValue(obj, "user.profile.name") |
equals() | Глубокое сравнение на равенство для объектов и массивов | equals({ a: 1 }, { a: 1 }) → true |