demo(list): Add accessibility demo page for list

Author: tinayuangao

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

@@ -29,6 +29,7 @@ import {
 } from './dialog/dialog-a11y';
 import {ExpansionPanelAccessibilityDemo} from './expansion/expansion-a11y';
 import {GridListAccessibilityDemo} from './grid-list/grid-list-a11y';
+import {ListAccessibilityDemo} from './list/list-a11y';
 import {RadioAccessibilityDemo} from './radio/radio-a11y';
 import {ToolbarAccessibilityDemo} from './toolbar/toolbar-a11y';
 import {DatepickerAccessibilityDemo} from './datepicker/datepicker-a11y';
@@ -93,6 +94,7 @@ export class AccessibilityRoutingModule {}
     GridListAccessibilityDemo,
     IconAccessibilityDemo,
     InputAccessibilityDemo,
+    ListAccessibilityDemo,
     MenuAccessibilityDemo,
     ProgressBarAccessibilityDemo,
     ProgressSpinnerAccessibilityDemo,

src/demo-app/a11y/a11y.ts

@@ -49,6 +49,7 @@ export class AccessibilityDemo implements OnDestroy {
     {name: 'Grid list', route: 'grid-list'},
     {name: 'Icon', route: 'icon'},
     {name: 'Input', route: 'input'},
+    {name: 'List', route: 'list'},
     {name: 'Menu', route: 'menu'},
     {name: 'Progress bar', route: 'progress-bar'},
     {name: 'Progress spinner', route: 'progress-spinner'},

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

@@ -22,6 +22,7 @@ import {ToolbarAccessibilityDemo} from './toolbar/toolbar-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 {MenuAccessibilityDemo} from './menu/menu-a11y';
 import {ProgressBarAccessibilityDemo} from './progress-bar/progress-bar-a11y';
 import {ProgressSpinnerAccessibilityDemo} from './progress-spinner/progress-spinner-a11y';
@@ -52,6 +53,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: 'menu', component: MenuAccessibilityDemo},
   {path: 'progress-bar', component: ProgressBarAccessibilityDemo},
   {path: 'progress-spinner', component: ProgressSpinnerAccessibilityDemo},

src/lib/list/list.md

@@ -150,3 +150,12 @@ To add a divider, use `<mat-divider>`.
    </mat-list-item>
 </mat-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

@@ -44,37 +44,33 @@ export class MatListDivider {}
 /** A Material Design list component. */
 @Component({
   moduleId: module.id,
-  selector: 'mat-list, mat-nav-list',
-  exportAs: 'matList, matNavList',
-  host: {'role': 'list'},
+  selector: 'mat-nav-list',
+  exportAs: 'matNavList',
+  host: {
+    'role': 'navigation',
+    'class': 'mat-nav-list'
+  },
   template: '<ng-content></ng-content>',
   styleUrls: ['list.css'],
   inputs: ['disableRipple'],
   encapsulation: ViewEncapsulation.None,
   preserveWhitespaces: false,
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
-export class MatList extends _MatListMixinBase implements CanDisableRipple {}
+export class MatNavList extends _MatListMixinBase implements CanDisableRipple {}
 
-/**
- * Directive whose purpose is to add the mat- CSS styling to this selector.
- * @docs-private
- */
-@Directive({
+@Component({
+  moduleId: module.id,
   selector: 'mat-list',
-  host: {'class': 'mat-list'}
-})
-export class MatListCssMatStyler {}
-
-/**
- * Directive whose purpose is to add the mat- CSS styling to this selector.
- * @docs-private
- */
-@Directive({
-  selector: 'mat-nav-list',
-  host: {'class': 'mat-nav-list'}
+  exportAs: 'matList',
+  template: '<ng-content></ng-content>',
+  host: {'class': 'mat-list'},
+  styleUrls: ['list.css'],
+  inputs: ['disableRipple'],
+  encapsulation: ViewEncapsulation.None,
+  changeDetection: ChangeDetectionStrategy.OnPush,
 })
-export class MatNavListCssMatStyler {}
+export class MatList extends _MatListMixinBase implements CanDisableRipple {}
 
 /**
  * Directive whose purpose is to add the mat- CSS styling to this selector.
@@ -149,11 +145,18 @@ export class MatListItem extends _MatListItemMixinBase implements AfterContentIn
     }
   }
 
+<<<<<<< HEAD
   constructor(private _element: ElementRef,
               @Optional() private _list: MatList,
               @Optional() navList: MatNavListCssMatStyler) {
+=======
+  constructor(private _renderer: Renderer2,
+              private _element: ElementRef,
+              @Optional() private _list: MdList,
+              @Optional() private _navList: MdNavList) {
+>>>>>>> demo(list): Add accessibility demo page for list
     super();
-    this._isNavList = !!navList;
+    this._isNavList = !!_navList;
   }
 
   ngAfterContentInit() {