@react-md/icon

@react-md/icon

Create icons using a font-icon library like material-icons or font-awesome or plain old accessible SVG icons. There are also a few additional helpers to creating animating rotating icons and separating text from an icon.

Installation

npm install --save @react-md/icon

It is also recommended to install the other packages if you have not done so:

npm install --save @react-md/theme @react-md/typography

Pre-made material icons

If you would like to have access to all material icons as existing components instead of having to manually remember the correct children to provide or the correct path, you can install the @react-md/material-icons package. This will include all material icons as font and SVGs.

Documentation

You should check out the full documentation for live examples and more customization information, but an example usage is shown below.

Usage

Even though the FontIcon and SVGIcon components are the "main" exports for this package, they are more utility components and probably won't be used much once you set up your own icon system. The real exports are going to be the TextIconSpacing and IconRotator components.

The TextIconSpacing component is used to add spacing between an icon and some "text" where the text can be any renderable element. The IconRotator is used to animate an icon rotation such as expander or collapse icons.

import { render } from "react-dom";
import { FontIcon, TextIconSpacing } from "@react-md/icon";
import { Typography } from "@react-md/typography";

// the Typography component is optional, it'll just add better typography
// than normal text.
const App = () => (
  <>
    // creates an icon spaced before the "Go Home" text
    <TextIconSpacing icon={<FontIcon>home</FontIcon>}>
      <Typography>Go Home</Typography>
    </TextIconSpacing>
    // creates an icon spaced after the "Go Home" text
    <TextIconSpacing icon={<FontIcon>home</FontIcon>} iconAfter>
      <Typography>Go Home</Typography>
    </TextIconSpacing>
    // it can also be combined
    <TextIconSpacing icon={<FontIcon>arrow_back</FontIcon>}>
      <TextIconSpacing icon={<FontIcon>home</FontIcon>} iconAfter>
        <Typography>Go Home</Typography>
      </TextIconSpacing>
    </TextIconSpacing>
  </>
);

render(<App />, document.getElementById("root"));

This package's icon component usage is really only helpful when generating icon components through an external script or using font icons. However, here are a few examples of using the FontIcon and SVGIcon components:

import { render } from "react-dom";
import { FontIcon, SVGIcon } from "@react-md/icon";

// When using font icons, you'll need to make sure they icon fonts have been
// correctly included in your app. Check out the documentation site for more
// info

const App = () => (
  <>
    <FontIcon>home</FontIcon>
    <FontIcon iconClassName="fa fa-github" aria-label="Github" />
    <SVGIcon title="Face">
      <path d="M9 11.75c-.69 0-1.25.56-1.25 1.25s.56 1.25 1.25 1.25 1.25-.56 1.25-1.25-.56-1.25-1.25-1.25zm6 0c-.69 0-1.25.56-1.25 1.25s.56 1.25 1.25 1.25 1.25-.56 1.25-1.25-.56-1.25-1.25-1.25zM12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8 0-.29.02-.58.05-.86 2.36-1.05 4.23-2.98 5.21-5.37C11.07 8.33 14.05 10 17.42 10c.78 0 1.53-.09 2.25-.26.21.71.33 1.47.33 2.26 0 4.41-3.59 8-8 8z" />
    </SVGIcon>
  </>
);

render(<App />, document.getElementById("root"));

Changelog

5.1.0 (2022-03-18)

Bug Fixes

• @react-md/app-bar: AppBarTitle now applies flex: 1 1 auto (4a47c92)
• @react-md/tooltip: Tooltips stay visible on mobile Firefox (7039fef)

Features

• @react-md/menu: Provide props for Menu's List (2b5fb23)
• @react-md/tooltip: useTooltip supports new disabled option (a934ae9)

Documentation

• @react-md/tooltip: Remove documentation around Tooltipped component (1a59190), closes #1367

Other Internal Changes

• removed old eslint rules (88eb2b2)
• run lint-scripts --fix for consistent-type-imports (42d839d)
• Updated the v5.0.0 release notes (6106751)
• @react-md/dev-utils: Fix indexer for consistent-type-imports (2d2d1e9)
• @react-md/form: bump nanoid from 3.2.0 to 3.3.1 (e625488)
• react-md.dev: Add demo for rendering DropdownMenus as a Grid (3ac42ef)
• react-md.dev: Do not lazy load icons through next/head (47ccc1d)
• react-md.dev: Fix 404 page for sandboxes (4772c88)
• react-md.dev: Fix tooltip dense demo (efc7f8c)
• react-md.dev: Fix usage of useTooltip when it is conditionally applied (cfca184)
• react-md.dev: Update examples for useTooltip disabled option (f318ecf)
• stylelint: bump stylelint plugins to latest (2bb6429)