Materialize 安装全攻略:CDN、npm 与 Sass 多种方式的快速部署清单
【免费下载链接】materializeMaterialize, a CSS Framework based on Material Design项目地址: https://gitcode.com/gh_mirrors/ma/materialize
Materialize 是一个基于 Material Design 的 CSS 框架,为网页提供现成的卡片、模态框、导航栏等组件。本文汇总 CDN、npm、Sass 三种安装方式与克隆仓库的完整部署清单,帮你 5 分钟上手。
一、先选对方式:Materialize 安装方式对比清单
不同项目类型适合不同的安装方式,先对号入座 ⬇️
| 安装方式 | 适合场景 | 上手难度 |
|---|---|---|
| CDN 引入 | 静态页面、快速原型、不想配构建工具 | ⭐ |
| npm 安装 | 使用打包工具(Webpack/Vite)的工程项目 | ⭐⭐ |
| Sass 定制 | 需要按需引入组件、改主题变量 | ⭐⭐⭐ |
| 克隆仓库 | 二次开发、参与贡献 | ⭐⭐⭐ |
官方对四种方式的说明可见 jade/getting_started/getting_started_content.html,版本更新记录见 CHANGELOG.md。
二、CDN 引入:零配置的最快 Materialize 安装方法
不用任何命令行,把两行标签写进 HTML 即可。以官方文档推荐的 cdnjs 平台 1.0.0 版本为例:
<!-- Compiled and minified CSS --> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/materialize/1.0.0/css/materialize.min.css"> <!-- Compiled and minified JavaScript --> <script src="https://cdnjs.cloudflare.com/ajax/libs/materialize/1.0.0/js/materialize.min.js"></script>💡 小贴士:建议同时引入 Google 的 Material Icons 图标字体,组件里的
menu、search等图标才能正常显示。
三、npm 安装:工程化项目推荐用法
在项目根目录执行:
npm install materialize-css安装完成后,包的主入口在 package.json 中已声明好:
- JS 入口:
dist/js/materialize.js(main字段) - 样式入口:
dist/css/materialize.css(style字段) - Sass 源码入口:
sass/materialize.scss(sass字段)
也就是说打包工具能自动找到对应文件,在 JS 中import 'materialize-css'或直接引用 dist 下的文件都可以。
四、Sass 定制:只打包你需要的 Materialize 组件
npm 包自带全部 Sass 源码,入口是 sass/materialize.scss。想改主题色、圆角、阴影?改这里 👇
- 主题变量:sass/components/_variables.scss
- 组件样式:
sass/components/目录,如 _cards.scss、_modal.scss、_navbar.scss - 表单控件:sass/components/forms/ 下有输入框、复选框、开关等 8 个文件
按需引入的写法(只编译 cards 和 modal 两个组件):
@import "materialize-css/sass/components/cards"; @import "materialize-css/sass/components/modal";仓库自带的 Gruntfile.js 已配置好sass任务,将 sass/materialize.scss 编译为dist/css/materialize.css和压缩版materialize.min.css,无需自己搭编译链。
五、克隆仓库:本地跑起 Materialize 文档站
需要修改源码或贡献代码时,直接克隆仓库:
git clone https://gitcode.com/gh_mirrors/ma/materialize cd materialize npm install grunt monitor编译完成后浏览器打开localhost:8000即可看到实时文档站(基于 BrowserSync,改动即时刷新)。前提是电脑已装好 Node.js。
六、部署完成后的目录结构检查表
无论哪种方式,导入 Materialize 后的标准目录如下:
MyWebsite/ |-- css/ | |-- materialize.css |-- fonts/ | |-- roboto/ |-- js/ | |-- materialize.js |-- index.htmlHTML 中的关键写法(脚本放 body 末尾,加载更快):
<head> <link href="css/materialize.min.css" type="text/css" rel="stylesheet"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> </head> <body> <script src="js/materialize.min.js"></script> </body>七、加速部署:官方 Starter 模板一键起步
不想从零搭页面?仓库内附两套开箱即用的模板:
- Starter 模板:含导航栏、CTA 按钮、图标特性区块,入口 templates/starter-template/index.html,完整包可下载 templates/starter-template.zip
- Parallax 视差模板:带视差滚动效果,入口 templates/parallax-template/index.html,完整包 templates/parallax-template.zip
把模板里的css/换成你按上面清单部署的 Materialize 文件,就能立刻开工 🚀
八、常见问题快速排查
| 现象 | 原因与解决 |
|---|---|
| 页面没有 Materialize 样式 | 检查 CSS 链接路径;CDN 方式确认网络可访问 |
| 图标显示为方框 | 未引入 Material Icons 字体 |
| 组件无动效(如 Sidenav 打不开) | 漏引materialize.js,或脚本位置在 head |
| 移动端布局错乱 | 缺少<meta name="viewport">标签 |
| npm 装的是旧版 | 检查 package.json 中版本,npm update materialize-css |
浏览器兼容方面,Materialize 支持 Chrome 35+、Firefox 31+、Safari 9+、IE 11+,详情见 README.md。
按照这份清单,从 CDN 的 2 行代码到 Sass 的深度定制,都能快速把 Materialize 部署进你的项目。
【免费下载链接】materializeMaterialize, a CSS Framework based on Material Design项目地址: https://gitcode.com/gh_mirrors/ma/materialize
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考