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.

README.md 3.1 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. # normalize.scss v0.1.0
  2. Normalize.scss is the SCSS version of [normalize.css](http://necolas.github.io/normalize.css), a customisable CSS file that makes browsers render all elements more consistently and in line with modern standards.
  3. [View the normalize.css test file](http://necolas.github.io/normalize.css/latest/test.html)
  4. ## Install
  5. * [npm](http://npmjs.org/): `npm install --save normalize.scss`
  6. * [Component(1)](https://github.com/component/component/): `component install guerrero/normalize.scss`
  7. * [Bower](http://bower.io/): `bower install --save normalize.scss`
  8. * Download: Go to [this link](https://raw.githubusercontent.com/guerrero/normalize.scss/master/normalize.scss), press right-click on the page and choose "Save as..."
  9. No other styles should come before Normalize.scss.
  10. It's recommendable to modify `normalize.scss` to suit it to your project
  11. ## What does it do?
  12. * Preserves useful defaults, unlike many CSS resets.
  13. * Normalizes styles for a wide range of elements.
  14. * Corrects bugs and common browser inconsistencies.
  15. * Improves usability with subtle improvements.
  16. * Explains what code does using detailed comments.
  17. ## Browser support
  18. * Google Chrome (latest)
  19. * Mozilla Firefox (latest)
  20. * Mozilla Firefox 4
  21. * Opera (latest)
  22. * Apple Safari 6+
  23. * Internet Explorer 8+
  24. [Normalize.css v1 provides legacy browser
  25. support](https://github.com/necolas/normalize.css/tree/v1) (IE 6+, Safari 4+),
  26. but is no longer actively developed.
  27. ## Extended details
  28. Additional detail and explanation of the esoteric parts of normalize.css.
  29. #### `pre, code, kbd, samp`
  30. The `font-family: monospace, monospace` hack fixes the inheritance and scaling
  31. of font-size for preformated text. The duplication of `monospace` is
  32. intentional. [Source](http://en.wikipedia.org/wiki/User:Davidgothberg/Test59).
  33. #### `sub, sup`
  34. Normally, using `sub` or `sup` affects the line-box height of text in all
  35. browsers. [Source](http://gist.github.com/413930).
  36. #### `svg:not(:root)`
  37. Adding `overflow: hidden` fixes IE9's SVG rendering. Earlier versions of IE
  38. don't support SVG, so we can safely use the `:not()` and `:root` selectors that
  39. modern browsers use in the default UA stylesheets to apply this style. [SVG
  40. Mailing List discussion](http://lists.w3.org/Archives/Public/public-svg-wg/2008JulSep/0339.html)
  41. #### `input[type="search"]`
  42. The search input is not fully stylable by default. In Chrome and Safari on
  43. OSX/iOS you can't control `font`, `padding`, `border`, or `background`. In
  44. Chrome and Safari on Windows you can't control `border` properly. It will apply
  45. `border-width` but will only show a border color (which cannot be controlled)
  46. for the outer 1px of that border. Applying `-webkit-appearance: textfield`
  47. addresses these issues without removing the benefits of search inputs (e.g.
  48. showing past searches).
  49. #### `legend`
  50. Adding `border: 0` corrects an IE 8–11 bug where `color` (yes, `color`) is not
  51. inherited by `legend`.
  52. ## Acknowledgements
  53. Normalize.scss is a project by [Alex Guerrero](https://github.com/guerrero) based on [normalize.css](http://necolas.github.io/normalize.css) from [Nicolas Gallagher](https://github.com/necolas), co-created with [Jonathan Neal](https://github.com/jonathantneal).