Product Name

Iconography

Icons enhance Morningstar products by visually communicating actions, status, and feedback. The Morningstar Design System provides SVG icons to create user interfaces and controls.

Default Size

  • Display default icons at 23px × 23px.
  • Set width and height in CSS using the $mds-size-icon-m Constant.
alert
alert
asterisk
asterisk
bell-padless
bell-padless
bell
bell
bookmark-fill
bookmark-fill
bookmark
bookmark
bullhorn-padless
bullhorn-padless
caret-circle-down
caret-circle-down
caret-circle-left
caret-circle-left
caret-circle-right
caret-circle-right
caret-down
caret-down
caret-left
caret-left
caret-right
caret-right
caret-up
caret-up
chat-bubble
chat-bubble
check
check
clock-revert
clock-revert
clock
clock
collapse
collapse
create-padless
create-padless
crosshair
crosshair
cursor
cursor
dash-horizontal
dash-horizontal
dash-vertical
dash-vertical
document
document
download-cloud
download-cloud
download
download
ellipsis-circle
ellipsis-circle
ellipsis-horizontal
ellipsis-horizontal
ellipsis-vertical
ellipsis-vertical
envelope
envelope
esg-globe
esg-globe
exclaim-circle-fill
exclaim-circle-fill
exclaim
exclaim
expand
expand
eye
eye
file-cabinet-padless
file-cabinet-padless
filter-fill
filter-fill
filter
filter
gear
gear
grab-handle
grab-handle
group-column
group-column
group-row
group-row
group
group
hand
hand
heart
heart
home-padless
home-padless
home
home
import
import
info-circle-fill
info-circle-fill
info-circle
info-circle
jump-column
jump-column
list
list
lock-close
lock-close
lock-open
lock-open
marker-fill-padless
marker-fill-padless
marker
marker
marquee-select
marquee-select
marquee-zoom
marquee-zoom
menu-padless
menu-padless
minus
minus
morningstar-logo
morningstar-logo
news
news
object-add
object-add
open-new
open-new
paperclip-angle
paperclip-angle
paperclip
paperclip
pause-circle
pause-circle
pencil
pencil
person-add
person-add
person-padless
person-padless
play-circle
play-circle
plus
plus
print
print
question-circle-padless
question-circle-padless
question-circle
question-circle
refresh
refresh
remove
remove
scale
scale
search-list
search-list
search-padless
search-padless
search
search
share
share
star-fill
star-fill
star
star
stop-circle
stop-circle
style-box-bottom-left
style-box-bottom-left
style-box-bottom-mid
style-box-bottom-mid
style-box-bottom-right
style-box-bottom-right
style-box-middle-left
style-box-middle-left
style-box-middle-mid
style-box-middle-mid
style-box-middle-right
style-box-middle-right
style-box-top-left
style-box-top-left
style-box-top-mid
style-box-top-mid
style-box-top-right
style-box-top-right
style-box
style-box
text-size
text-size
trash
trash
triangle-fill-down
triangle-fill-down
triangle-fill-left
triangle-fill-left
triangle-fill-right
triangle-fill-right
triangle-fill-up
triangle-fill-up
undo
undo
upload
upload
wrench-padless
wrench-padless

Small Size

  • Display small icons at 15px × 15px.
  • Set the width and height of small icons using the $mds-size-icon-s Constant.
  • Use small icons within components such as Buttons and Form text boxes to provide additional affordance to the action.
alert--s
alert--s
alert-fill--s
alert-fill--s
angle-double-down--s
angle-double-down--s
angle-double-left--s
angle-double-left--s
angle-double-right--s
angle-double-right--s
angle-double-up--s
angle-double-up--s
angle-down--s
angle-down--s
angle-left--s
angle-left--s
angle-right--s
angle-right--s
angle-up--s
angle-up--s
bell--s
bell--s
caret-circle-down--s
caret-circle-down--s
caret-down--s
caret-down--s
caret-left--s
caret-left--s
caret-right--s
caret-right--s
caret-up--s
caret-up--s
check--s
check--s
download--s
download--s
ellipsis-circle--s
ellipsis-circle--s
exclaim--s
exclaim--s
exclaim-circle-fill--s
exclaim-circle-fill--s
expand--s
expand--s
filter--s
filter--s
heart--s
heart--s
info-circle--s
info-circle--s
list--s
list--s
minus--s
minus--s
open-new--s
open-new--s
pencil--s
pencil--s
person-add--s
person-add--s
play-circle--s
play-circle--s
plus--s
plus--s
question-circle--s
question-circle--s
remove--s
remove--s
search--s
search--s
triangle-fill-down--s
triangle-fill-down--s
triangle-fill-up--s
triangle-fill-up--s
upload--s
upload--s

How to Use

MDS references icons via an SVG icon sprite with the following syntax:

heart
<svg class="mds-icon">
    <use xlink:href="/assets/icons/mds_icons.svg#heart">
        <title>heart</title>
    </use>
</svg>

Interactive

To create an interactive icon, use an Icon-Only Button.

Icon-Only Button
<button class="mds-button mds-button--icon-only" type="button" role="button">
    <svg class="mds-icon mds-button__icon mds-button__icon--right">
        <use xlink:href="/assets/icons/mds_icons.svg#person-padless">
            <title>User</title>
        </use>
    </svg>
</button>

To create a toolbar of interactive icons, use an Icon-Only Button Group.

Icon-Only Button Group
<div class="mds-button-group mds-button-group--icon-only">
    <button class="mds-button mds-button--icon-only" type="button" role="button">
        <svg class="mds-icon mds-button__icon mds-button__icon--left" aria-hidden="true">
            <use xlink:href="/assets/icons/mds_icons.svg#bell-padless"> </use>
        </svg>
    </button>
    <button class="mds-button mds-button--icon-only" type="button" role="button">
        <svg class="mds-icon mds-button__icon mds-button__icon--left" aria-hidden="true">
            <use xlink:href="/assets/icons/mds_icons.svg#create-padless"> </use>
        </svg>
    </button>
    <button class="mds-button mds-button--icon-only" type="button" role="button">
        <svg class="mds-icon mds-button__icon mds-button__icon--left" aria-hidden="true">
            <use xlink:href="/assets/icons/mds_icons.svg#question-circle-padless"> </use>
        </svg>
    </button>
    <button class="mds-button mds-button--icon-only" type="button" role="button">
        <svg class="mds-icon mds-button__icon mds-button__icon--left" aria-hidden="true">
            <use xlink:href="/assets/icons/mds_icons.svg#person-padless"> </use>
        </svg>
    </button>
</div>

Accessibility

  • Include <title> if no text is provided in the same context level. For example, Icon-Only Button.
  • Add ARIA aria-hidden=”true” attribute or omit <title> if relevant text is available. For example, Button With Icon.

Design Approach

Icon Grid

Simple, clear, and consistent icons require the rigor of underlying grid.

Construction & Visual Style

Icons use simple geometric shapes and 1-pixel strokes.

Figure 1. Design process for the gear icon.

The gear icon is an excellent example of a complex icon that is derived from simple geometric shapes. The grid guides the positioning of the shapes. Once on the grid, those shapes are refined and combined. Removing what isn’t necessary allows the icon’s essential form to shine through.

When designing a new icon, always consider it in the context of the entire icon family. For example, the gear icon is more complex than others, but following our construction and style guidelines allow it to harmoniously pair with others.

Do use right angles, a consistent 1-pixel stroke, and square terminals.
Do use right angles, a consistent 1-pixel stroke, and square terminals.
Don‘t use an inconsistent stroke and rounded terminals.
Don‘t use an inconsistent stroke and rounded terminals.
Do use minimal detail to reduce the icon to its essential form.
Do use minimal detail to reduce the icon to its essential form.
Don‘t add superfluous detail to the icon from.
Don‘t add superfluous detail to the icon from.
Do enable “Pixel Preview” and “Snap to Grid” when creating new icons.
Do enable “Pixel Preview” and “Snap to Grid” when creating new icons.
Don‘t place artwork off the pixel grid when creating new icons.
Don‘t place artwork off the pixel grid when creating new icons.

Saving Icon Artwork as SVG

To ensure that icon artwork is optimized to work with the MDS iconography system, always take the following steps when saving individual icons as files.

1. Create your artwork using the appropriate Adobe Illustrator icon template file. Place your icon on the Artwork layer and make sure to save a pre-production version of your file.

2. In the Layers palette, delete all but the Artwork layer.

Layers palette in Illustrator.

3. Outline all strokes, and use the Unite option in the Shape Modes section of the Pathfinder tool to convert the icon to a compound shape.

Pathfinder tool in Illustrator

4. Select the compound shape and set the fill to solid black #000000.

5. Save as an SVG.

Deselect the following in the "SVG Options" dialog:

  • Preserve Illustrator Editing Capabilities
  • Responsive (Under "More Options")
SVG Options dialog in Illustrator.

6. Optimize the SVG using SVGOMG:

  1. Upload your pre-optimized SVG
  2. Leave all settings at their default
  3. Save your optimized SVG

7. Confirm that the SVG file contains no irrelevant code by opening the .svg file in any text editor. It should not contain any references to Adobe Illustrator, hex codes, or class or id names. For example:

<svg xmlns="http://www.w3.org/2000/svg" width="23" height="23" viewBox="0 0 23 23">
    <path d="M20 19.3l-4.9-4.9c1.2-1.3 1.9-3.1 1.9-5 0-4-3.4-7.4-7.5-7.4S2 5.4 2 9.5 5.4 17 9.5 17c1.9 0 3.6-.7 4.9-1.8l4.9 4.9.7-.8zM3 9.5C3 5.9 5.9 3 9.5 3S16 5.9 16 9.5 13.1 16 9.5 16 3 13.1 3 9.5z" />
</svg>

The icon artwork is now ready for use in MDS.

Code Reference

CSS Class References

Class
Applies to
Outcome

.mds-icon--s

.mds-icon

Scales icon down to 15px x 15px.

Mixin Reference

@include icon-height-removal()

Use to vertically center an icon without influencing overall vertical spacing, particularly when cropping text to cap height and baseline using the mds-text-crop mixin.

Custom Icons

Custom Icons Not in MDS

If your product team uses custom icons that are not included in MDS, you should implement them within your own application using the same SVG sprite method as the System. To ensure that your custom icons are optimized for the MDS, use the saving icon artwork as SVG process.

Adding Custom Icons to MDS

If you believe that custom icons in your product should be added to MDS, first identify one or more additional teams that have a need for the icon. Ensure that your custom icon follows our design approach and prepare your icon artwork using the saving icon artwork as SVG process.

Submit the icon to be added to MDS by speaking to Jonathan Duncan, the iconography segment owner, or by emailing designsystem@morningstar.com. Once the new icon has been reviewed, the System team will work with you to include the new icon in an upcoming release.

©2017 Morningstar, Inc. All rights reserved. Terms of Use