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.

108 lines
3.1 KiB

2 years ago
# @csstools/normalize.css [<img src="https://csstools.github.io/normalize.css/logo.svg" alt="normalize" width="90" height="90" align="right">][@csstools/normalize.css]
[@csstools/normalize.css] is a CSS library that provides consistent,
cross-browser default styling of HTML elements.
## Usage
```html
<link href="https://unpkg.com/@csstools/normalize.css" rel="stylesheet" />
```
## Install
```sh
npm install @csstools/normalize.css --save
```
#### Webpack Usage
Import [@csstools/normalize.css] in CSS:
```css
@import '~@csstools/normalize.css';
```
Alternatively, import [@csstools/normalize.css] in JS:
```js
import '@csstools/normalize.css';
```
In `webpack.config.js`, use the appropriate loaders:
```js
module.exports = {
module: {
rules: [
{
test: /\.css$/,
use: [ 'style-loader', 'css-loader' ]
}
]
}
}
```
**Download**
See https://csstools.github.io/normalize.css/latest/normalize.css
## What does it do?
* Normalizes styles for a wide range of elements.
* Corrects bugs and common browser inconsistencies.
* Explains what code does using detailed comments.
## Browser support
* Chrome (last 3)
* Edge (last 3)
* Firefox (last 3)
* Firefox ESR
* Opera (last 3)
* Safari (last 2)
* iOS Safari (last 2)
## Contributing
Please read the [contribution guidelines](CONTRIBUTING.md) in order to make the
contribution process easy and effective for everyone involved.
## Similar Projects
- [modern-normalize.css](https://github.com/sindresorhus/modern-normalize) - An
alternative to normalize.css, adhering to a minimal set of normalizations and
common developer expectations and preferences.
- [opinionate.css](https://github.com/adamgruber/opinionate.css) - A supplement
to normalize.css with opinionated rules.
- [remedy.css](https://github.com/mozdevs/cssremedy) - An alternative to
normalize.css, adhering to different common developer expectations and
preferences.
- [sanitize.css](https://github.com/csstools/sanitize.css) - An alternative to
normalize.css, adhering to common developer expectations and preferences.
## Differences from `necolas/normalize.css`
Nicolas Gallagher and I started writing normalize.css together. I named and
created the normalize.css repository with the help of Paul Irish and Ben Alman.
I transferred the repository to Necolas, who turned it into a “household” CSS
library.
Later, I resumed authorship of normalize.css with Luciano Battagliero. Together,
we tagged, deprecated, and removed “opinionated” styles — styles developers
often prefer but which do not fix bugs or “normalize” browser differences.
Later, Necolas resumed authorship and the issue of whether to include or omit
the opinionated styles forced us to split.
I continue working on the normalize.css project, currently under the “csstools”
tag. I hope one day our differences are resolved and the projects are one again.
## Acknowledgements
normalize.css is a project by [Jonathan Neal](https://github.com/jonathantneal),
co-created with [Nicolas Gallagher](https://github.com/necolas).
[@csstools/normalize.css]: https://github.com/csstools/normalize.css