@pxblue/symbols

Oneline symbols for PX Blue applications

Usage no npm install needed!

<script type="module">
  import pxblueSymbols from 'https://cdn.skypack.dev/@pxblue/symbols';
</script>

README

PX Blue Symbols

This is a library of one-line symbols for use in PX Blue applications.

Installation

To install the PX Blue symbols from NPM as a dependency for your project, you can run one of the following commands in your project root:

npm install --save @pxblue/symbols
or
yarn add @pxblue/symbols

Usage

Angular

The simplest way to use these SVG symbols in Angular is to register them with the matIconRegistry so they can be used with the <mat-icon> tag. You can register symbols individually, or as the entire PX Blue set:

import { Component } from "@angular/core";
import { MatIconRegistry } from "@angular/material/icon";
import { DomSanitizer } from "@angular/platform-browser";

declare var require: any;
const symbol = require("@pxblue/symbols/battery.svg"); // individual symbol
const symbolSet = require("@pxblue/symbols/symbols.svg"); // full set

Then, in your constructor, register the symbol or the symbol set. It will then be available for use as a <mat-icon>.

Individual Icon

// app.component.ts
export class AppComponent {
  constructor(
    private matIconRegistry: MatIconRegistry,
    private domSanitizer: DomSanitizer
  ) {
    this.matIconRegistry.addSvgIcon(
      "battery",
      this.domSanitizer.bypassSecurityTrustResourceUrl(symbol)
    );
  }
}
// app.component.html
<mat-icon svgIcon="battery"></mat-icon>

Entire Icon Set

// app.component.ts
export class AppComponent {
  constructor(
    private matIconRegistry: MatIconRegistry,
    private domSanitizer: DomSanitizer
  ) {
    this.matIconRegistry.addSvgIconSetInNamespace('px-symbols', this.domSanitizer.bypassSecurityTrustResourceUrl(symbolSet));
  }
}
// app.component.ts
<mat-icon svgIcon="px-symbols:battery"></mat-icon>

React

const symbol = require('@pxblue/symbols/SYMBOL_NAME.svg');
...
<img src={symbol}/>

NOTE: If you will be using many of these symbols in your application, we recommend you use @pxblue/symbols-mui to simplify usage. This library makes more sense if you just need one or two symbols or if you want to reduce the size of your bundle.

Available Symbols

Please see Available Symbols for a list of currently available symbols.

For Icon Creators

Each symbol has its own folder in the /icons/symbols folder, which includes the clean SVG file .