demo(list): Add accessibility demo page for list

Author: tinayuangao

src/demo-app/a11y/a11y-module.ts

@@ -11,6 +11,7 @@ import {ButtonToggleAccessibilityDemo} from './button-toggle/button-toggle-a11y'
 import {CheckboxAccessibilityDemo} from './checkbox/checkbox-a11y';
 import {ChipsAccessibilityDemo} from './chips/chips-a11y';
 import {GridListAccessibilityDemo} from './grid-list/grid-list-a11y';
+import {ListAccessibilityDemo} from './list/list-a11y';
 import {RadioAccessibilityDemo} from './radio/radio-a11y';
 import {DatepickerAccessibilityDemo} from './datepicker/datepicker-a11y';
 import {IconAccessibilityDemo} from './icon/icon-a11y';
@@ -50,6 +51,7 @@ export class AccessibilityRoutingModule {}
     GridListAccessibilityDemo,
     IconAccessibilityDemo,
     InputAccessibilityDemo,
+    ListAccessibilityDemo,
     ProgressSpinnerAccessibilityDemo,
     RadioAccessibilityDemo,
     SliderAccessibilityDemo,

src/demo-app/a11y/a11y.ts

@@ -26,6 +26,7 @@ export class AccessibilityDemo {
     {name: 'Grid list', route: 'grid-list'},
     {name: 'Icon', route: 'icon'},
     {name: 'Input', route: 'input'},
+    {name: 'List', route: 'list'},
     {name: 'Progress spinner', route: 'progress-spinner'},
     {name: 'Radio buttons', route: 'radio'},
     {name: 'Slider', route: 'slider'},

src/demo-app/a11y/list/list-a11y.html

@@ -0,0 +1,66 @@
+<div class="demo-list">
+  <section>
+    <h2> Seasoning </h2>
+    <p>Showing a non-interactive list of seasonings.</p>
+    <md-list role="list">
+      <md-list-item *ngFor="let item of items"> {{item}} </md-list-item>
+    </md-list>
+  </section>
+
+
+  <section>
+    <h2>Mailbox navigation</h2>
+    <p>Showing a navigation list with links to google search</p>
+    <md-nav-list>
+      <a md-list-item *ngFor="let link of links"
+         href="https://www.google.com/search?q={{link.name}}">
+        {{link.name}}
+      </a>
+    </md-nav-list>
+  </section>
+
+  <section>
+    <h2>Messages</h2>
+    <p>
+      Showing a list of messages, where each message item has sender's name, sender's avatar,
+      message subject, and content of the message.
+    </p>
+    <md-list role="list">
+      <md-list-item *ngFor="let message of messages">
+        <img md-list-avatar [src]="message.image" [alt]="message.from">
+        <h3 md-line> {{message.from}} </h3>
+        <p md-line> {{message.subject}} </p>
+        <p md-line class="demo-secondary-text"> {{message.message}} </p>
+      </md-list-item>
+    </md-list>
+
+  </section>
+
+  <section>
+    <h2>Seasoning</h2>
+    <p>Showing a non-interactive list of seasonings with dense style.</p>
+    <md-list dense>
+      <md-list-item *ngFor="let item of items"> {{item}} </md-list-item>
+    </md-list>
+  </section>
+
+  <section>
+    <h2>Folders and notes for mailbox </h2>
+    <p>Showing a list with two sections, "folders" and "notes".</p>
+    <md-list role="list">
+      <h3 md-subheader>Folders</h3>
+      <md-list-item *ngFor="let folder of folders">
+        <md-icon md-list-icon>folder</md-icon>
+        <h4 md-line>{{folder.name}}</h4>
+        <p md-line class="demo-secondary-text"> {{folder.updated}} </p>
+      </md-list-item>
+      <md-divider></md-divider>
+      <h3 md-subheader>Notes</h3>
+      <md-list-item *ngFor="let note of notes">
+        <md-icon md-list-icgon>note</md-icon>
+        <h4 md-line>{{note.name}}</h4>
+        <p md-line class="demo-secondary-text"> {{note.updated}} </p>
+      </md-list-item>
+    </md-list>
+  </section>
+</div>

src/demo-app/a11y/list/list-a11y.scss

@@ -0,0 +1,11 @@
+.demo-list {
+  .mat-list, .mat-nav-list {
+    border: 1px solid rgba(0, 0, 0, 0.12);
+    max-width: 350px;
+    margin: 20px 20px 0 0;
+  }
+
+  .demo-secondary-text {
+    color: rgba(0, 0, 0, 0.54);
+  }
+}

src/demo-app/a11y/list/list-a11y.ts

@@ -0,0 +1,55 @@
+import {Component} from '@angular/core';
+
+@Component({
+  moduleId: module.id,
+  selector: 'list-a11y',
+  templateUrl: 'list-a11y.html',
+  styleUrls: ['list-a11y.css']
+})
+export class ListAccessibilityDemo {
+  items: string[] = [
+    'Pepper',
+    'Salt',
+    'Paprika'
+  ];
+
+  messages = [
+    {
+      from: 'Nancy',
+      subject: 'Brunch?',
+      message: 'Did you want to go on Sunday? I was thinking that might work.',
+      image: 'https://angular.io/generated/images/bios/julie-ralph.jpg'
+    },
+    {
+      from: 'Mary',
+      subject: 'Summer BBQ',
+      message: 'Wish I could come, but I have some prior obligations.',
+      image: 'https://angular.io/generated/images/bios/juleskremer.jpg'
+    },
+    {
+      from: 'Bobby',
+      subject: 'Oui oui',
+      message: 'Do you have Paris reservations for the 15th? I just booked!',
+      image: 'https://angular.io/generated/images/bios/jelbourn.jpg'
+    }
+  ];
+
+  links = [
+    {name: 'Inbox'},
+    {name: 'Outbox'},
+    {name: 'Spam'},
+    {name: 'Trash'}
+
+  ];
+
+  folders = [
+    {name: 'Imported', updated: 'Miles'},
+    {name: 'Important', updated: 'Tina'},
+    {name: 'Unread', updated: 'Jeremy'},
+  ];
+
+  notes = [
+    {name: 'Update screenshots', updated: 'Kara'},
+    {name: 'Install new application', updated: 'Andrew'},
+  ];
+}

src/demo-app/a11y/routes.ts

@@ -10,6 +10,7 @@ import {AccessibilityHome} from './a11y';
 import {DatepickerAccessibilityDemo} from './datepicker/datepicker-a11y';
 import {IconAccessibilityDemo} from './icon/icon-a11y';
 import {InputAccessibilityDemo} from './input/input-a11y';
+import {ListAccessibilityDemo} from './list/list-a11y';
 import {ProgressSpinnerAccessibilityDemo} from './progress-spinner/progress-spinner-a11y';
 import {SliderAccessibilityDemo} from './slider/slider-a11y';
 import {SnackBarAccessibilityDemo} from './snack-bar/snack-bar-a11y';
@@ -25,6 +26,7 @@ export const ACCESSIBILITY_DEMO_ROUTES: Routes = [
   {path: 'grid-list', component: GridListAccessibilityDemo},
   {path: 'icon', component: IconAccessibilityDemo},
   {path: 'input', component: InputAccessibilityDemo},
+  {path: 'list', component: ListAccessibilityDemo},
   {path: 'progress-spinner', component: ProgressSpinnerAccessibilityDemo},
   {path: 'radio', component: RadioAccessibilityDemo},
   {path: 'slider', component: SliderAccessibilityDemo},

src/lib/list/index.ts

@@ -13,10 +13,9 @@ import {
   MdList,
   MdListItem,
   MdListDivider,
+  MdNavList,
   MdListAvatarCssMatStyler,
   MdListIconCssMatStyler,
-  MdListCssMatStyler,
-  MdNavListCssMatStyler,
   MdDividerCssMatStyler,
   MdListSubheaderCssMatStyler
 } from './list';
@@ -29,12 +28,11 @@ import {MdSelectionList, MdListOption} from './selection-list';
     MdList,
     MdListItem,
     MdListDivider,
+    MdNavList,
     MdListAvatarCssMatStyler,
     MdLineModule,
     MdCommonModule,
     MdListIconCssMatStyler,
-    MdListCssMatStyler,
-    MdNavListCssMatStyler,
     MdDividerCssMatStyler,
     MdListSubheaderCssMatStyler,
     MdSelectionModule,
@@ -45,10 +43,9 @@ import {MdSelectionList, MdListOption} from './selection-list';
     MdList,
     MdListItem,
     MdListDivider,
+    MdNavList,
     MdListAvatarCssMatStyler,
     MdListIconCssMatStyler,
-    MdListCssMatStyler,
-    MdNavListCssMatStyler,
     MdDividerCssMatStyler,
     MdListSubheaderCssMatStyler,
     MdSelectionList,

src/lib/list/list.md

@@ -141,3 +141,12 @@ To add a divider, use `<md-divider>`.
    </md-list-item>
 </md-list>
 ```
+
+### Accessibility
+By default, the list assumes that it will be used in a purely decorative fashion and thus sets no
+roles, ARIA attributes, or keyboard shortcuts. This is equivalent to having a sequence of <div>
+elements on the page. Any interactive content within the list should be given an appropriate
+accessibility treatment based on the specific workflow of your application.
+
+If the list is used to present a list of non-interactive content items, then the list element should
+be given `role="list"` and each list item should be given `role="listitem"`.

src/lib/list/list.ts

@@ -42,37 +42,33 @@ export const _MdListItemMixinBase = mixinDisableRipple(MdListItemBase);
 })
 export class MdListDivider {}
 
+
 @Component({
   moduleId: module.id,
-  selector: 'md-list, mat-list, md-nav-list, mat-nav-list',
-  host: {'role': 'list'},
+  selector: 'md-nav-list, mat-nav-list',
+  host: {
+    'role': 'navigation',
+    'class': 'mat-nav-list'
+  },
   template: '<ng-content></ng-content>',
   styleUrls: ['list.css'],
   inputs: ['disableRipple'],
   encapsulation: ViewEncapsulation.None,
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
-export class MdList extends _MdListMixinBase implements CanDisableRipple {}
+export class MdNavList extends _MdListMixinBase implements CanDisableRipple {}
 
-/**
- * Directive whose purpose is to add the mat- CSS styling to this selector.
- * @docs-private
- */
-@Directive({
+@Component({
+  moduleId: module.id,
   selector: 'md-list, mat-list',
-  host: {'class': 'mat-list'}
-})
-export class MdListCssMatStyler {}
-
-/**
- * Directive whose purpose is to add the mat- CSS styling to this selector.
- * @docs-private
- */
-@Directive({
-  selector: 'md-nav-list, mat-nav-list',
-  host: {'class': 'mat-nav-list'}
+  template: '<ng-content></ng-content>',
+  host: {'class': 'mat-list'},
+  styleUrls: ['list.css'],
+  inputs: ['disableRipple'],
+  encapsulation: ViewEncapsulation.None,
+  changeDetection: ChangeDetectionStrategy.OnPush,
 })
-export class MdNavListCssMatStyler {}
+export class MdList extends _MdListMixinBase implements CanDisableRipple {}
 
 /**
  * Directive whose purpose is to add the mat- CSS styling to this selector.
@@ -146,9 +142,9 @@ export class MdListItem extends _MdListItemMixinBase implements AfterContentInit
   constructor(private _renderer: Renderer2,
               private _element: ElementRef,
               @Optional() private _list: MdList,
-              @Optional() navList: MdNavListCssMatStyler) {
+              @Optional() private _navList: MdNavList) {
     super();
-    this._isNavList = !!navList;
+    this._isNavList = !!_navList;
   }
 
   ngAfterContentInit() {
@@ -157,7 +153,7 @@ export class MdListItem extends _MdListItemMixinBase implements AfterContentInit
 
   /** Whether this list item should show a ripple effect when clicked.  */
   isRippleEnabled() {
-    return !this.disableRipple && this._isNavList && !this._list.disableRipple;
+    return !this.disableRipple && this._isNavList && !this._navList.disableRipple;
   }
 
   _handleFocus() {