@wpmudev/sui-icons
v1.1.0
Published
SUI Icons Pack, the WPMU DEV Products icons font.
Downloads
11
Readme
Shared UI Icons Pack
Install
This repository is distributed with npm. After installing npm, you can install @wpmudev/sui-icons
with this command.
npm i --save-dev @wpmudev/sui-icons
Usage
There are many ways/formats to use the Shared UI Icons Package. The fastest and recommended way is via SVG directly. Or use the Webfont version if you want to include all icons at once:
SVG Icons - For a few icons in your project
- Suppose you want to use just a few icons. Find the icons you need in the "icons" folder. Then use them as regular images:
<img
width="32"
height="32"
src="@wpmudev/sui-icons/dist/svg/plugin-smartcrawl.svg"
alt="SmartCrawl Plugin" />
- It's possible to serve the icons from a CDN such as Unpkg. Use the
@wpmudev/sui-icons
npm package in the URL like the following:
<img
width="32"
height="32"
src="https://unpkg.com/@wpmudev/sui-icons/dist/svg/plugin-smartcrawl.svg"
alt="SmartCrawl Plugin" />
Icons Font - Ideal when you want to include all icons at once
- Install the
@wpmudev/sui-icons
and in the<head>
of your HTML file, reference the location to yoursui-icons.css
stylesheet.
<head>
...
<link rel="stylesheet" href="@wpmudev/sui-icons/dist/css/sui-icons.css" />
...
</head>
- Use unpkg.com to load the Shared UI Icons Pack directly without installing anything:
<head>
...
<link rel="stylesheet" href="https://unpkg.com/@wpmudev/sui-icons/dist/css/sui-icons.css" />
...
</head>
Place the
suicons
class with<span>
tag in your HTML file, like this. Then, use the icon name along with thesuicons-
class prefix.
<span class="suicons suicons--plugin-smartcrawl"></span>
Bugs, Ideas, Pull Requests
If you have any ideas or found bugs, please send me Pull Requests or let me know with GitHub Issues.
License
Can I use the SUI Icons Pack in my projects?
We created the WPMU DEV Design System to build plugins and products for WPMU DEV, not on products outside the company. Please visit the terms of use for full license details.
Need a new icon?
New icons need to be added to SUI Icons Pack first. Please, visit the Support page for more information on how to request it.
We can usually add an icon and release a new version on the same day if there is a hurry. However, remember that if there's a similar icon already available, we suggest you use it instead unless you request a design update.