Icon

Improve this doc

Icons can be used on their own, or inside of a number of Ionic components. For a full list of available icons, check out the Ionicons resource docs.

One feature of Ionicons in Ionic is when icon names are set, the actual icon which is rendered can change slightly depending on the mode the app is running from. For example, by setting the icon name of alarm, on iOS the icon will automatically apply ios-alarm, and on Material Design it will automatically apply md-alarm. This allows the developer to write the markup once while Ionic applies the appropriate icon based on the mode.

Directive

selector: ion-icon

Usage

<!-- automatically uses the correct "star" icon depending on the mode -->
<ion-icon name="star"></ion-icon>

<!-- explicity set the icon for each mode -->
<ion-icon ios="ios-home" md="md-home"></ion-icon>

<!-- always use the same icon, no matter what the mode -->
<ion-icon name="ios-clock"></ion-icon>
<ion-icon name="logo-twitter"></ion-icon>

Input Properties

Attr Type Details
name string

Icon to use. Will load the appropriate icon for each mode

ios string

Explicitly set the icon to use on iOS

md string

Explicitly set the icon to use on MD

isActive bool

Whether or not the icon has an "active" appearance. On iOS an active icon is filled in or full appearance, and an inactive icon on iOS will use an outlined version of the icon same icon. Material Design icons do not change appearance depending if they're active or not. The isActive property is largely used by the tabbar.

Related

Icon Component Docs

API

Native

General