fix(material/paginator): add role="group" to host (#22512)

In testing `<mat-paginator>` with VoiceOver, I found that the interaction was much nicer when the paginator controls were semantically grouped with `role="group"`. This change adds the role and updates the documentation to explicitly instruct users to apply a meaningful label.

(cherry picked from commit f06ff2a)

Author: jelbourn

src/material-experimental/mdc-paginator/paginator.spec.ts

@@ -467,6 +467,12 @@ describe('MDC-based MatPaginator', () => {
     expect(paginator.showFirstLastButtons).toBe(true);
   });
 
+  it('should set `role="group"` on the host element', () => {
+    const fixture = createComponent(MatPaginatorApp);
+    const hostElement = fixture.nativeElement.querySelector('mat-paginator');
+    expect(hostElement.getAttribute('role')).toBe('group');
+  });
+
 });
 
 function getPreviousButton(fixture: ComponentFixture<any>) {

src/material-experimental/mdc-paginator/paginator.ts

@@ -57,6 +57,7 @@ export const MAT_PAGINATOR_DEFAULT_OPTIONS =
   inputs: ['disabled'],
   host: {
     'class': 'mat-mdc-paginator',
+    'role': 'group',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,
   encapsulation: ViewEncapsulation.None,

src/material/paginator/paginator.md

@@ -26,4 +26,9 @@ This will allow you to change the following:
  3. The tooltip messages on the navigation buttons.
 
 ### Accessibility
-The `aria-label`s for next page, previous page, first page and last page buttons can be set in `MatPaginatorIntl`.
+The paginator uses `role="group"` to semantically group its child controls. You must add an
+`aria-label` or `aria-labelledby` attribute to `<mat-paginator>` with a label that describes
+the content controlled by the pagination control.
+
+You can set the `aria-label` attributes for the button and select controls within the paginator in 
+`MatPaginatorIntl`.

src/material/paginator/paginator.spec.ts

@@ -467,6 +467,12 @@ describe('MatPaginator', () => {
     expect(paginator.showFirstLastButtons).toBe(true);
   });
 
+  it('should set `role="group"` on the host element', () => {
+    const fixture = createComponent(MatPaginatorApp);
+    const hostElement = fixture.nativeElement.querySelector('mat-paginator');
+    expect(hostElement.getAttribute('role')).toBe('group');
+  });
+
 });
 
 function getPreviousButton(fixture: ComponentFixture<any>) {

src/material/paginator/paginator.ts

@@ -357,6 +357,7 @@ export abstract class _MatPaginatorBase<O extends {
   inputs: ['disabled'],
   host: {
     'class': 'mat-paginator',
+    'role': 'group',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,
   encapsulation: ViewEncapsulation.None,