angular_components 0.9.0-alpha+3

The official Material Design components for AngularDart. Used at Google in production apps.

Material design components for AngularDart. Powering some of Google's most sophisticated and mission-critical applications.

This productive and stable set of widgets, contributed to by hundreds of Googlers, make debugging and deploying your app easier. Strict latency and testing policies make these widgets an excellent fit for projects using the Angular package.

NOTE: As of angular 5.0.0-alpha+1 dependency_overrides are required:

dependency_overrides:
  analyzer: ^0.31.0-alpha.1

This is because Angular is starting to use and support the Dart 2.0.0 SDK, which is evolving. We expect to no longer require overrides once we are at a beta release, but this is unlikely until sometime in early 2018.

This is a continually growing set of widgets. See the example gallery and the documentation for a full list. Recent additions include:

• Material Menu
• Material Auto-suggest Input
• Material Select Searchbox

At this time we are not taking pull requests, but please file an issue and we will work with you.

Officially supported browsers: The last two versions of Chrome, Edge, Firefox, and Safari.

Package build_runner support

Version 0.9.0-alpha+3 added experimental support for users of package build_runner. To build your project with build_runner:

1. Add two dev_dependencies to your packages pubspec.yaml file:

dev_dependencies:
  build_runner: ^0.7.0
  build_web_compilers: ^0.1.1

2. Run pub get --no-precompile (avoids pre-compiling unused transformers).
3. Build your package:

pub run build_runner build

Or run a local development server:

pub run build_runner serve

Useful links

• Example gallery
• AngularDart Components resources:
  • About AngularDart Components
  • Google I/O 2017 codelab
  • Dart Summit 2016 codelab
  • API reference
• AngularDart resources:
  • AngularDart documentation
  • angular pub package
• Material Design site

Required Icon Font

For icons to appear, add the following icon font download to your page. Example

<link
  rel="stylesheet"
  type="text/css"
  href="https://fonts.googleapis.com/icon?family=Material+Icons">

Custom component styles

The styles of these components can be customized via Sass mixins.

1. Add a dependency on the sass_builder package and add the transformer.

In your pubspec.yaml:

dependencies:
  sass_builder ^1.0.1 # update for the latest version
transformers:
- sass_builder
- angular

NOTE: Be sure you add the sass_builder transformer before the angular transformer.

2. Now you can import styles and mixins from this package via dart style package imports in your Sass files.

In your .scss files:

@import 'package:angular_components/css/material/material';

.blue {
  color: $mat-blue;
}

Project Roadmap

Our current work is summarized in the roadmap for this quarter.