# svelte-fa [![npm][badge-version]][npm] [![bundle size][badge-size]][bundlephobia] [![npm downloads][badge-downloads]][npm] [![license][badge-license]][license] [![github][badge-issues]][github] [![build][badge-build]][workflows] [![coverage][badge-coverage]][coveralls] Tiny [FontAwesome][fontawesome] component for [Svelte][svelte]. * FontAwesome version 5 and 6 * FontAwesome svg icons * Tree-shakable, only import used icons * No CSS file required * FontAwesome layering * FontAwesome duotone icons [Documents and examples][doc]. ## Installation ```shell npm install svelte-fa ``` Install FontAwesome icons via [official packages][fontawesome-npm], for example: ```shell npm install @fortawesome/free-solid-svg-icons npm install @fortawesome/free-brands-svg-icons ``` Icons gallery: [FontAwesome icons][fontawesome-icons] ### Work with [Sapper][sapper] You may need to install the component as a devDependency: ```shell npm install svelte-fa -D ``` ### Work with [SvelteKit][sveltekit]/[Vite][vite] You may need to import the component explicitly as below: ```js import Fa from 'svelte-fa/dist/fa.svelte' import { faCaretDown, faCaretUp } from '@fortawesome/free-solid-svg-icons/index.es' ``` When using typescript with SvelteKit/Vite, you may also needed to add type definitions that redirect to the non-`index.es` export: ```ts // app.d.ts declare module '@fortawesome/pro-solid-svg-icons/index.es' { export * from '@fortawesome/pro-solid-svg-icons'; } ``` ## Usage ```html ``` ## `Fa` Properties ```html ``` * `icon`: icon from [FontAwesome packages][fontawesome-npm], for example: `@fortawesome/free-solid-svg-icons`, icons gallery: [FontAwesome icons][fontawesome-icons] * `class`: `string` values `${your preffered any css class}` * `size`: `string` values `xs`, `sm`, `lg` or `2x`, `3x`, `4x`, ..., `${number}x` * `color`: `string` icon color, default `currentColor` * `fw`: `boolean` fixed width * `pull`: `string` values `left`, `right` * `scale`: `number | string` transform scale, unit is `em`, default `1` * `translateX`: `number | string` transform position X, unit is `em`, default `0` * `translateY`: `number | string` transform position Y, unit is `em`, default `0` * `flip`: `string` values `horizontal`, `vertical`, `both` * `rotate`: `number | string` values `90`, `180`, `270`, `30`, `-30` ... * `spin`: `boolean` spin icons * `pulse`: `boolean` pulse spin icons ## Layering & Text ```js import Fa, { FaLayers, FaLayersText, } from 'svelte-fa'; ``` ```html NEW ``` ### `FaLayers` Properties * `size`: `string` values `xs`, `sm`, `lg` or `2x`, `3x`, `4x`, ..., `${number}x` * `pull`: `string` values `left`, `right` ### `FaLayersText` Properties * `size`: `string` values `xs`, `sm`, `lg` or `2x`, `3x`, `4x`, ..., `${number}x` * `color`: `string` icon color, default `currentColor` * `scale`: `number | string` transform scale, unit is `em`, default `1` * `translateX`: `number | string` transform position X, unit is `em`, default `0` * `translateY`: `number | string` transform position Y, unit is `em`, default `0` * `flip`: `string` values `horizontal`, `vertical`, `both` * `rotate`: `number | string` values `90`, `180`, `270`, `30`, `-30` ... ## Duotone Icons ```html ``` ### Duotone Icons Theme ```html ``` ## Contributors
Cweili
Cweili
marekdedic
Marek Dědič
gtm-nayan
Gtmnayan
ItzaMi
Rui Sousa
theodorejb
Theodore Brown
msanguineti
Mirco Sanguineti
RealA10N
Alon Krymgand
connercsbn
Conner
prokawsar
Kawsar Ahmed
mvolkmann
Mark Volkmann
ModischFabrications
Robin Modisch
RemiKalbe
Rémi Kalbe
hawk93
Null
[fontawesome-icons]: https://fontawesome.com/icons [fontawesome]: https://fontawesome.com/ [fontawesome-npm]: https://www.npmjs.com/search?q=%40fortawesome%20svg%20icons [svelte]: https://svelte.dev/ [sapper]: https://sapper.svelte.dev/ [sveltekit]: https://kit.svelte.dev/ [vite]: https://www.npmjs.com/package/vite [doc]: https://cweili.github.io/svelte-fa/ [badge-version]: https://img.shields.io/npm/v/svelte-fa.svg [badge-downloads]: https://img.shields.io/npm/dt/svelte-fa.svg [npm]: https://www.npmjs.com/package/svelte-fa [badge-size]: https://img.shields.io/bundlephobia/minzip/svelte-fa.svg [bundlephobia]: https://bundlephobia.com/result?p=svelte-fa [badge-license]: https://img.shields.io/npm/l/svelte-fa.svg [license]: https://github.com/Cweili/svelte-fa/blob/master/LICENSE [badge-issues]: https://img.shields.io/github/issues/Cweili/svelte-fa.svg [github]: https://github.com/Cweili/svelte-fa [badge-build]: https://img.shields.io/github/actions/workflow/status/Cweili/svelte-fa/ci.yml?branch=master [workflows]: https://github.com/Cweili/svelte-fa/actions/workflows/ci.yml?query=branch%3Amaster [badge-coverage]: https://img.shields.io/coveralls/github/Cweili/svelte-fa/master.svg [coveralls]: https://coveralls.io/github/Cweili/svelte-fa?branch=master