This is a tiny library for customizing components appearance
npm install @taiga-ui/polymorpheus
Polymorpheus is a tiny library for polymorphic templates in Angular.
It is 1 KB gzip, dependency free and allows you to make pretty cool things.
It abstracts over different ways of view customization in Angular with one simple _structural directive_:
``html`
Content accepts:
- primitives like number or string
- functions that take as argument and return a primitivecontext
- templates that get instantiated with given
- components that would get injected through DI
Context is optional when you need your content to adapt to the situation
Typical use case would be a component that accepts visual customization and defines context by itself. Say a menu list
where you can configure how each item should look like by passing a template. And context would be item itself and, for
example, whether it is focused or not.
Please see extensive demo (wait for packages to install and run
npm start).
You can also
read about this concept in detail.
If you use component content you can inject context with POLYMORPHEUS_CONTEXT token or injectContext helper.
Important: this object is _live_ so if you change it, your component view will be updated as well automatically.
`ts
import {injectContext} from '@taiga-ui/polymorpheus';
@Component({
template: '{{ context.active }}', // <-- this will automatically update
})
export class MyComponent {
protected readonly context = injectContext<{active: boolean}>();
}
`
Alternatively, inputs can be used and will be synced with according context keys:
`ts
import {input} from '@angular/core';
@Component({
template: '{{ active() }}',
})
export class MyComponent {
// Will be automatically updated by context.active changes
protected readonly active = input(false);
}
`
You can use polymorpehus directive to add type to template context:
`typescript`
readonly context!: { $implicit: number };
`html``
[polymorpheus]="context"
let-item
>
{{ item.toFixed(2) }} <-- type 'number'
ng-polymorpheus is a part of Taiga UI libraries family which is backed
and used by a large enterprise. This means you can rely on timely support and continuous development.