Svelte-Awesome

适用于 Svelte JS 的超赞 SVG 图标组件,采用 Font Awesome 图标构建。基于 Justineo/vue-awesome。「Awesome SVG icon component for Svelte JS, built with Font Awesome icons. Based on Justineo/vue-awesome」

Github stars Tracking Chart

Svelte-Awesome

GitHub Workflow Status
Codacy grade
npm
bundlephobia
PRs Welcome

Awesome SVG icon component for Svelte JS, built with Font Awesome icons.
Based on Justineo/vue-awesome

Svelte-Awesome supports Font-Awesome v4.7.0 (icons inbuilt)
and v5/v6 (via @fortawesome npm packages)

A demo is available here

A list of all available embedded icons is available here

Installation

NPM

npm install --save svelte-awesome

Usage

<!-- basic -->
<Icon data="{beer}" />
<!-- codeFork is camelCase, unlike the js file, code-fork.js -->
<Icon data="{codeFork}" />

<!-- with options -->
<Icon data="{refresh}" scale="2" />
<Icon data="{comment}" flip="horizontal" />
<Icon data="{codeFork}" label="Forked Repository" />

<!-- stacked icons [WIP] -->
<Icon label="No Photos">
  <Icon data="{camera}" />
  <Icon name="{ban}" scale="2" class="alert" />
</Icon>

<!-- FontAwesome v5 and v6 Icons supported -->
<Icon data="{faThumbsUp}" />

<script>
  import Icon from 'svelte-awesome';

  /// *** Embedded Icons ***
  // Recommended - import just the icon you need
  import beer from 'svelte-awesome/icons/beer';
  import refresh from 'svelte-awesome/icons/refresh';
  import codeFork from 'svelte-awesome/icons/codeFork';
  import camera from 'svelte-awesome/icons/camera';
  import ban from 'svelte-awesome/icons/ban';
  // Not recommended as it will download all of the icons in dev mode
  import { ban } from 'svelte-awesome/icons';

  // EDGECASE ICONS - different names due to reserved names / starting with numbers
  import fa500px from 'svelte-awesome/icons/fa500px'; // '500px' icon
  import faTry from 'svelte-awesome/icons/faTry'; // 'try' icon

  /// *** @fortawesome/* Icons ***
  // Recommended - import the individual icon a little like with the recommended embedded icons approach above
  import { faThumbsUp } from '@fortawesome/free-regular-svg-icons/faThumbsUp';
  // Not Recommended - import the individual icon from the main file - it will download all of the icons in dev mode
  import { faThumbsUp } from '@fortawesome/free-regular-svg-icons';
</script>

Sapper Usage

For Sapper, you may need to import the Icon component explicitly as below:

import Icon from 'svelte-awesome/components/Icon.svelte';

Contributors

Contributors

Main metrics

Overview
Name With OwnerRobBrazier/svelte-awesome
Primary LanguageTypeScript
Program languageJavaScript (Language Count: 7)
Platform
License:MIT License
所有者活动
Created At2017-11-13 22:37:24
Pushed At2025-04-21 06:53:40
Last Commit At2025-01-20 08:07:11
Release Count38
Last Release Namev3.3.5 (Posted on 2024-10-22 13:49:58)
First Release Namev1.0.0 (Posted on )
用户参与
Stargazers Count500
Watchers Count7
Fork Count25
Commits Count1.5k
Has Issues Enabled
Issues Count57
Issue Open Count3
Pull Requests Count841
Pull Requests Open Count6
Pull Requests Close Count356
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private