The 2017 Ionic Developer Survey Results are in!

Icon

ion-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 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.

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
ios string

Specifies which icon to use on ios mode.

isActive boolean

If true, the icon is styled with an "active" appearance. An active icon is filled in, and an inactive icon is the outline of the icon. The isActive property is largely used by the tabbar. Only affects ios icons.

md string

Specifies which icon to use on md mode.

name string

Specifies which icon to use. The appropriate icon will be used based on the mode. For more information, see Ionicons.

Related

Icon Component Docs

API

Native

General