material-themeable

An extension to angular material

Gives you the ability to add angular theming to any component. Also gives greater access to material theme colors, such as 'darker' and 'lighter'. If you are really brave you can even access the raw palette colors i.e. '50' - '900' and 'A100' - 'A700'.

Demo

coming soon

Installation

npm install material-themeable -P

In your styles.scss import the theme

@import "~material-themeable/theming";

Right after you include your angular theme, include material themeable

So from this

@include angular-material-theme($my-theme);

to this

@include angular-material-theme($my-theme);
@include material-themeable($my-theme);

if you have multiple themes available you will need to include material themeable just as you do the angular theme

body {
...
    @include angular-material-theme($my-theme);
    @include material-themeable($my-theme);
    
    &.dark {
      @include angular-material-theme($my-dark-theme);
      @include material-themeable($my-dark-theme);
    }
}

Usage

Add the matThemeable attribute to your HTML tag along with one or more of the Input attributes. Adding the matThemeable on it's own won't have any impact on the HTML element

HTML elements

<div matThemeable color="primary">test</div>

Angular Material Components

It's possible to extend standard angular material components

<mat-toolbar matThemeable color="primary" hue="lighter">
  <h1>Title</h1>
</mat-toolbar>

This will give a standard material tool bar, but using the themes primary light color

Inputs

Input	Description	Type
color	sets the background color and text color using a one of the themes palettes	MatThemeablePalette
hue	modifies the color using additional colors in the palette	MatThemeableHue
layout	sets a predefined layout, if used margin and padding are ignored	MatThemeableLayout
margin	sets predefined margin, if used horizontalMargin and verticalMargin are ignored	MatThemeableSize
padding	sets predefined padding, if used horizontalPadding and verticalPadding are ignored	MatThemeableSize
horizontalMargin	sets predefined margin-left and margin-right	MatThemeableSize
verticalMargin	sets predefined margin-top and margin-bottom	MatThemeableSize
horizontalPadding	sets predefined padding-left and padding-right	MatThemeableSize
verticalPadding	sets predefined padding-top and padding-bottom	MatThemeableSize

Types

MatThemeableHue

Warning - using this option can very quickly lead to an incoherent design! If you do use this input it is recommended to only use the 'default', 'lighter' and 'darker'. This is especially true if your site has the ability to switch themes.

Don't say you weren't warned!!!

• '50'
• '100'
• '200'
• '300'
• '400'
• '500'
• '600'
• '700'
• '800'
• '900'
• 'A100'
• 'A200'
• 'A400'
• 'A700'
• 'default'
• 'lighter'
• 'darker'

MatThemeableLayout

• 'small'
• 'standard'
• 'large'
• 'very-large'

MatThemeablePalette

• 'base'
• 'primary'
• 'accent'
• 'warn'

MatThemeableSize

• 'none'
• 'very-small'
• 'small'
• 'standard'
• 'large'
• 'very-large'