angular2-mdl

WebJar for angular2-mdl

License

License

MIT
Categories

Categories

Github Development Tools Version Controls Angular User Interface Web Frameworks
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

github-com-mseemann-angular2-mdl
Last Version

Last Version

0.0.0
Release Date

Release Date

Type

Type

jar
Description

Description

angular2-mdl
WebJar for angular2-mdl
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/mseemann/angular2-mdl

Download github-com-mseemann-angular2-mdl

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/github-com-mseemann-angular2-mdl/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>github-com-mseemann-angular2-mdl</artifactId>
    <version>0.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/github-com-mseemann-angular2-mdl/
implementation 'org.webjars.npm:github-com-mseemann-angular2-mdl:0.0.0'
// https://jarcasting.com/artifacts/org.webjars.npm/github-com-mseemann-angular2-mdl/
implementation ("org.webjars.npm:github-com-mseemann-angular2-mdl:0.0.0")
'org.webjars.npm:github-com-mseemann-angular2-mdl:jar:0.0.0'
<dependency org="org.webjars.npm" name="github-com-mseemann-angular2-mdl" rev="0.0.0">
  <artifact name="github-com-mseemann-angular2-mdl" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='github-com-mseemann-angular2-mdl', version='0.0.0')
)
libraryDependencies += "org.webjars.npm" % "github-com-mseemann-angular2-mdl" % "0.0.0"
[org.webjars.npm/github-com-mseemann-angular2-mdl "0.0.0"]

Dependencies

compile (3)

Group / Artifact Type Version
org.webjars.npm : angular__common jar 2.4.8
org.webjars.npm : angular__core jar 2.4.8
org.webjars.npm : angular__forms jar 2.4.8

Project Modules

There are no modules declared in this project.

Angular 11 components, directives and styles based on material design lite https://getmdl.io (v: 1.3.0). This package assumes that you are building an Angular app with TypeScript. Angular CLI makes it even easier but isn't required.

Build Status CircleCI npm version Downloads Coverage Status Code Climate FOSSA Status

Status of the npm package version 11 (mdl version 1.3.0; angular 11)

  • Badges
  • Buttons
  • Cards
  • Chips
  • Dialogs (imperative and declarative)
  • Icons
  • Loading
  • Shadow
  • Toggle (Checkbox, Radio, Icon Toggle, Switch)
  • Lists
  • Slider
  • Snackbar
  • Table
  • Tooltips
  • Menu
  • Layout (standard, scroll, waterfall, tabs)
  • Tabs
  • Textfields (multiline, expandable)

Installation

npm install @angular-mdl/core --save

css from material-design-lite

You may include the material-design-lite css in your html and you're done!

<link rel="stylesheet" href="https://code.getmdl.io/1.1.3/material.indigo-pink.min.css"/>
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">

Under http://mseemann.io/angular2-mdl/theme you'll find a customizing tool to change the theme colors.

How to use the scss files from material-design-lite

This package includes the scss files from material-design-lite. With these files you are able to change the colors and other variables in your own scss files:

@import "~@angular-mdl/core/scss/color-definitions";

$color-primary: $palette-blue-500;
$color-primary-dark: $palette-blue-700;
$color-accent: $palette-amber-A200;
$color-primary-contrast: $color-dark-contrast;
$color-accent-contrast: $color-dark-contrast;

@import '~@angular-mdl/core/scss/material-design-lite';

To make this working you need to find out the way how you could tell your build system where the scss is located. For example with webpack you can use the special ~@angular-mdl/core syntax used above. Or you can configure the includePaths:

sassLoader: {
  includePaths: [util.root('node_modules', '@angular-mdl/core', 'scss')]
}

@angular-mdl/*

Additional components for @angular-mdl/core that are not part of material design lite

  • current angular version: 11
  • current angular-mdl version: 11

The components

Name Provided By Description npm documentation status demo
datepicker mseemann a simple date picker npm version readme experimental demo
expansion-panel abdulqadir93 organise arbitrary content in an expansion panel npm version readme experimental demo
fab-menu leojpod a fab menu component npm version readme experimental demo
popover tb popover with arbitrary content npm version readme experimental demo
select tb a select box npm version readme experimental demo

These components support AOT and TreeShaking!

How to use the components

Install the components via npm. Please check out the individual readme for each component from the table above.

Starting with version 0.2.0 the components each have no css styles imported by default. You need to setup your build pipeline to include the scss files from each component you want to use. This makes it possible to configure the theming for the components you want to use.

If you are using webpack you may use the special webpack import syntax for node_modules:

@import '~@angular-mdl/core/scss/color-definitions';

$color-primary: $palette-blue-500;
$color-primary-dark: $palette-blue-700;
$color-accent: $palette-amber-A200;
$color-primary-contrast: $color-dark-contrast;
$color-accent-contrast: $color-dark-contrast;

@import '~@angular-mdl/core/src/scss-mdl/material-design-lite';

@import '~@angular-mdl/popover/popover';
@import '~@angular-mdl/select/select';

Another way is to include each component folder in the search path for your scss preprocessor. An example for webpack:

sassLoader: {
	includePaths: [
		'node_modules/@angular-mdl/popover',
		'node_modules/@angular-mdl/select'
	]
}

Development

  • npm start - local dev server
  • npm build - build a production release
  • npm test - run the unit tests

The coverage report is stored under: coverage/coverage-remap/index.html

Contributing

Every contribution is welcome. Please checkout the CONTRIBUTION.md file.

Remarks

And if you would like to see a real world app that uses this package have a look at https://www.yovelino.de/apps/tour-planner/.

License

FOSSA Status

Versions

Version
0.0.0