The <sp-icons-medium> and <sp-icons-large> elements included in this package supply your application with the Spectrum CSS medium and large icons for use in the <sp-icon> element. Include at least one of these elements in a project that makes use of icons in these sets. You can also include these sets in the scope of any element that leverages them, as they will be deduplicated to ensure all of your components can deliver the icons included therein.
yarn add @spectrum-web-components/icons
Import the side effectful registration of <sp-icons-medium> or <sp-icons-large> via:
import '@spectrum-web-components/icons/sp-icons-medium.js';
import '@spectrum-web-components/icons/sp-icons-large.js';
When looking to leverage the IconsMedium or IconsLarge base classes as a type and/or for extension purposes, do so via:
import { IconsMedium, IconsLarge } from '@spectrum-web-components/icons';
The Icons package has been deprecated as part of the removal of the Iconset package from the library and will be removed in an upcoming release. To optimize your build and ensure smaller bundles and higher performance for your users, consider using techniques that include only the icons actually used in your application. For Spectrum icons, you can use UI Icons or Workflow Icons.
For non-Spectrum icons, you can still:
- Slot SVG or image content into an
sp-iconelement, or - Sanitize the SVG and convert it to a template literal to use within the
render()method of an extension ofIconBaseto create your own custom named icon element.```
Review the accessibility guidelines for the icon.