<mwc-icon>
IMPORTANT: The Material Web Components are a work in progress and subject to major changes until 1.0 release.
Icon displays an icon with a chosen name from the Material Icons font, or from any font that supports ligatures.
Material Design Guidelines: System icons
Installation
npm install @material/mwc-icon
NOTE: The Material Web Components are distributed as ES2017 JavaScript Modules, and use the Custom Elements API. They are compatible with all modern browsers including Chrome, Firefox, Safari, Edge, and IE11, but an additional tooling step is required to resolve bare module specifiers, as well as transpilation and polyfills for IE11. See here for detailed instructions.
Example usage
Basic
<link href="https://fonts.googleapis.com/css?family=Material+Icons&display=block" rel="stylesheet">
<mwc-icon>shopping_cart</mwc-icon>
<script type="module">
import '@material/mwc-icon/mwc-icon.js';
</script>
As a link
<a href="index.html">
<mwc-icon>arrow_back</mwc-icon>
</a>
Styled
<style>
.fancy {
color: #03a9f4;
--mdc-icon-size: 64px;
}
</style>
<mwc-icon class="fancy">accessible_forward</mwc-icon>
Fonts
Most users should include the following in their application HTML when using icons:
<link href="https://fonts.googleapis.com/css?family=Material+Icons&display=block" rel="stylesheet">
This loads the Material Icons font, which is required to render icons, and is not loaded automatically. If you see plain text instead of an icon, then the most likely cause is that the Material Icons font is not loaded.
To see all icons that are available in the Material Icons font, see Material Icons.
For technical details about the Material Icons font, see the Material Icons Developer Guide.
API
Slots
Name | Description |
---|---|
default | The name of the icon to display (e.g. shopping_cart ). See Material Icons for an index of all available icons. |
Properties/Attributes
None
Methods
None
Events
None
CSS Custom Properties
Name | Default | Description |
---|---|---|
--mdc-icon-font |
Material Icons |
Font that supports ligatures and determines which icons are available (see fonts above). |
--mdc-icon-size |
24px |
Size of the icon. |