-[Check out the demo](http://necolas.github.io/normalize.css/2.1.0/test.html)
+> A modern alternative to CSS resets
-[Legacy browser support is available in v1](https://github.com/necolas/normalize.css/tree/v1)
+[![npm][npm-image]][npm-url] [![license][license-image]][license-url]
+[![changelog][changelog-image]][changelog-url]
+[![gitter][gitter-image]][gitter-url]
-## Install
-Download from the [project page](http://necolas.github.io/normalize.css/).
+**NPM**
+
+```sh
+npm install --save normalize.css
+```
+
+**CDN**
+
+See https://yarnpkg.com/en/package/normalize.css
+
+**Download**
+
+See https://necolas.github.io/normalize.css/latest/normalize.css
-Install with [Bower](http://twitter.github.io/bower/): `bower install --save normalize-css`
## 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 improvements.
+* Improves usability with subtle modifications.
* Explains what code does using detailed comments.
-## How to use it
-Normalize.css is intended to be used as an alternative to CSS resets.
+## Browser support
-It's suggested that you read the `normalize.css` file and consider customising
-it to meet your needs. Alternatively, include the file in your project and
-override the defaults later in your CSS.
+* Chrome
+* Edge
+* Firefox ESR+
+* Internet Explorer 10+
+* Safari 8+
+* Opera
-## Browser support
-* Google Chrome
-* Mozilla Firefox 4+
-* Apple Safari 5+
-* Opera 12+
-* Internet Explorer 8+
+## 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
+of font-size for preformatted text. The duplication of `monospace` is
+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
+browsers. [Source](https://gist.github.com/413930).
+
+#### `select`
+
+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).
-## Contribute
+## Contributing
-Please read the CONTRIBUTING.md
+Please read the [contribution guidelines](CONTRIBUTING.md) in order to make the
+contribution process easy and effective for everyone involved.
-## Acknowledgements
-Normalize.css is a project by [Nicolas Gallagher](https://github.com/necolas),
-co-created with [Jonathan Neal](https://github.com/jonathantneal).
+[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
diff --git a/component.json b/component.json
deleted file mode 100644
index 624623916..000000000
--- a/component.json
+++ /dev/null
@@ -1,8 +0,0 @@
-{
- "name": "normalize-css",
- "version": "2.1.1",
- "author": "Nicolas Gallagher",
- "homepage": "http://necolas.github.com/normalize.css/",
- "main": "normalize.css",
- "styles": ["normalize.css"]
-}
diff --git a/normalize.css b/normalize.css
index 6d24a3853..192eb9ce4 100644
--- a/normalize.css
+++ b/normalize.css
@@ -1,402 +1,349 @@
-/*! normalize.css v2.1.1 | MIT License | git.io/normalize */
+/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */
-/* ==========================================================================
- HTML5 display definitions
+/* Document
========================================================================== */
/**
- * Correct `block` display not defined in IE 8/9.
- */
-
-article,
-aside,
-details,
-figcaption,
-figure,
-footer,
-header,
-hgroup,
-main,
-nav,
-section,
-summary {
- display: block;
-}
-
-/**
- * Correct `inline-block` display not defined in IE 8/9.
+ * 1. Correct the line height in all browsers.
+ * 2. Prevent adjustments of font size after orientation changes in iOS.
*/
-audio,
-canvas,
-video {
- display: inline-block;
+html {
+ line-height: 1.15; /* 1 */
+ -webkit-text-size-adjust: 100%; /* 2 */
}
-/**
- * Prevent modern browsers from displaying `audio` without controls.
- * Remove excess height in iOS 5 devices.
- */
-
-audio:not([controls]) {
- display: none;
- height: 0;
-}
+/* Sections
+ ========================================================================== */
/**
- * Address styling not present in IE 8/9.
+ * Remove the margin in all browsers.
*/
-[hidden] {
- display: none;
+body {
+ margin: 0;
}
-/* ==========================================================================
- Base
- ========================================================================== */
-
/**
- * 1. Prevent system color scheme's background color being used in Firefox, IE,
- * and Opera.
- * 2. Prevent system color scheme's text color being used in Firefox, IE, and
- * Opera.
- * 3. Set default font family to sans-serif.
- * 4. Prevent iOS text size adjust after orientation change, without disabling
- * user zoom.
+ * Render the `main` element consistently in IE.
*/
-html {
- background: #fff; /* 1 */
- color: #000; /* 2 */
- font-family: sans-serif; /* 3 */
- -ms-text-size-adjust: 100%; /* 4 */
- -webkit-text-size-adjust: 100%; /* 4 */
+main {
+ display: block;
}
/**
- * Remove default margin.
+ * Correct the font size and margin on `h1` elements within `section` and
+ * `article` contexts in Chrome, Firefox, and Safari.
*/
-body {
- margin: 0;
+h1 {
+ font-size: 2em;
+ margin: 0.67em 0;
}
-/* ==========================================================================
- Links
+/* Grouping content
========================================================================== */
/**
- * Address `outline` inconsistency between Chrome and other browsers.
+ * 1. Add the correct box sizing in Firefox.
+ * 2. Show the overflow in Edge and IE.
*/
-a:focus {
- outline: thin dotted;
+hr {
+ box-sizing: content-box; /* 1 */
+ height: 0; /* 1 */
+ overflow: visible; /* 2 */
}
/**
- * Improve readability when focused and also mouse hovered in all browsers.
+ * 1. Correct the inheritance and scaling of font size in all browsers.
+ * 2. Correct the odd `em` font sizing in all browsers.
*/
-a:active,
-a:hover {
- outline: 0;
+pre {
+ font-family: monospace, monospace; /* 1 */
+ font-size: 1em; /* 2 */
}
-/* ==========================================================================
- Typography
+/* Text-level semantics
========================================================================== */
/**
- * Address variable `h1` font-size and margin within `section` and `article`
- * contexts in Firefox 4+, Safari 5, and Chrome.
+ * Remove the gray background on active links in IE 10.
*/
-h1 {
- font-size: 2em;
- margin: 0.67em 0;
+a {
+ background-color: transparent;
}
/**
- * Address styling not present in IE 8/9, Safari 5, and Chrome.
+ * 1. Remove the bottom border in Chrome 57-
+ * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.
*/
abbr[title] {
- border-bottom: 1px dotted;
+ border-bottom: none; /* 1 */
+ text-decoration: underline; /* 2 */
+ text-decoration: underline dotted; /* 2 */
}
/**
- * Address style set to `bolder` in Firefox 4+, Safari 5, and Chrome.
+ * Add the correct font weight in Chrome, Edge, and Safari.
*/
b,
strong {
- font-weight: bold;
+ font-weight: bolder;
}
/**
- * Address styling not present in Safari 5 and Chrome.
+ * 1. Correct the inheritance and scaling of font size in all browsers.
+ * 2. Correct the odd `em` font sizing in all browsers.
*/
-dfn {
- font-style: italic;
+code,
+kbd,
+samp {
+ font-family: monospace, monospace; /* 1 */
+ font-size: 1em; /* 2 */
}
/**
- * Address differences between Firefox and other browsers.
+ * Add the correct font size in all browsers.
*/
-hr {
- -moz-box-sizing: content-box;
- box-sizing: content-box;
- height: 0;
+small {
+ font-size: 80%;
}
/**
- * Address styling not present in IE 8/9.
+ * Prevent `sub` and `sup` elements from affecting the line height in
+ * all browsers.
*/
-mark {
- background: #ff0;
- color: #000;
+sub,
+sup {
+ font-size: 75%;
+ line-height: 0;
+ position: relative;
+ vertical-align: baseline;
}
-/**
- * Correct font family set oddly in Safari 5 and Chrome.
- */
+sub {
+ bottom: -0.25em;
+}
-code,
-kbd,
-pre,
-samp {
- font-family: monospace, serif;
- font-size: 1em;
+sup {
+ top: -0.5em;
}
+/* Embedded content
+ ========================================================================== */
+
/**
- * Improve readability of pre-formatted text in all browsers.
+ * Remove the border on images inside links in IE 10.
*/
-pre {
- white-space: pre-wrap;
+img {
+ border-style: none;
}
+/* Forms
+ ========================================================================== */
+
/**
- * Set consistent quote types.
+ * 1. Change the font styles in all browsers.
+ * 2. Remove the margin in Firefox and Safari.
*/
-q {
- quotes: "\201C" "\201D" "\2018" "\2019";
+button,
+input,
+optgroup,
+select,
+textarea {
+ font-family: inherit; /* 1 */
+ font-size: 100%; /* 1 */
+ line-height: 1.15; /* 1 */
+ margin: 0; /* 2 */
}
/**
- * Address inconsistent and variable font size in all browsers.
+ * Show the overflow in IE.
+ * 1. Show the overflow in Edge.
*/
-small {
- font-size: 80%;
+button,
+input { /* 1 */
+ overflow: visible;
}
/**
- * Prevent `sub` and `sup` affecting `line-height` in all browsers.
+ * Remove the inheritance of text transform in Edge, Firefox, and IE.
+ * 1. Remove the inheritance of text transform in Firefox.
*/
-sub,
-sup {
- font-size: 75%;
- line-height: 0;
- position: relative;
- vertical-align: baseline;
-}
-
-sup {
- top: -0.5em;
-}
-
-sub {
- bottom: -0.25em;
+button,
+select { /* 1 */
+ text-transform: none;
}
-/* ==========================================================================
- Embedded content
- ========================================================================== */
-
/**
- * Remove border when inside `a` element in IE 8/9.
+ * Correct the inability to style clickable types in iOS and Safari.
*/
-img {
- border: 0;
+button,
+[type="button"],
+[type="reset"],
+[type="submit"] {
+ -webkit-appearance: button;
}
/**
- * Correct overflow displayed oddly in IE 9.
+ * Remove the inner border and padding in Firefox.
*/
-svg:not(:root) {
- overflow: hidden;
+button::-moz-focus-inner,
+[type="button"]::-moz-focus-inner,
+[type="reset"]::-moz-focus-inner,
+[type="submit"]::-moz-focus-inner {
+ border-style: none;
+ padding: 0;
}
-/* ==========================================================================
- Figures
- ========================================================================== */
-
/**
- * Address margin not present in IE 8/9 and Safari 5.
+ * Restore the focus styles unset by the previous rule.
*/
-figure {
- margin: 0;
+button:-moz-focusring,
+[type="button"]:-moz-focusring,
+[type="reset"]:-moz-focusring,
+[type="submit"]:-moz-focusring {
+ outline: 1px dotted ButtonText;
}
-/* ==========================================================================
- Forms
- ========================================================================== */
-
/**
- * Define consistent border, margin, and padding.
+ * Correct the padding in Firefox.
*/
fieldset {
- border: 1px solid #c0c0c0;
- margin: 0 2px;
- padding: 0.35em 0.625em 0.75em;
+ padding: 0.35em 0.75em 0.625em;
}
/**
- * 1. Correct `color` not being inherited in IE 8/9.
- * 2. Remove padding so people aren't caught out if they zero out fieldsets.
+ * 1. Correct the text wrapping in Edge and IE.
+ * 2. Correct the color inheritance from `fieldset` elements in IE.
+ * 3. Remove the padding so developers are not caught out when they zero out
+ * `fieldset` elements in all browsers.
*/
legend {
- border: 0; /* 1 */
- padding: 0; /* 2 */
+ box-sizing: border-box; /* 1 */
+ color: inherit; /* 2 */
+ display: table; /* 1 */
+ max-width: 100%; /* 1 */
+ padding: 0; /* 3 */
+ white-space: normal; /* 1 */
}
/**
- * 1. Correct font family not being inherited in all browsers.
- * 2. Correct font size not being inherited in all browsers.
- * 3. Address margins set differently in Firefox 4+, Safari 5, and Chrome.
+ * Add the correct vertical alignment in Chrome, Firefox, and Opera.
*/
-button,
-input,
-select,
-textarea {
- font-family: inherit; /* 1 */
- font-size: 100%; /* 2 */
- margin: 0; /* 3 */
+progress {
+ vertical-align: baseline;
}
/**
- * Address Firefox 4+ setting `line-height` on `input` using `!important` in
- * the UA stylesheet.
+ * Remove the default vertical scrollbar in IE 10+.
*/
-button,
-input {
- line-height: normal;
+textarea {
+ overflow: auto;
}
/**
- * Address inconsistent `text-transform` inheritance for `button` and `select`.
- * All other form control elements do not inherit `text-transform` values.
- * Correct `button` style inheritance in Chrome, Safari 5+, and IE 8+.
- * Correct `select` style inheritance in Firefox 4+ and Opera.
+ * 1. Add the correct box sizing in IE 10.
+ * 2. Remove the padding in IE 10.
*/
-button,
-select {
- text-transform: none;
+[type="checkbox"],
+[type="radio"] {
+ box-sizing: border-box; /* 1 */
+ padding: 0; /* 2 */
}
/**
- * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
- * and `video` controls.
- * 2. Correct inability to style clickable `input` types in iOS.
- * 3. Improve usability and consistency of cursor style between image-type
- * `input` and others.
+ * Correct the cursor style of increment and decrement buttons in Chrome.
*/
-button,
-html input[type="button"], /* 1 */
-input[type="reset"],
-input[type="submit"] {
- -webkit-appearance: button; /* 2 */
- cursor: pointer; /* 3 */
+[type="number"]::-webkit-inner-spin-button,
+[type="number"]::-webkit-outer-spin-button {
+ height: auto;
}
/**
- * Re-set default cursor for disabled elements.
+ * 1. Correct the odd appearance in Chrome and Safari.
+ * 2. Correct the outline style in Safari.
*/
-button[disabled],
-html input[disabled] {
- cursor: default;
+[type="search"] {
+ -webkit-appearance: textfield; /* 1 */
+ outline-offset: -2px; /* 2 */
}
/**
- * 1. Address box sizing set to `content-box` in IE 8/9.
- * 2. Remove excess padding in IE 8/9.
+ * Remove the inner padding in Chrome and Safari on macOS.
*/
-input[type="checkbox"],
-input[type="radio"] {
- box-sizing: border-box; /* 1 */
- padding: 0; /* 2 */
+[type="search"]::-webkit-search-decoration {
+ -webkit-appearance: none;
}
/**
- * 1. Address `appearance` set to `searchfield` in Safari 5 and Chrome.
- * 2. Address `box-sizing` set to `border-box` in Safari 5 and Chrome
- * (include `-moz` to future-proof).
+ * 1. Correct the inability to style clickable types in iOS and Safari.
+ * 2. Change font properties to `inherit` in Safari.
*/
-input[type="search"] {
- -webkit-appearance: textfield; /* 1 */
- -moz-box-sizing: content-box;
- -webkit-box-sizing: content-box; /* 2 */
- box-sizing: content-box;
+::-webkit-file-upload-button {
+ -webkit-appearance: button; /* 1 */
+ font: inherit; /* 2 */
}
-/**
- * Remove inner padding and search cancel button in Safari 5 and Chrome
- * on OS X.
+/* Interactive
+ ========================================================================== */
+
+/*
+ * Add the correct display in Edge, IE 10+, and Firefox.
*/
-input[type="search"]::-webkit-search-cancel-button,
-input[type="search"]::-webkit-search-decoration {
- -webkit-appearance: none;
+details {
+ display: block;
}
-/**
- * Remove inner padding and border in Firefox 4+.
+/*
+ * Add the correct display in all browsers.
*/
-button::-moz-focus-inner,
-input::-moz-focus-inner {
- border: 0;
- padding: 0;
+summary {
+ display: list-item;
}
+/* Misc
+ ========================================================================== */
+
/**
- * 1. Remove default vertical scrollbar in IE 8/9.
- * 2. Improve readability and alignment in all browsers.
+ * Add the correct display in IE 10+.
*/
-textarea {
- overflow: auto; /* 1 */
- vertical-align: top; /* 2 */
+template {
+ display: none;
}
-/* ==========================================================================
- Tables
- ========================================================================== */
-
/**
- * Remove most spacing between table cells.
+ * Add the correct display in IE 10.
*/
-table {
- border-collapse: collapse;
- border-spacing: 0;
+[hidden] {
+ display: none;
}
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 000000000..7f8590b4d
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,5 @@
+{
+ "name": "normalize.css",
+ "version": "8.0.1",
+ "lockfileVersion": 1
+}
diff --git a/package.json b/package.json
new file mode 100644
index 000000000..668bda8a4
--- /dev/null
+++ b/package.json
@@ -0,0 +1,15 @@
+{
+ "name": "normalize.css",
+ "version": "8.0.1",
+ "description": "A modern alternative to CSS resets",
+ "main": "normalize.css",
+ "style": "normalize.css",
+ "files": [
+ "LICENSE.md",
+ "normalize.css"
+ ],
+ "repository": "necolas/normalize.css",
+ "license": "MIT",
+ "bugs": "https://github.com/necolas/normalize.css/issues",
+ "homepage": "https://necolas.github.io/normalize.css"
+}
diff --git a/test.html b/test.html
index d7103c49b..615b08326 100644
--- a/test.html
+++ b/test.html
@@ -1,354 +1,441 @@
-
-
-
- This should be hidden in all browsers, apart from IE6
- -Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et m. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et m. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et m.
-Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et m. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et m. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et m.
- - Address: somewhere, world - -
- The a element example
- The abbr element and abbr element with title examples
- The b element example
- The cite element example
- The code element example
- The del element example
- The dfn element and dfn element with title examples
- The em element example
- The i element example
- The img element example
- The ins element example
- The kbd element example
- The mark element example
- The q element
exampleinside
a q element
- The s element example
- The samp element example
- The small element example
- The span element example
- The strong element example
- The sub element example
- The sup element example
- The u element example
- The var element example
-
Additional information
-Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et m.
- -Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et me.- -
<html>
- <head>
- </head>
- <body>
- <div class="main"> <div>
- </body>
-</html>-- -Some sort of famous witty quote marked up with a <blockquote> and a child <p> element.
-
Even better philosophical quote marked up with just a <blockquote> element.- -
| Album | -Year | -Price | -
|---|---|---|
| Album | -Year | -Price | -
| Are You Experienced | -1967 | -$10.00 | -
| Axis: Bold as Love | -1967 | -$12.00 | -
| Electric Ladyland | -1968 | -$10.00 | -
| Band of Gypsys | -1970 | -$12.00 | -
htmlbodyarticle, aside, details,
+ figure, figcaption, footer,
+ header, main,
+ menu, nav, section,
+ summary
+ audio, canvas, progress, videoaudio:not([controls]), template, [hidden]This should be hidden
+aabbr[title]b, strongdfnh1articlesectionmarksmallsub and supcontrol.
+control. sub.
+control. sup.
+imgsvgcode, kbd, pre, sampcode: abcdefghijklmnopqrstuvwxyz.pre: abcdefghijklmnopqrstuvwxyz.+
figurehrcontent-box box modelbutton, input, optgroup, select, textareafont-size from ancestorbuttonbutton, selecttext-transformbutton and button-style inputbutton and inputdefault cursor stylebutton, inputfieldsetlegendtextarea[type="checkbox"], [type="radio"]border-box box model[type="number"][type="search"]