mirror of
https://github.com/material-components/material-web.git
synced 2024-09-11 21:57:41 +03:00
87 lines
3.1 KiB
Markdown
87 lines
3.1 KiB
Markdown
# Material Web
|
|
|
|
<img src="./docs/images/material-web.gif"
|
|
title="Material web components"
|
|
alt="A collection of Material web components"
|
|
style="border-radius: 32px">
|
|
|
|
[![Published on npm](https://img.shields.io/npm/v/%40material%2Fweb)](https://www.npmjs.com/package/@material/web)
|
|
[![Join our Discord](https://img.shields.io/badge/discord-join%20chat-5865F2.svg?logo=discord&logoColor=fff&label=%23material)](https://lit.dev/discord/)
|
|
[![Test status](https://github.com/material-components/material-web/actions/workflows/test.yml/badge.svg)](https://github.com/material-components/material-web/actions/workflows/test.yml)
|
|
[![npm Downloads](https://img.shields.io/npm/dm/%40material%2Fweb?label=npm%20downloads)](https://npm-stat.com/charts.html?package=%40material%2Fweb)
|
|
[![jsDelivr hits (npm)](https://img.shields.io/jsdelivr/npm/hm/%40material%2Fweb)](https://www.jsdelivr.com/package/npm/@material/web?tab=stats)
|
|
|
|
`@material/web` is a library of
|
|
[web components](https://developer.mozilla.org/en-US/docs/Web/Web_Components)<!-- {.external} -->
|
|
that helps build beautiful and accessible web applications. It uses
|
|
[Material 3](https://m3.material.io/)<!-- {.external} -->, the latest version of Google's
|
|
open-source design system.
|
|
|
|
**Note:
|
|
[MWC is in maintenance mode pending new maintainers](https://github.com/material-components/material-web/discussions/5642).**
|
|
|
|
## Resources
|
|
|
|
- [Introduction](./docs/intro.md)
|
|
- [Roadmap](./docs/roadmap.md)
|
|
- [Component docs](./docs/components/)
|
|
- [Bundle size](./docs/size.md)
|
|
- [Browser support and FAQ](./docs/support.md)
|
|
|
|
## Quick start
|
|
|
|
> Tip: Using Angular? We recommend using
|
|
> [Angular Material](https://material.angular.io/)<!-- {.external} --> components
|
|
> instead.
|
|
|
|
This code snippet is a buildless example that loads `@material/web` from a CDN.
|
|
Check out the [quick start](./docs/quick-start.md) guide to install and build
|
|
for production.
|
|
|
|
<!-- LINT.IfChange -->
|
|
|
|
```html
|
|
<head>
|
|
<link href="https://fonts.googleapis.com/css2?family=Roboto:wght@400;500;700&display=swap" rel="stylesheet">
|
|
<script type="importmap">
|
|
{
|
|
"imports": {
|
|
"@material/web/": "https://esm.run/@material/web/"
|
|
}
|
|
}
|
|
</script>
|
|
<script type="module">
|
|
import '@material/web/all.js';
|
|
import {styles as typescaleStyles} from '@material/web/typography/md-typescale-styles.js';
|
|
|
|
document.adoptedStyleSheets.push(typescaleStyles.styleSheet);
|
|
</script>
|
|
</head>
|
|
<body>
|
|
<h1 class="md-typescale-display-medium">Hello Material!</h1>
|
|
<form>
|
|
<p class="md-typescale-body-medium">Check out these controls in a form!</p>
|
|
<md-checkbox></md-checkbox>
|
|
<div>
|
|
<md-radio name="group"></md-radio>
|
|
<md-radio name="group"></md-radio>
|
|
<md-radio name="group"></md-radio>
|
|
</div>
|
|
|
|
<md-outlined-text-field label="Favorite color" value="Purple"></md-outlined-text-field>
|
|
|
|
<md-outlined-button type="reset">Reset</md-outlined-button>
|
|
</form>
|
|
<style>
|
|
form {
|
|
display: flex;
|
|
flex-direction: column;
|
|
align-items: flex-start;
|
|
gap: 16px;
|
|
}
|
|
</style>
|
|
</body>
|
|
```
|
|
|
|
<!-- LINT.ThenChange(./g3doc/docs/quick-start.md) -->
|