SuperAPI AI 工具集

m3-web-webcomponents

通用与其它

查看项目

更新于 10-16 08:09

技能介绍

用途:在项目中实现 Material Design 3 界面,使用 Google 官方 @material/web 组件库。它基于 Lit 构建,框架无关,凡支持 Custom Elements 的框架均可使用;选择它的理由通常是采用官方 M3 实现、需要跨框架组件、偏好标准化 Web Components,或重视稳定性而非前沿特性。该库处于维护模式:稳定,但不再接收重大新功能。

安装:npm install @material/web

用法:按需逐个导入组件以支持 tree-shaking,例如 import '@material/web/button/filled-button.js'、'@material/web/textfield/outlined-text-field.js'、'@material/web/checkbox/checkbox.js' 等。组件以自定义元素形式在模板中使用,如 <md-filled-button>、<md-outlined-text-field label="Email" type="email">、<md-navigation-bar>、<md-checkbox>、<md-switch>、<md-slider>、<md-fab>、<md-linear-progress>、<md-chip-set> 等。

主题:通过 CSS 自定义属性设置令牌,包括颜色(--md-sys-color-primary、--md-sys-color-surface 等)、排版(--md-ref-typeface-brand、--md-ref-typeface-plain)与形状(--md-sys-shape-corner-*)。技能目录内附 m3-theme.css 完整主题模板,可复制到项目后自定义;另可用 material-theme-builder 技能从源色生成令牌集。

框架集成:可用于 React、Vue、Svelte、Angular,具体集成方式参见各框架的 M3 技能。

检查清单:仅导入所需组件、通过 CSS 自定义属性应用颜色令牌、配置排版字体令牌、按框架正确处理自定义元素事件、测试明暗两种模式、确保字体(Roboto、Material Symbols)正确加载。

限制:处于维护模式,不提供重大新功能;资料未提供价格、收费与性能数据,暂未提供。