CHANGELOG.md

0.6.0-rc1 (2014-11-18)

v0.6.0-rc1 releases the following changes:

• improvements to the ink Ripple effects
• namespace prefixing Material attributes
• revised the Layout system to be more intuitive and responsive
• added enhancements for modular builds and distrbution for each component
• improved minification and SHA tags for each deployed .js and .css file
• numerous bug fixes to improve stability, adds responsive features, and enhances API documentation.

Bug Fixes

• button: fix css for md-fab icon position when href is present (a7763fde, closes #591)
• card: make md-card themeable (55cdb5b7, closes #619)
• demos: dialog, bottomsheet, and toast now display within properly within the bounding d (5909f0a5)
• docs:
  • fix error in flex docs (a02469b2)
  • improve responsive docs (4a846b4c)
• layout: updates layout attributes in index template (669d0048)
• md-button: improve a11y: make title, aria-label work (ff576289, closes #512)
• ripple: fix ripple sometimes appearing when the element is disabled (58eaef49)
• sidenav:
  • make backdrop invisible when sidenav is locked-open (4a75d599)
  • clean registry when element is destroyed (e7a3bd8d, closes #473)
• slider: update discrete slider thumb text while dragging (2877585e, closes #622)
• themes: bring blue, red, and green colors up to latest spec (de3ff4b8)

Features

• layout:
  • add new layout system (d51a44c5)
  • add layout-wrap attribute to set flex-wrap to wrap (4f755eab, closes #634)
• styles: add 'swift' css transitions to all components according to spec (15bb142c, closes #611)
• mdThemingProvider: add alwaysWatchTheme options, fix docs (0a404088)
• radioGroup: add up/down arrow navigation (367e47db, closes #538)
• tabs: add accessibility links between tabs and content (5d3bab56)
• bottomSheet: focus the first available button on open (768cc098, closes #571)
• interimElement: allow options.parent to be a selector (342051e0, closes #640)
• mdDialog: enhance show API with confirm() and alert() builder functions. (12b8cbc06.
  See Demos JavaScript source

$mdDialog.show(
      $mdDialog.alert()
        .title('This is an alert title')
        .content('You can specify some description text in here.')
        .ariaLabel('Password notification')
        .ok('Got it!')
        .targetEvent(ev)
    );

Breaking Changes

• To provide improved clarity and easier usages, the Layout system has been revised (d51a44c5).
  See the updated Layout sections for details. We associate labels with specific breakpoints:

Label	Size (dp)	Attribute
Phone	0 <= size <= 600	layout-sm
Tablet	600 > size <= 960	layout-md
Tablet-Landscape	960 >= size <= 1200	layout-lg
PC	> 1200	layout-gt-lg

Example 1: To use a horizontal layout and responsively change to vertical for screen sizes < 600 dp:

> ``` > > **Example 2**: To use a *horizontal* layout and change to *vertical* for *phone* and *tablet* screen sizes: >```html

``` > **Example 3**: To show an element except when on a *phone* (or smaller) screen size: >```html

``` > **Example 4**: To always hide an element, but show it only on phone (or smaller) devices: >```html

```

• For performance, the disabled attribute is no longer supported; instead the ng-disabled attribute is now read to check if a component is disabled. (2ece8cd7)

If you use the disabled attribute on a component to set whether it is disabled, change it to an ng-disabled expression. Change your code from this:

<md-checkbox disabled></md-checkbox>

To this:

<md-checkbox ng-disabled="true"></md-checkbox>

• All material component attributes and are now namespaced with the md- prefix; these changes do not affect ng- prefixes or standard html5 prefixes (eb2f2f8a). Affected attributes:

  • <md-button md-no-ink="" >
  • <md-content> (92b76435)
    • md-scroll-x
    • md-scroll-y
    • md-scroll-xy
  • <md-divider md-inset="" >
  • <md-linear-progress md-buffer-value="someValue" md-mode="query" >
  • <md-circular-rogress md-mode="query" md-diameter="60" >
  • <md-sidenav>
    • md-is-open="isOpen"
    • md-is-locked-open="isLockedOpen"
    • md-component-id="my-sidenav"
  • <md-tabs>
    • md-selected="selectedIndex"
    • md-on-select="doSomething()"
    • md-on-deselect="doSomething()"
    • md-active="tabIsActive"
  • <md-text-float md-fid="someId">

• When using the <md-button> directive, the compiled element will now be a normal <a> or <button> element with the class="md-button" attribute. (d835f9ee)

Any css referencing the md-button element selector should now reference the .md-button class selector. Change your CSS overrides from this:

md-button {
 color: red;
}

To this:

.md-button {
 color: red;
}

0.5.1 (2014-10-31)

Version 0.5.0 introduces theming support, improves stability, adds responsive features, and enhances API documentation.

Features

• theming: introduce theming support, documented at Theming Introduction (80768270)
• sidenav:
  • add is-open attribute binding (f66795e8)
  • add is-locked-open attribute binding with media query support (105b0e0a, closes #446)

Bug Fixes

• mdAria: add better warnings (3368c931, closes #366)
• md-input-group: disable with ARIA (72bad32a)
• slider: slider default value in ng-repeat corrected (b652d863, closes #479)
• css:
  • add autoprefixer support for firefox and ie (a1bea485)
  • fix invalid flex properties (c1d9b5a2)
  • remove deprecated css properties (c7e3a83c)
• textFloat:
  • improved logic to determine if md-input has a value (5c407b5f)
  • improve ARIA pairing links between label and input (457b3750, closes #483)
  • added support for label/hint expressions (3674a514, closes #462)
  • fix keyboard tabbing support (27f43751, closes #458)

Breaking Changes

• colors:
  • The md-theme-* classes have all been removed, in favor of themes.
  • Instead, use md-primary and md-warn classes on an element when a theme is set.
• bottomSheet:
  • list class has been renamed to md-list
  • grid class has been renamed to md-grid
  • has-header class has been renamed to md-has-header
  • grid-text class has been renamed to md-grid-text.
• button:
  • md-button-colored class has been changed to md-primary and md-warn color classes.
  • All classes that start with md-button-fab now start with md-fab.
    • md-button-fab to md-fab.
    • md-button-fab-top-left to md-fab-top-left
    • md-button-fab-top-right to md-fab-top-right
    • md-button-fab-bottom-left to md-fab-bottom-left
    • md-button-fab-bottom-right to md-fab-bottom-right
  • md-button-cornered class has been changed to md-cornered
  • md-button-icon class has been changed to md-icon
  • md-button-raised class has been changed to md-raised
• content: md-content-padding class has been renamed to md-padding.
• dialog:
  • dialog-content class has been removed. Use an md-content element instead.
  • dialog-actions has been renamed to md-actions
• subheader: md-subheader-colored is now md-primary.
• textFloat:
  • use of <md-input-group> is deprecated, <md-text-float> markup can be used for most cases
• toast: toast-action has been renamed to md-action
• toolbar:
  • md-toolbar-tall class has been renamed to md-tall
  • md-toolbar-medium-tall class has been renamed to md-medium-tall
• whiteframe: md-whiteframe-z* classes no longer set z-index, only shadow

0.4.2 (2014-10-16)

This release adds support for the official Angular 1.3 release and includes improvements to both the document generator and component demos.

Note that <md-input-group> and <md-input> are deprecated in favor on <md-text-float>. While both directives are still available for more granular control, developers are encouraged to use the <md-text-float> directive whenever possible.

Features

• text-float: Add floating label text field (25cf6f1)

Bug Fixes

• Focus management for docs views (9afe28a8)
• bottomSheet: use position:fixed so it does not move (bfaf96d8)
• ripple: use contentParent scroll offset (4c0c50e4, closes #416)
• slider:
  • disabled sliders still usable w/ keys (f78f1b34)
  • disabled discrete sliders still usable (1f5ce090)
• subheader: sort items correctly in browsers that dont support true/false (d8e5079e, closes #438)
• tabs: remove tabs all at once on controller destroy (7237767d, closes #437)

0.4.1 (2014-10-15)

Version 0.4.1 changes the prefix for all services and directives from 'material' to 'md'.

To migrate your code, replace all instances of 'material' in your project with 'md':

sed -i '' 's/material/md/g' $(echo my-material-project/app/**/*.{js,html,css})

Additionally, material-linear-progress has been renamed to md-progress-linear and material-circular-progress has been renamed to md-progress-circular.

angular-aria is now a dependency. Be sure to include angular-aria.js before angular-material. See https://github.com/angular/bower-material#usage.

0.4.0 (2014-10-06)

Version 0.4 incorporates four (4) new components: circular progress, subheader, tooltip and bottom sheet. A new API has also been introduced for $materialDialog and $materialToast. Additionally, many small component functionality and performance issues have been resolved.

v0.4 is tested on desktop Chrome, Safari and Firefox, as well as Android 4.4+ and iOS7.

Breaking Changes

The services $materialDialog and $materialToast have changed API(s). See section at bottom for Change Details.

Bug Fixes

• button:
  • no underline when button has a href (948aef0d)
  • disabled raised and fab buttons don't hover on focus (6d0ca8fb, closes #358)
• checkbox: resolve TypeError for inputDirective.link (4da56732)
• dialog: cancel instead of hiding when user escapes/clicks out (0cc21d47)
• interimElement: make cancel and hide not fail when no element is shown (6162156d)
• progress-linear: Add aria, tests and better animations (3b386276, closes #297)
• radio: Radio button a11y (05ed42de, closes #310)
• toolbar: Demo correct heading levels (fd7697d6)
• ripple:
  • make detach method work properly (c3d858a2)
  • ripple container self-removal NPE fixed. (664ab996)
• sidenav:
  • add display: none; while closed (8f104012, closes #300)
  • always leave >=56px of room, no matter the screensize (13a26670, closes #346)
• slider: discrete mode supports live dragging and snap-to (b231f1c0, closes #331)
• textfield:
  • ng-model bindings now working and demo rendering fixed. (e8f456fc)
  • match float-label (light theme) specifications (63eeb47f)

Features

• progress-circular: Add circular progress component (07d56533, closes #365)
• subheader: add subheader component with sticky scroll (7787c9cc, closes #216)
• tooltip: add tooltip component (9f9b0897, closes #354)
• bottomSheet add bottomSheet component (3be359c)

#### Details on Breaking Changes

1) $materialDialog:

Change your code from this:

var hideDialog = $materialDialog(options);
hideDialog();

To this:

$materialDialog
  .show(options)
  .then(
	function success(response) {},
	function cancelled(reason) {}
   );

// Hides the dialog last shown with `show()`
// and resolves the show() promise with `response`

$materialDialog.hide(response);

// Hides the dialog last shown and rejects the `show()`
// promise with the `reason`

$materialDialog.cancel(reason);

Note: If you previously provided a controller option to $materialDialog, that controller would be injected with a $hideDialog function. This feature no longer exists; use $materialDialog.hide().

2) $materialToast:

Change your code from this:

var hideToast = $materialToast(options);
hideToast();

To this:

$materialToast
  .show(options)
  .then(
	function success(response) {},
	function cancelled(reason) {}
  );


// Hides the dialog last shown with `show()`
// and resolves the show() promise with `response`

$materialToast.hide(response);

// Hides the dialog last shown and rejects the `show()`
// promise with the `reason`

$materialToast.cancel(reason);

Note: If you previously provided a `controller` option to `$materialToast`, that controller would be injected with a `$hideToast` function. This feature no longer exists; use `$materialToast.hide()`.

v0.0.3 (2014-09-19)

v0.0.3 includes many bug fixes, performance, and usability improvements to existing components, as well as introducing the slider, switch, divider, and linear progress components.

Additionally, accessibility support is added to material-button, material-checkbox, material-radio-button, material-slider, material-dialog and material-list. With added ARIA support including roles, states and properties, Angular Material directives now also communicate to users of assistive technologies. Additionally, tabIndex and focus management are handled dynamically where appropriate.

0.0.3 is tested on desktop Chrome, Safari and Firefox, as well as Android 4.4+ and iOS 7+. Also tested with VoiceOver on OSX and iOS7, ChromeVox, JAWS, NVDA and ZoomText.

Bug Fixes

• button: don't use angular transclusion at all, manual only (6b322729)
• card: make it use up proper width with margin (f33185ff, closes #247)
• demo: tab demos improved layout and accessibility (8915c324)
• dialog: use position:fixed instead of absolute (6ba874d8, closes #249)
• iterator: update add()/remove() logic (6a596b32)
• material-dialog: Focus mgmt, ARIA attributes (fe054ae6)
• material-list: Add semantics (6e48cd35)
• material-slider: Adds missing ARIA role (903cbc06)
• ripple:
  • fix bug with ripple and many clicks (c2105c05)
  • make checkbox only scale up to 1.0, looks good on ios (ed65da9b)
  • use css animations for performance (96014e08)
• slider: watch ngDisabled expr on non-isolate parent scope (5f1923d5, closes #272)
• switch: correctly adjust when label will not fit on one line (e912a838, closes #80)
• tabs:
  • make the ink ripple use the color of the ink bar. (c5ca159a, closes #280)
  • don't paginate on initial load when width is 0 (5f5435d1, closes #271)
  • use position: absolute container to fix ios bugs (7d0a282f, closes #220)
  • Tab pagination/selection now works properly on iOS (3410650d, closes #220, #231)
  • Tab pagination/selection now works properly on iOS (c77c0e26, closes #220, #231)
  • remove window resize listener on $destroy (4b887f1e, closes #254)
• toolbar:
  • make scrollShrink work with transforms, better performance (cf1ab59f, closes #295)
  • typo onScroll -> onContentScroll (cf31b1a5)

Features

• add hammerjs dependency (e383e4f4)
• $materialToast: add swipe-to-close functionality (22285dc4)
• divider: add implementation of the divider component (e3aceeae, closes #194)
• docs: added support for the doc app to show its associated Git SHA id/link (02d2e5d2)
• progressLinear: Add linear progress indicator (f87d0452, closes #187)
• material-dialog: on open focus .dialog-close or the last button (8f756fc6, closes #222)
• material-switch: add switch component (4975c743, closes #80)
• slider: add full-featured slider component (5ea4dbc2, closes #260, #31)
• switch: add focus styles (8878ca7a)
• tabs: improvements to pagination, disabled tabs, and tab navigation. (b4244bf3)