Skip to content

Latest commit

 

History

History
116 lines (85 loc) · 4.49 KB

README.md

File metadata and controls

116 lines (85 loc) · 4.49 KB

Ember Phosphor icons

Phosphor is a flexible icon family for interfaces, diagrams, presentations — whatever, really. More icons at phosphoricons.com.

npm

Features

  • 🔥 1.5K+ icons: A large set of icons - with 6 variants per icon.
  • 💙 TypeScript and Glint support: Glint types are provided for strict template checking.
  • 🌲 Tree-shakable: Only include the icons which are actually used in your application.
  • 🎨 Customizable: Change the icon's color, size, and weight with simple arguments.
  • 🧵 V2 addon format: Ready for modern Ember.
  • 🚀 SSR/SSG-ready: Works in apps using Fastboot or Prember.

Compatibility

Important

It is highly recommended to only use this addon with Embroider. Otherwise you do not get the benefit of tree shaking and the full icon set will be included, which increases the bundle size by a lot.

Installation

npm install ember-phosphor-icons
# or
yarn add ember-phosphor-icons
# or
pnpm install ember-phosphor-icons
# or
bun install ember-phosphor-icons

Glint template registry

If you're not yet using template tag components, you can make use of the provided template registry for Glint. This will allow you to use the icons in your templates with full type checking.

import '@glint/environment-ember-loose';
import type EmberPhosphorIconsRegistery from 'ember-phosphor-icons/template-registry';

declare module '@glint/environment-ember-loose/registry' {
  export default interface Registry extends EmberPhosphorIconsRegistery, /* ... */ {
    // local entries
  }
}

Usage

import PhCube from 'ember-phosphor-icons/components/ph-cube';
import PhHeart from 'ember-phosphor-icons/components/ph-heart';

<template>
  <PhCube />
  <PhHeart @size="32" @color="hotpink" @weight="fill" />
</template>

Arguments

  • color?: string – Icon stroke/fill color. Can be any CSS color string, including hex, rgb, rgba, hsl, hsla, named colors, or the special currentColor variable.
  • size?: number | string – Icon height & width. As with standard React elements, this can be a number, or a string with units in px, %, em, rem, pt, cm, mm, in.
  • weight?: "thin" | "light" | "regular" | "bold" | "fill" | "duotone" – Icon weight/style. Can also be used, for example, to "toggle" an icon's state: a rating component could use Stars with weight="regular" to denote an empty star, and weight="fill" to denote a filled star.
  • mirrored?: boolean – Flip the icon horizontally. Can be useful in RTL languages where normal icon orientation is not appropriate.

Composability

Components can accept arbitrary SVG elements as children, so long as they are valid children of the <svg> element. This can be used to modify an icon with background layers or shapes, filters, animations and more. The children will be placed below the normal icon contents.

The following will cause the Cube icon to rotate and pulse:

import PhCube from 'ember-phosphor-icons/components/ph-cube';

<template>
  <PhCube @color="darkorchid" @weight="duotone">
    <animate
      attributeName="opacity"
      values="0;1;0"
      dur="4s"
      repeatCount="indefinite"
    />
    <animateTransform
      attributeName="transform"
      attributeType="XML"
      type="rotate"
      dur="5s"
      from="0 0 0"
      to="360 0 0"
      repeatCount="indefinite"
    />
  </PhCube>
</template>

Note

The coordinate space of slotted elements is relative to the contents of the icon viewBox, which is a 256x256 square. Only valid SVG elements will be rendered.

Tip

Make sure you have babel-plugin-ember-template-compilation@^2.2.2 or higher installed to support camel cased SVG elements. (as this was a known bug before)

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.