☰
Materialize 安装全攻略:CDN、npm 与 Sass 多种方式的快速部署清单
2026/10/1 17:17:53 网站建设 项目流程

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.html

HTML 中的关键写法(脚本放 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询