material-design-lite README

The project's README from github.com/google/material-design-lite. As one markdown file: README.md.

Material Design Lite

npm version

An implementation of Material Design components in vanilla CSS, JS, and HTML.

Material Design Lite (MDL) lets you add a Material Design look and feel to your static content websites. It doesn't rely on any JavaScript frameworks or libraries. Optimized for cross-device use, gracefully degrades in older browsers, and offers an experience that is accessible from the get-go.

Limited support

Material Design Lite is now in limited support, with development having moved to the Material Components for the web repository.

No further development is taking place in MDL by the core team, but we are happy to review PRs, fix critical bugs and push out new releases. No breaking changes will be accepted.

Heads up: the old getmdl.io site is gone, and the documentation and component gallery that used to live there are no longer available. MDL itself still works fine as a vanilla set of Material Design CSS, JS, and HTML you can drop into any project — only the hosted docs site has been retired.

Use MDL on your site?

This document is targeted at developers that will contribute to or compile MDL. If you just want to use MDL on a website or web app, the safest bet is to self-host the v1.3.0 release, since the previously-recommended getmdl.io-hosted assets are no longer available.

Browser Support

IE9 IE10 IE11 Chrome Opera Firefox Safari Chrome (Android) Mobile Safari
B A A A A A A A A

A-grade browsers are fully supported. B-grade browsers will gracefully degrade to our CSS-only experience.

Download / Clone

Clone the repo using Git:

git clone https://github.com/google/material-design-lite.git

Alternatively you can download this repository.

Windows users, if you have trouble compiling due to line endings then make sure you configure git to checkout the repository with lf (unix) line endings. This can be achieved by setting core.eol.

git config core.eol lf
git config core.autocrlf input
git rm --cached -r .
git reset --hard

Remember, the master branch is considered unstable. Do not use this in production. Use a tagged state of the repository, npm, or bower for stability!

Feature requests

MDL is currently in limited support mode, with no further development taking place by the core team. We are happy to accept and review pull requests for new functionality, however, as long as there are no breaking changes.

Want to contribute?

If you found a bug, have any questions or want to contribute. Follow our guidelines, and help improve the Material Design Lite. For more information visit our wiki.

Please use the default branch, mdl-1.x.

Take note that Material Components for Web, which is MDL v2, is under early Alpha stages (which means everything is a moving target, and we can change anything at any moment). Use with caution.

However, we would absolutely love to have people testing MCW and provide feedback about their experiences using it, especially integrating with other frameworks and libraries.

License

© Google, 2015. Licensed under an Apache-2 license.

material-design-lite (google/material-design-lite)

Searching Database…

这是什么?Material Design Lite(MDL)是 Google 对 Material Design 组件的一套实现,可以为静态内容网站添加 Material Design 的外观和交互体验。
它是用来搭建应用的框架,还是直接拿来就能用的组件库?是一个拿来即用的组件库:纯原生 CSS、JS 和 HTML,不依赖 React 或 jQuery 之类的 JavaScript 框架——把它加进任何项目就能美化页面。
怎么把它加到我的网站上?可以从 v1.3.0 GitHub release 自托管预编译的 CSS 和 JS,使用 CDNJS 镜像,或者安装 npm 包 material-design-lite。不要用 master 分支——它被视为不稳定版本;想要稳定就用带版本号的正式发布版。
使用它需要 Node 或者构建步骤吗?不需要。你只要引入预编译好的 CSS 和 JS 文件即可;gulp 构建和 Node(0.12+)只有在你想要编译或给 MDL 本身贡献代码时才需要。
它还在积极开发吗?不在了——MDL 目前处于有限维护模式。开发工作已经转移到 Material Components for the web 仓库;核心团队不再开发新功能,但仍会审查 PR、修复严重 bug 并发布新版本,同时不接受任何破坏性改动。
它支持哪些浏览器?在 IE10/11、Chrome、Opera、Firefox、Safari、Chrome for Android 和 Mobile Safari 中获得完全支持(A 级)。IE9 属于 B 级:会平滑降级为纯 CSS 的体验。
以前的 getmdl.io 文档网站怎么了?它已经下线了:原来放在那里的文档和组件展示都不再可用。MDL 本身作为一套原生 Material Design 的 CSS、JS 和 HTML 仍然可以正常使用——只是托管文档的网站被停用了。
它的界面开箱即用就能满足无障碍要求吗?可以——README 中说 MDL 从一开始就注重无障碍访问,针对跨设备使用做了优化,并且在旧浏览器中能平滑降级。
有第 2 版可以关注吗?Material Components for the web 实际上就相当于 MDL v2,但它还处于早期 alpha 阶段——随时可能有任何变动。团队欢迎大家试用并提出反馈,尤其是在与其他框架集成方面。
Creator
google
Size
55.7 MB
Stars
32.2K
Age
11y
Commits · 90 Days