Website for the AME project.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

114 lines
3.5 KiB

4 years ago
  1. [Open Iconic v1.1.1](http://useiconic.com/open)
  2. ===========
  3. ### Open Iconic is the open source sibling of [Iconic](http://useiconic.com). It is a hyper-legible collection of 223 icons with a tiny footprint—ready to use with Bootstrap and Foundation. [View the collection](http://useiconic.com/open#icons)
  4. ## What's in Open Iconic?
  5. * 223 icons designed to be legible down to 8 pixels
  6. * Super-light SVG files - 61.8 for the entire set
  7. * SVG sprite—the modern replacement for icon fonts
  8. * Webfont (EOT, OTF, SVG, TTF, WOFF), PNG and WebP formats
  9. * Webfont stylesheets (including versions for Bootstrap and Foundation) in CSS, LESS, SCSS and Stylus formats
  10. * PNG and WebP raster images in 8px, 16px, 24px, 32px, 48px and 64px.
  11. ## Getting Started
  12. #### For code samples and everything else you need to get started with Open Iconic, check out our [Icons](http://useiconic.com/open#icons) and [Reference](http://useiconic.com/open#reference) sections.
  13. ### General Usage
  14. #### Using Open Iconic's SVGs
  15. We like SVGs and we think they're the way to display icons on the web. Since Open Iconic are just basic SVGs, we suggest you display them like you would any other image (don't forget the `alt` attribute).
  16. ```
  17. <img src="/open-iconic/svg/icon-name.svg" alt="icon name">
  18. ```
  19. #### Using Open Iconic's SVG Sprite
  20. Open Iconic also comes in a SVG sprite which allows you to display all the icons in the set with a single request. It's like an icon font, without being a hack.
  21. Adding an icon from an SVG sprite is a little different than what you're used to, but it's still a piece of cake. *Tip: To make your icons easily style able, we suggest adding a general class to the* `<svg>` *tag and a unique class name for each different icon in the* `<use>` *tag.*
  22. ```
  23. <svg class="icon">
  24. <use xlink:href="open-iconic.svg#account-login" class="icon-account-login"></use>
  25. </svg>
  26. ```
  27. Sizing icons only needs basic CSS. All the icons are in a square format, so just set the `<svg>` tag with equal width and height dimensions.
  28. ```
  29. .icon {
  30. width: 16px;
  31. height: 16px;
  32. }
  33. ```
  34. Coloring icons is even easier. All you need to do is set the `fill` rule on the `<use>` tag.
  35. ```
  36. .icon-account-login {
  37. fill: #f00;
  38. }
  39. ```
  40. To learn more about SVG Sprites, read [Chris Coyier's guide](http://css-tricks.com/svg-sprites-use-better-icon-fonts/).
  41. #### Using Open Iconic's Icon Font...
  42. ##### …with Bootstrap
  43. You can find our Bootstrap stylesheets in `font/css/open-iconic-bootstrap.{css, less, scss, styl}`
  44. ```
  45. <link href="/open-iconic/font/css/open-iconic-bootstrap.css" rel="stylesheet">
  46. ```
  47. ```
  48. <span class="oi oi-icon-name" title="icon name" aria-hidden="true"></span>
  49. ```
  50. ##### …with Foundation
  51. You can find our Foundation stylesheets in `font/css/open-iconic-foundation.{css, less, scss, styl}`
  52. ```
  53. <link href="/open-iconic/font/css/open-iconic-foundation.css" rel="stylesheet">
  54. ```
  55. ```
  56. <span class="fi-icon-name" title="icon name" aria-hidden="true"></span>
  57. ```
  58. ##### …on its own
  59. You can find our default stylesheets in `font/css/open-iconic.{css, less, scss, styl}`
  60. ```
  61. <link href="/open-iconic/font/css/open-iconic.css" rel="stylesheet">
  62. ```
  63. ```
  64. <span class="oi" data-glyph="icon-name" title="icon name" aria-hidden="true"></span>
  65. ```
  66. ## License
  67. ### Icons
  68. All code (including SVG markup) is under the [MIT License](http://opensource.org/licenses/MIT).
  69. ### Fonts
  70. All fonts are under the [SIL Licensed](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web).