@patternfly/pfe-icon

PatternFly Elements | Icon Element

Usage

<pfe-icon icon="rh-leaf"></pfe-icon>

Slots

There are no slots, but if you wish to display some text when JS is disabled, you can put some text inside the pfe-icon tag. For instance, when using a checkmark icon in a server status table, you may wish to display "success" if JS is disabled.

<pfe-icon icon="rh-check-mark">success</pfe-icon>

Attributes

Name	Values	Description
icon	iconSet-iconName	For example, rh-leaf loads a leaf icon from an icon set named "rh".
pfe-size	sm md lg xl 1x 2x 3x 4x	The default size is 1em, so icon size matches text size. 2x, etc, are multiples of font size. sm, md, etc are fixed pixel-based sizes.
pfe-color	base lightest lighter darker darkest complement accent accent critical important moderate success info default	The color variant to use. This draws from your theming layer to color the icon. This will set icon color or background color (if pfe-circled is true).
pfe-circled	boolean attribute	Whether to draw a circular background behind the icon.

Icon sets

Icon sets are defined in detail in this blog post. The blog post should eventually be absorbed into the official documentation.

Register a new icon set

To register a new icon set, choose a global namespace for that set and identify the path at which the SVGs for that set will be hosted. Consider also the function needed to convert the icon name into the filename on that hosted location. The addIconSet call accepts the namespace (as a string), the path to the SVGs (as a string), and a function for parsing the icon name into the filename.

    PfeIcon.addIconSet(
    "local",
    "./",
    function(name, iconSetName, iconSetPath) {
        var regex = new RegExp("^" + iconSetName + "-(.*)");
        var match = regex.exec(name);
        return iconSetPath + match[1] + ".svg";
    }
    );

Updating an existing icon set

To updating an existing icon set, you use the same addIconSet function. The first input which is the icon set namespace is required, as is the new path. You can optionally pass in a new function for parsing the icon names into filenames.

    PfeIcon.addIconSet("local", "https://hosted-icons.com/");

Variables

There are several powerful variables available to hook into and override default styles.

• Color: the color attribute is available to pull icon color from your theming layer. For more fine-grained control, --pfe-icon--color is available to override the color of a specific icon or sets of icons and will be applied to either the SVG lines or the background of the circle (if circled). Examples
• Background color: the color attribute is available to pull background color from your theming layer. For more fine-grained control, --pfe-icon--BackgroundColor is available to override the background color of a specific icon or sets of icons. Be sure to set --pfe-icon--context to the appropriate context if you are setting the background-color.

Test

npm test

Build

npm run build

Demo

From the PFElements root directory, run:

npm start

Code style

Card (and all PFElements) use Prettier to auto-format JS and JSON. The style rules get applied when you commit a change. If you choose to, you can integrate your editor with Prettier to have the style rules applied on every save.