这个项目能做什么

Material Web 是由 material-components 组织维护的一个 Web 组件库。其目标是帮助构建美观且可访问的 Web 应用程序,并实现了 Google 开源设计系统的最新版本 Material 3。 它提供的内容: - 一组自定义元素(以 md- 为前缀),可用于纯 HTML 中,例如 md-checkbox、md-radio、md-outlined-text-field、md-outlined-button 和 md-icon-button。 - 一个共享的 "all.js" 入口点,用于导入完整的组件集,以及用于更精细加载的单个组件模块。 - 通过 typescale 样式模块 (md-typescale-styles.js) 提供排版支持,该模块公开了一个可采用的样式表,可推送到 document.adoptedStyleSheets 中。诸如 md-typescale-display-medium 和 md-typescale-body-medium 等实用类映射到 Material 的 typescale。 README 展示了一个无需构建的快速启动示例,通过 import map 和模块脚本从 CDN 加载库,并配合来自 Google Fonts 的 Roboto 网页字体。文档中的独立快速启动指南涵盖了安装和生产环境构建。 文档与资源: - docs/intro.md - 介绍 - docs/roadmap.md - 路线图 - docs/components/ - 各组件文档 - docs/size.md - 包体积信息 - docs/support.md - 浏览器支持与常见问题 - docs/quick-start.md - 安装与生产构建指南 项目状态: - README 明确指出 MWC (Material Web Components) 正处于等待新维护者的维护模式,并链接到了 GitHub 讨论。任何将其用于长期项目的评估者都应考虑这一点。 - 对于 Angular 用户,README 推荐使用 Angular Material 组件。 分发与许可背景: - 在 npm 上以 @material/web 发布,通过徽章显示版本和下载统计数据,也可通过 esm.run 和 jsDelivr 等 CDN 服务访问。 - 持续集成测试状态通过 GitHub Actions 工作流徽章公开,且仓库指向 Lit Discord 聊天以获取社区支持。 典型用法: 由于这些是标准 Web 组件,因此它们与框架无关,可以放入任何支持自定义元素的页面或应用程序中,包括静态站点、服务端渲染页面和 JavaScript 框架。样式和主题遵循 Material 3 约定,且表单关联控件可参与原生 HTML 表单。