New to AngularJS? Before getting into AngularJS Material, it might be helpful to:
- watch the videos about AngularJS framework
- read the Material Design specifications for components, animations, styles, and layouts.
How do I start with AngularJS Material?
- Visit the CodePen Community for AngularJS Material
- Learn with Material-Start: 10-step Tutorial (es6)
- Learn with Material-Start: Completed (es6)
- Learn with Material-Start: Completed (Typescript)
- Learn with Material-Start: Completed (es5)
- Start with a blank CodePen Material Application
- Use the Github Starter Project
- Use the "Edit on CodePen" button on any of our Demos
Build a Material Application (blank shell)
See this example application on CodePen that loads the AngularJS Material library from the Google CDN:
Now just your add your AngularJS Material components and other HTML content to your Blank starter app.
Our CodePen Community
You can also visit our CodePen Community to explore more samples and ideas.
Installing the AngularJS Material Libraries
You can install the AngularJS Material library (and its dependent libraries) in your local project using either NPM, JSPM, or Bower.
AngularJS Material also integrates with some additional, optional libraries which you may elect to include:
- ngMessages - Provides a consistent mechanism for displaying form errors and other messages.
- ngSanitize - The ngSanitize module provides functionality to sanitize HTML content in Material components.
- ngRoute - Provides a clean routing system for your application.
Unsupported Integrations
AngularJS Material v1.0 has known integration issues with the following libraries:
- ngTouch - AngularJS Material conflicts with ngTouch for click, tap, and swipe support on touch-enabled devices.
- Ionic - Open-source SDK for developing hybrid mobile apps with Web technologies has touch support that interferes with AngularJS Material's mobile gesture features.
Contributing to AngularJS Material
- Please read our contributor guidelines.
- To contribute, fork our GitHub repository.
- For problems, search the GitHub Issues and/or create a New Issue.
- For questions, search the Forum and/or post a new question.
- Join the Gitter Chat.