normalize.css/README.md

103 lines
3.2 KiB
Markdown
Raw Normal View History

2016-03-19 21:11:59 +00:00
# normalize.css
2011-04-28 05:56:02 +00:00
2016-03-19 21:11:59 +00:00
<a href="https://github.com/necolas/normalize.css"><img
src="https://necolas.github.io/normalize.css/logo.svg" alt="Normalize Logo"
width="80" height="80" align="right"></a>
2011-04-28 05:56:02 +00:00
2016-03-19 21:11:59 +00:00
> A modern alternative to CSS resets
2011-04-28 05:56:02 +00:00
2016-03-19 21:11:59 +00:00
[![npm][npm-image]][npm-url] [![license][license-image]][license-url]
[![changelog][changelog-image]][changelog-url]
[![gitter][gitter-image]][gitter-url]
2016-03-19 21:11:59 +00:00
**NPM**
2016-03-19 21:11:59 +00:00
```sh
npm install --save normalize.css
```
**CDN**
See https://yarnpkg.com/en/package/normalize.css
2016-03-19 21:11:59 +00:00
**Download**
See https://necolas.github.io/normalize.css/latest/normalize.css
2014-02-17 04:08:25 +00:00
2013-08-16 04:52:25 +00:00
2012-08-07 21:27:32 +00:00
## What does it do?
* Preserves useful defaults, unlike many CSS resets.
* Normalizes styles for a wide range of elements.
* Corrects bugs and common browser inconsistencies.
* Improves usability with subtle modifications.
* Explains what code does using detailed comments.
2016-03-19 21:11:59 +00:00
## You can use these browsers
2011-04-28 05:56:02 +00:00
* Chrome
* Edge
* Firefox ESR+
* Internet Explorer 10+
* Safari 8+
* Opera
2016-03-19 21:11:59 +00:00
## Extended details and known issues
Additional detail and explanation of the esoteric parts of normalize.css.
#### `pre, code, kbd, samp`
The `font-family: monospace, monospace` hack fixes the inheritance and scaling
2015-12-20 16:53:20 +00:00
of font-size for preformatted text. The duplication of `monospace` is
2016-03-19 21:11:59 +00:00
intentional. [Source](https://en.wikipedia.org/wiki/User:Davidgothberg/Test59).
#### `sub, sup`
Normally, using `sub` or `sup` affects the line-box height of text in all
2016-03-19 21:11:59 +00:00
browsers. [Source](https://gist.github.com/413930).
2016-03-19 21:11:59 +00:00
#### `select`
2016-03-19 21:11:59 +00:00
By default, Chrome on OS X and Safari on OS X allow very limited styling of
`select`, unless a border property is set. The default font weight on `optgroup`
elements cannot safely be changed in Chrome on OSX and Safari on OS X.
#### `[type="checkbox"]`
It is recommended that you do not style checkbox and radio inputs as Firefox's
implementation does not respect box-sizing, padding, or width.
#### `[type="number"]`
Certain font size values applied to number inputs cause the cursor style of the
decrement button to change from `default` to `text`.
#### `[type="search"]`
The search input is not fully stylable by default. In Chrome and Safari on
OSX/iOS you can't control `font`, `padding`, `border`, or `background`. In
Chrome and Safari on Windows you can't control `border` properly. It will apply
`border-width` but will only show a border color (which cannot be controlled)
for the outer 1px of that border. Applying `-webkit-appearance: textfield`
addresses these issues without removing the benefits of search inputs (e.g.
showing past searches).
## Contributing
2016-03-19 21:11:59 +00:00
Please read the [contribution guidelines](CONTRIBUTING.md) in order to make the
contribution process easy and effective for everyone involved.
## Kindly follow contribution guidelines
2016-03-19 21:11:59 +00:00
[changelog-image]: https://img.shields.io/badge/changelog-md-blue.svg?style=flat-square
[changelog-url]: CHANGELOG.md
[license-image]: https://img.shields.io/npm/l/normalize.css.svg?style=flat-square
[license-url]: LICENSE.md
[npm-image]: https://img.shields.io/npm/v/normalize.css.svg?style=flat-square
[npm-url]: https://www.npmjs.com/package/normalize.css
[gitter-image]: https://img.shields.io/badge/chat-gitter-blue.svg?style=flat-square
[gitter-url]: https://gitter.im/necolas/normalize.css