mirror of
https://github.com/iconify/iconify.git
synced 2024-11-09 14:50:56 +00:00
Update readme
This commit is contained in:
parent
a2591dbe36
commit
38926d087a
17
README.md
17
README.md
@ -53,7 +53,7 @@ Main packages:
|
||||
|
||||
### Iconify icon components
|
||||
|
||||
Directory `component` contains Iconify icon components and SVG framework.
|
||||
Directory `components` contains Iconify icon components and SVG framework.
|
||||
|
||||
| Package | Usage |
|
||||
| ---------------------------------------- | ------ |
|
||||
@ -64,6 +64,21 @@ Directory `component` contains Iconify icon components and SVG framework.
|
||||
| [Svelte component](./components/svelte/) | Svelte |
|
||||
| [Ember component](./components/ember/) | Ember |
|
||||
|
||||
#### Deprecation notice
|
||||
|
||||
Components in directory `components` are slowly phased out in favor of `iconify-icon` web component. Functionality is identical, but web component has some advantages:
|
||||
|
||||
- No framework specific shenanigans. Events and attributes are supported for all frameworks.
|
||||
- Works better with SSR (icon is rendered only in browser, but because icon is contained in shadow DOM, it does not cause hydration problems).
|
||||
- Better interoperability. All parts of applicaiton reuse same web component, even if those parts are written in different frameworks.
|
||||
|
||||
Deprecation status:
|
||||
|
||||
- SVG Framework: can be replaced with `iconify-icon`.
|
||||
- Ember component: can be replaced with `iconify-icon`, does not require Ember specific wrapper.
|
||||
|
||||
To import web component, just import it once in your script, as per [`iconify-icon` README file](./iconify-icon/icon/README.md).
|
||||
|
||||
#### Demo
|
||||
|
||||
Directory `components-demo` contains demo packages that show usage of icon components.
|
||||
|
Loading…
Reference in New Issue
Block a user