@@ -44,15 +44,17 @@ other accessibility considerations, some of which are described below.
44
44
45
45
### Keyboard interaction
46
46
47
+ #### Pagination
48
+
47
49
The tab order goes from left to right through the controls in the pagination
48
- component . On focus, the dropdowns are opened with ` Space ` or with up or down
50
+ variant . On focus, the dropdowns are opened with ` Space ` or with up or down
49
51
arrows, which also cycle through the values. Both ` Space ` and ` Enter ` select a
50
52
value and close the dropdown. The dropdown can also be closed by pressing ` Esc ` .
51
53
The previous and next page arrow buttons are activated by ` Space ` or ` Enter `
52
54
keys.
53
55
54
56
<Row >
55
- <Column colLg = { 8 } >
57
+ <Column colLg = { 12 } >
56
58
57
59
![ example of tabbing into a pagination group and arrowing between selections] ( images/pagination-a11y-1.png )
58
60
@@ -81,21 +83,81 @@ operable, like any other disabled control.
81
83
</Column >
82
84
</Row >
83
85
86
+ #### Pagination nav
87
+
88
+ The tab order goes left to right through the button controls in the pagination
89
+ nav variant. When page buttons have focus, both ` Space ` and ` Enter ` activates
90
+ the page button and change the current page to the button that currently has
91
+ selection. When the previous and next page arrow buttons have focus, both
92
+ ` Space ` and ` Enter ` activates them.
93
+
94
+ <Row >
95
+ <Column colLg = { 12 } >
96
+
97
+ ![ Interactive elements in pagination nav maintain their usual Carbon keyboard behaviors and tab order.] ( images/pagination-a11y-3.png )
98
+
99
+ <Caption >
100
+ Interactive elements in pagination nav maintain their usual Carbon keyboard
101
+ behaviors and tab order.
102
+ </Caption >
103
+
104
+ </Column >
105
+ </Row >
106
+
107
+ If an overflow ellipsis is present in the pagination nav, once focused, pressing
108
+ Space activates the menu to choose an available page to navigate to. Enter or
109
+ Tab selects a value from the menu and closes it. The menu can also be closed by
110
+ pressing Esc.
111
+
112
+ <Row >
113
+ <Column colLg = { 12 } >
114
+
115
+ ![ The menu opens by pressing Space and pressing Tab or Enter selects a page from the menu and closes it.] ( images/pagination-a11y-4.png )
116
+
117
+ <Caption >
118
+ The menu opens by pressing Space and pressing Tab or Enter selects a page from
119
+ the menu and closes it.
120
+ </Caption >
121
+
122
+ </Column >
123
+ </Row >
124
+
84
125
### Labeling
85
126
127
+ #### Pagination
128
+
86
129
Not all the elements in pagination have static or visually isolated labels.
87
130
Carbon constructs a programmatic name for the second dropdown by concatenating
88
- some dynamically generated text on the screen. Carbon also provides accessible
89
- names for the icon-only buttons.
131
+ dynamically generated text on the screen. Carbon also provides accessible names
132
+ for the icon-only buttons.
133
+
134
+ <Row >
135
+ <Column colLg = { 8 } >
136
+
137
+ ![ illustration showing labels for dropdown and icon-only buttons] ( images/pagination-a11y-5.png )
138
+
139
+ <Caption >
140
+ Carbon provides the accessible names "page number, of 40 pages", "previous",
141
+ and "next" for assistive technology.
142
+ </Caption >
143
+
144
+ </Column >
145
+ </Row >
146
+
147
+ #### Pagination nav
148
+
149
+ Carbon constructs a programmatic name for the page ghost buttons by
150
+ concatenating dynamically generated text on the screen. Carbon also provides
151
+ accessible names for the icon-only buttons.
90
152
91
153
<Row >
92
154
<Column colLg = { 8 } >
93
155
94
- ![ illustration showing labels for dropdown and icon-only buttons ] ( images/pagination-a11y-3 .png )
156
+ ![ Carbon provides the accessible names "page", "previous", and "next" for assistive technology. ] ( images/pagination-a11y-6 .png )
95
157
96
158
<Caption >
97
- Carbon provides the accessible names "page number, of 40 pages", "previous
98
- page", and "next page" for assistive technology.
159
+ Carbon provides the accessible names "page", "previous", and "next" for
160
+ assistive technology.
99
161
</Caption >
100
162
101
163
</Column >
0 commit comments