这个项目能做什么
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 表单。
评论
0 评分人数达到10人后显示
登录后参与讨论。