Blame view
README.md
3.45 KB
95c4d7afc Add a LICENSE, RE... |
1 |
# Material Design Icons |
c4edaa75d Link to stable & ... |
2 |
Material Design Icons are the official open-source icons featured in the Google [Material Design](http://www.google.com/design/spec) specification. |
95c4d7afc Add a LICENSE, RE... |
3 4 5 6 |
## What's included? * SVG versions of all icons in both 24px and 48px flavours |
ad8543d2e Add section on CS... |
7 |
* SVG and CSS sprites of all icons |
95c4d7afc Add a LICENSE, RE... |
8 9 10 11 12 13 14 15 16 17 |
* 1x, 2x icons targeted at the Web (PNG) * 1x, 2x, 3x icons targeted at iOS (PNG) * Hi-dpi versions of all icons (hdpi, mdpi, xhdpi, xxhdpi, xxxhdpi) (PNG) ## Getting Started You have a few options for getting the icon set. ### Download the Zip |
c4edaa75d Link to stable & ... |
18 |
Grab the latest stable [zip archive](https://github.com/google/material-design-icons/releases/download/v1.0.0/material-design-icons-1.0.0.zip) of all icons or the bleeding-edge version in [master](https://github.com/google/material-design-icons/archive/master.zip). |
95c4d7afc Add a LICENSE, RE... |
19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 |
### Bower Install the icons using the [Bower](http://bower.io) package manager. ```sh $ bower install material-design-icons ``` ### npm You can also find all the icons on [npm](http://npmjs.org). ```sh $ npm install material-design-icons ``` |
92b4bd641 Add section on SV... |
35 36 37 |
## Usage Take a look at the included `index.html` file for a preview of all icons included in the set. You are free to use the icons in the way that makes most sense to your project. |
ad8543d2e Add section on CS... |
38 39 40 |
## Structure ### Icons |
c739074e9 Add structure > i... |
41 42 43 44 45 46 47 48 |
In general, an icon category (e.g `action`) will include the following directories, containing multiple resolutions of our icons. * 1x, 2x Web * 1x, 2x, 3x iOS * drawable hdpi, mdpi, xhdpi, xxhdpi, xxxhdpi * svg Decide on the icon resolution required for your project and copy, then reference the icons you wish to use. |
ad8543d2e Add section on CS... |
49 |
### Spritesheets |
92b4bd641 Add section on SV... |
50 |
Material Design icons come with SVG and CSS sprites for each category of icon we include. These can be found in the `sprites` directory, under `svg-sprite` and `css-sprite`. |
ad8543d2e Add section on CS... |
51 52 |
#### Using CSS Sprites |
92b4bd641 Add section on SV... |
53 |
To use a CSS spritesheet, reference the stylesheet for the icon category you wish to use, then include the icon definition in your markup. E.g to use one of the play icons in `css-sprite-av`: |
ad8543d2e Add section on CS... |
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 |
Reference the stylesheet: ```html <link href="css-sprite/sprite-av-black.css" rel="stylesheet"> ``` Create an element which will use the icon as a background: ```html <div></div> ``` Add a class referencing the `icon` spritesheet and specific icon `icon-ic_play_circle_outline_black_24dp`, which you can get from the above stylesheet. ```html <div class="icon icon-ic_play_circle_outline_black_24dp"></div> ``` That's it! Don't forget to publish the corresponding CSS and SVG/PNG files when deploying your project. |
92b4bd641 Add section on SV... |
76 |
#### Using SVG Sprites |
c739074e9 Add structure > i... |
77 |
|
c4edaa75d Link to stable & ... |
78 |
Similarly, to use an SVG spritesheet, reference the stylesheet for the icon category, then include the icon definition in your markup. |
c739074e9 Add structure > i... |
79 |
|
92b4bd641 Add section on SV... |
80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 |
E.g: to use one of the play icons in `svg-sprite-av`, reference the stylesheet: ```html <link href="svg-sprite/svg-sprite-av.css" rel="stylesheet"> ``` Create an element which will use the icon as a background: ```html <div></div> ``` Next, make sure to set a dimension for the icon. This can either be done inline or via a class. We'll use a class for this example: ```html <style> .svg-ic_play_circle_outline_24px-dims { width: 24px; height: 24px; } </style> ``` Finally, set the dimension and specific icon `svg-ic_play_circle_outline_24px`, which you can get from the above stylesheet. ```html <div class="svg-ic_play_circle_outline_24px svg-ic_play_circle_outline_24px-dims"></div> ``` |
95c4d7afc Add a LICENSE, RE... |
105 |
|
95c4d7afc Add a LICENSE, RE... |
106 107 |
## Licence |
c4edaa75d Link to stable & ... |
108 |
All icons are released under an [Attribution-ShareAlike 4.0 International](http://creativecommons.org/licenses/by-sa/4.0/) license. |