quasar-extras-svg-icons v1.37.0

Quasar Framework - Extras SVG Icons package

Build high-performance VueJS user interfaces in record time: responsive Single Page Apps, SSR Apps, PWAs, Browser extensions, Hybrid Mobile Apps and Electron Apps. If you want, all using the same codebase!

Installation

npm install quasar-extras-svg-icons

# or

yarn add quasar-extras-svg-icons

Why?

Why this package? Because it strips down unnecessary package files (so faster download times), all in one place, tested and ready to use with Quasar. One other reason is that this package complements the @quasar/extras package by adding additional SVG Icons that you can use in your Quasar apps. These SVG icons have gone though a process known as flattening. As mentioned, it strips out unnecessay code to make them smaller and more efficient. Unfortunately, not all icon sets meet this criteria and fail.

Additonally, most icon sets have fixed colors. Our flattening process also includes the ability to change these colors to 'currentColor' so you have more control over the way the icon looks when you use our icon sets. Of course, this doesn't apply to some icons sets where the fixed colors are mandatory (like flags). In some cases, we have created a "two-tone" icon set by not only employing the 'currentColor', but then also using 'currentColor' with an opacity in the same icon.

Many of the icon sets are not installable via NPM or NPM version does not coincide with GitHub version (out of sync), so this may be the only way to access them without bloating your project.

Plus, Typescript type definition files are generated so you won't get any warnings when using the icons.

Additionally, everytime there is a major release of an Icon Set, we preserve the previous 2 versions for a total of 3 versions.

Contents

Please make sure you have latest quasar-extras-svg-icons npm package version installed into your project folder in order for you to benefit from everything below.

Documentation

You can find the latest documentation at quasar-extras-svg-icons.netlify.app

SVG

Quasar v1.7+ required for svg Quasar Icon Sets.

Example (with Vue Composition API):

// some .vue file in devland
<template>
  <div>
    <q-icon :name="tabMenu" />
    <q-btn :icon="pixCalendarMonth" />
  </div>
</template>

<script>
import { tabMenu } from 'quasar-extras-svg-icons/tabler-icons'
import { pixCalendarMonth } from 'quasar-extras-svg-icons/pixelart-icons'

export default {
  // ...
  setup () {
    return {
      tabMenu
      pixCalendarMonth
    }
  }
}

Example (with Vue Options API):

// some .vue file in devland
<template>
  <div>
    <q-icon :name="tabMenu" />
    <q-btn :icon="remBug" />
  </div>
</template>

<script>
import { tabMenu } from 'quasar-extras-svg-icons/tabler-icons'
import { remBug } from 'quasar-extras-svg-icons/remix-icons'

export default {
  // ...
  created () {
    this.tabMenu = tabMenu
    this.remBug = remBug
  }
}

Replacing Quasar Icons

If you wanted to replace a Quasar icon being used in a component, then you have access to modifying the icon set directly.

This example uses Vue 3 script setup, but you can adapt it for your needs:

<script setup>
  import {useQuasar} from 'quasar' import {remArrowDownCircleFill} from
  'quasar-extras-svg-icons/remix-icons' const $q = useQuasar()
  $q.iconSet.expansionItem.icon = remArrowDownCircleFill
</script>

Now, the QExpansionItem will show the remArrowDownCircleFill from the remix-icons.

To determine which icons are replacable, go to the Quasar GitHub repo.

SVG name format

Svg icons will be defined as String with the following syntax:

Syntax: "<path>|<viewBox>" or "<path>" (with implicit viewBox of '0 0 24 24')
Examples:
  M9 3L5 6.99h3V14h2V6.99h3L9 3zm7 14.01V10h-2v7.01h-3L15 21l4-3.99h-3z|0 0 24 24
  M9 3L5 6.99h3V14h2V6.99h3L9 3zm7 14.01V10h-2v7.01h-3L15 21l4-3.99h-3z

A more complex example with attributes, would look like this:

M3 12H6L9 3L15 21L18 12H21@@stroke-width:1.5;fill:none;stroke:currentColor;stroke-linecap:round;stroke-linejoin:round;

Known Issues

• box-icons: (FIXED) There are two icons, boxBxsDroplet and boxBxsHot, that both use the svg use directive. Our parser cannot handle that, so these icons will be displayed as a black square.

• country-flag-icons is missing the South Korean flag as the SVG uses clip-path which our parser at this time cannot handle.

• health-icons:

  • has a !,svg filename which doesn't translate well to a valid JavaScript variable name, so it is renamed to ExclamationMark as they already have a QuestionMark (because you can't have ? in a filename).
  • A number of icons, like healthFilledConeTestOnNets and healthOutlineRuralPost, look messed up and there is no way to fix them at this time. Use at your own risk, or use the original icon.

• modern-icons is mssing the SVG for modernBattery30

• coreui-icons icons not available because of mask and use directives (cannot be flattened): cuiCifAu, cuiCifBi, cuiCifBr, cuiCifEg, cuiCifJm, cuiCifKg, cuiCifKn, cuiCifMr, cuiCifNa, cuiCifNz, cuiCifPt, cuiCifSb, cuiCifSk, cuiCifTv, cuiCifTz, and cuiCifZa.

• flatui-icons icons not available because of ClipPath and mask (cannot be flattened): flatArt, flatBowling, flatBrush, flatButton, flatCard, flatDynamite, flatFlask, flatRetina, flatRing, flatSafe, flatSkateboard, flatSpray, flatTouch, flatTrash, flatWeather, flatWine.

• glyphs-brands the color brands are not available because of LinearGradient, RadialGradient, etc (cannot be flattened).

• glyphs-flags are not available because of LinearGradient, RadialGradient, etc (cannot be flattened).

• clarity-icons does not include the alerted or badged icons as they don't make sense when being used in this context.

• openmoji: we are excluding the black svg icons for a number of reasons. The main one is that they are stripped down versions of the color icons, but while those ones have approximately 5 icons representing skin color, the black icons are not filled in and look the same. This adds unnecessary bulk to our distribution.

• material-theme-icons: two icons not available because of mask and LinearGradient (cannot be flattened): mtiCargoLock and mtiFlash.

• map-icons icons not available because of malformed SVG: mapBicycling, mapFishing, mapGolf, mapHorseRiding, mapMotobikeTrail, mapTrailWalking, mapViewing, mapWalking

Missing Icon Packages?

We have tried to include some of the most popular and current SVG icon packages available. If you find a package you think should be here, do add a feature request in the issues section.

Also, we did try to add a LOT of other packages, but there were reasons why some of them could not be included:

1. The SVG icon set includes color and/or duo-tone icons. Quasar uses the css currentColor to determine color, so these icons would have had the color stripped out.
2. Even though a package has a GitHub repo with SVG icons, their NPM package was missing the SVG icons. Instead, they were just distributing the WOFF and WOFF2 fonts that comprised of the icons. If you find one like this, let them know that they should also distribute the SVG icons.
3. The SVG uses commands, like use, LinearGradient, filter, etc., which cannot be integreted into the Quasar Framework format.

Before making a feature request, install the package you feel should be included into this package and check out if the above criteria will fit the needs of our parser.

Icon sets that fail:

• Majesticons: They use transform to make circles.
• Lucide: Not true SVG. Requires a browser to create the SVGs.
• material-icon-theme: Issues with arduino, denizenscript, folder-docker, and pascal.
• cryptocurrency-icons: Lots of use and filter directives.
• paper-icon-theme: Use linearGradient
• css-social-buttons (Zocial): viewBox is incorrect in many icons causing cut-off points.
• icon-park: too many different colors. Not suitable for dark theme or inverted color themes.
• noto-emoji: Uses linerarGradient
• region-flags: Uses linerarGradient and use
• ardis-icon-theme: Uses text
• breeze-icons: Uses LinearGradient
• adwaita-icon-theme: Uses LinearGradient and ClipPath
• super-tiny-icons: Uses use

Building this Package

For installation, use:

yarn --ignore-engines

Then run:

yarn build

Donate

If you appreciate the work that went into this project, please consider donating to Quasar or Jeff.

Documentation

Head on to the website: quasar-extras-svg-icons

SVG Icon Explorer

Don't forget to check out our Icon Explorer App so you can find that perfect icon for your app.

Stay in Touch

For latest releases and announcements, follow on Twitter: @jgalbraith64

Chat Support

Ask questions at the official community Discord server: https://chat.quasar.dev

License

All assets included in this repository are exclusive property of their respective owners and licensed under their own respective licenses. Quasar does not take any credit for packages included here.