@patternfly/patternfly 5.0.0-alpha.3 → 5.0.0-alpha.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (290) hide show
  1. package/RELEASE-NOTES.md +17 -0
  2. package/assets/icons/iconUnicodes.json +1 -0
  3. package/assets/pficon/pficon.scss +6 -0
  4. package/assets/pficon/pficon.woff +0 -0
  5. package/assets/pficon/pficon.woff2 +0 -0
  6. package/base/_base.scss +0 -18
  7. package/base/_chart-globals.scss +0 -4
  8. package/base/_common.scss +0 -22
  9. package/base/_fonts.scss +22 -22
  10. package/base/_globals.scss +1 -1
  11. package/base/_icons.scss +1 -28
  12. package/base/_svg-icons.scss +6 -0
  13. package/base/_variables.scss +1 -1
  14. package/base/patternfly-common.css +0 -10
  15. package/base/patternfly-fonts.css +17 -17
  16. package/base/patternfly-icons.css +6 -20
  17. package/base/patternfly-pf-icons.css +5 -1
  18. package/base/themes/dark/_globals.scss +1 -1
  19. package/base/themes/dark/_variables.scss +1 -1
  20. package/components/AboutModalBox/about-modal-box.css +7 -7
  21. package/components/AboutModalBox/about-modal-box.scss +7 -7
  22. package/components/Accordion/accordion.css +2 -0
  23. package/components/Accordion/accordion.scss +2 -0
  24. package/components/Alert/alert.css +3 -3
  25. package/components/Alert/alert.scss +3 -3
  26. package/components/AppLauncher/app-launcher.css +2 -0
  27. package/components/AppLauncher/app-launcher.scss +2 -0
  28. package/components/Avatar/avatar.scss +2 -2
  29. package/components/Banner/banner.css +14 -14
  30. package/components/Banner/banner.scss +9 -13
  31. package/components/Breadcrumb/breadcrumb.css +2 -0
  32. package/components/Breadcrumb/breadcrumb.scss +2 -0
  33. package/components/CalendarMonth/calendar-month.css +2 -2
  34. package/components/CalendarMonth/calendar-month.scss +3 -3
  35. package/components/Card/card.css +20 -21
  36. package/components/Card/card.scss +22 -26
  37. package/components/Chip/chip.css +33 -24
  38. package/components/Chip/chip.scss +40 -31
  39. package/components/ChipGroup/chip-group.css +27 -17
  40. package/components/ChipGroup/chip-group.scss +36 -22
  41. package/components/Content/content.css +11 -5
  42. package/components/Content/content.scss +17 -9
  43. package/components/ContextSelector/context-selector.css +5 -1
  44. package/components/ContextSelector/context-selector.scss +6 -2
  45. package/components/DataList/data-list-grid.css +7 -7
  46. package/components/DataList/data-list-grid.scss +1 -1
  47. package/components/DataList/data-list.css +12 -11
  48. package/components/DataList/data-list.scss +5 -4
  49. package/components/DescriptionList/description-list.css +7 -7
  50. package/components/DescriptionList/description-list.scss +7 -7
  51. package/components/Divider/divider.css +2 -2
  52. package/components/Divider/divider.scss +3 -3
  53. package/components/Drawer/drawer.css +15 -16
  54. package/components/Drawer/drawer.scss +2 -3
  55. package/components/Dropdown/dropdown.css +12 -10
  56. package/components/Dropdown/dropdown.scss +2 -0
  57. package/components/DualListSelector/dual-list-selector.css +1 -1
  58. package/components/DualListSelector/dual-list-selector.scss +1 -1
  59. package/components/EmptyState/empty-state.css +46 -52
  60. package/components/EmptyState/empty-state.scss +58 -57
  61. package/components/ExpandableSection/expandable-section.css +2 -0
  62. package/components/ExpandableSection/expandable-section.scss +2 -0
  63. package/components/Form/form.css +12 -12
  64. package/components/Form/form.scss +7 -7
  65. package/components/FormControl/form-control.css +2 -5
  66. package/components/FormControl/themes/dark/form-control.scss +2 -6
  67. package/components/Hint/hint.css +2 -2
  68. package/components/Hint/hint.scss +2 -2
  69. package/components/Label/label.css +43 -30
  70. package/components/Label/label.scss +49 -34
  71. package/components/LabelGroup/label-group.css +26 -22
  72. package/components/LabelGroup/label-group.scss +31 -26
  73. package/components/Login/login.css +11 -11
  74. package/components/Login/login.scss +10 -10
  75. package/components/Masthead/masthead.css +4 -4
  76. package/components/Masthead/masthead.scss +4 -4
  77. package/components/Menu/menu.css +9 -6
  78. package/components/Menu/menu.scss +34 -31
  79. package/components/MenuToggle/menu-toggle.css +3 -1
  80. package/components/MenuToggle/menu-toggle.scss +3 -1
  81. package/components/ModalBox/modal-box.css +9 -8
  82. package/components/ModalBox/modal-box.scss +11 -11
  83. package/components/MultipleFileUpload/multiple-file-upload.css +6 -6
  84. package/components/MultipleFileUpload/multiple-file-upload.scss +6 -6
  85. package/components/Nav/nav.css +1 -1
  86. package/components/Nav/nav.scss +2 -2
  87. package/components/NotificationDrawer/notification-drawer.css +3 -3
  88. package/components/NotificationDrawer/notification-drawer.scss +3 -3
  89. package/components/Page/page.css +71 -71
  90. package/components/Page/page.scss +12 -12
  91. package/components/Pagination/pagination.css +2 -2
  92. package/components/Popover/popover.css +25 -31
  93. package/components/Popover/popover.scss +27 -32
  94. package/components/Popover/themes/dark/popover.scss +2 -8
  95. package/components/Progress/progress.css +13 -10
  96. package/components/Progress/progress.scss +13 -10
  97. package/components/ProgressStepper/progress-stepper.css +5 -5
  98. package/components/ProgressStepper/progress-stepper.scss +5 -5
  99. package/components/SearchInput/search-input.css +4 -2
  100. package/components/SearchInput/search-input.scss +4 -2
  101. package/components/Select/select.css +1 -1
  102. package/components/Select/select.scss +1 -1
  103. package/components/Sidebar/sidebar.css +69 -26
  104. package/components/Sidebar/sidebar.scss +84 -27
  105. package/components/SimpleList/simple-list.css +1 -1
  106. package/components/SimpleList/simple-list.scss +2 -2
  107. package/components/Spinner/spinner.css +4 -4
  108. package/components/Spinner/spinner.scss +4 -4
  109. package/components/Table/table-grid.css +28 -28
  110. package/components/Table/table-scrollable.css +31 -26
  111. package/components/Table/table-scrollable.scss +33 -28
  112. package/components/Table/table-tree-view.css +14 -4
  113. package/components/Table/table-tree-view.scss +15 -0
  114. package/components/Table/table.css +7 -2
  115. package/components/Table/table.scss +9 -2
  116. package/components/Tabs/tabs.css +0 -4
  117. package/components/Tabs/tabs.scss +0 -7
  118. package/components/TextInputGroup/text-input-group.css +6 -4
  119. package/components/TextInputGroup/text-input-group.scss +6 -5
  120. package/components/Tile/tile.css +1 -1
  121. package/components/Tile/tile.scss +1 -1
  122. package/components/Timestamp/timestamp.css +3 -3
  123. package/components/Timestamp/timestamp.scss +3 -3
  124. package/components/Toolbar/toolbar.css +78 -43
  125. package/components/Toolbar/toolbar.scss +50 -10
  126. package/components/Tooltip/themes/dark/tooltip.scss +1 -11
  127. package/components/Tooltip/tooltip.css +7 -12
  128. package/components/Tooltip/tooltip.scss +6 -3
  129. package/components/TreeView/tree-view.css +7 -15
  130. package/components/TreeView/tree-view.scss +7 -18
  131. package/components/Wizard/wizard.css +16 -1
  132. package/components/Wizard/wizard.scss +20 -2
  133. package/docs/components/AboutModalBox/examples/AboutModalBox.md +13 -13
  134. package/docs/components/Accordion/examples/Accordion.md +12 -12
  135. package/docs/components/ActionList/examples/ActionList.md +6 -6
  136. package/docs/components/Alert/examples/Alert.md +19 -19
  137. package/docs/components/AlertGroup/examples/AlertGroup.md +12 -12
  138. package/docs/components/AppLauncher/examples/application-launcher.md +51 -46
  139. package/docs/components/Avatar/examples/Avatar.md +11 -11
  140. package/docs/components/BackToTop/examples/BackToTop.md +4 -4
  141. package/docs/components/Backdrop/examples/Backdrop.md +4 -4
  142. package/docs/components/BackgroundImage/examples/BackgroundImage.md +4 -4
  143. package/docs/components/Badge/examples/Badge.md +5 -5
  144. package/docs/components/Banner/examples/Banner.md +8 -8
  145. package/docs/components/Brand/examples/Brand.md +9 -9
  146. package/docs/components/Breadcrumb/examples/Breadcrumb.md +20 -20
  147. package/docs/components/Button/examples/Button.md +35 -35
  148. package/docs/components/CalendarMonth/examples/CalendarMonth.md +32 -32
  149. package/docs/components/Card/examples/Card.md +139 -64
  150. package/docs/components/Check/examples/Check.md +15 -19
  151. package/docs/components/Chip/examples/Chip.md +70 -52
  152. package/docs/components/ChipGroup/examples/ChipGroup.md +452 -673
  153. package/docs/components/ClipboardCopy/examples/ClipboardCopy.md +22 -22
  154. package/docs/components/CodeBlock/examples/CodeBlock.md +9 -9
  155. package/docs/components/CodeEditor/examples/CodeEditor.md +54 -35
  156. package/docs/components/Content/examples/Content.md +37 -9
  157. package/docs/components/ContextSelector/examples/context-selector.css +5 -1
  158. package/docs/components/ContextSelector/examples/context-selector.md +86 -80
  159. package/docs/components/DataList/examples/DataList.md +187 -148
  160. package/docs/components/DatePicker/examples/DatePicker.md +10 -10
  161. package/docs/components/DescriptionList/examples/DescriptionList.md +24 -24
  162. package/docs/components/Divider/examples/Divider.md +10 -10
  163. package/docs/components/DragDrop/examples/DragDrop.md +5 -5
  164. package/docs/components/Drawer/examples/Drawer.md +43 -43
  165. package/docs/components/Dropdown/examples/Dropdown.css +5 -2
  166. package/docs/components/Dropdown/examples/Dropdown.md +123 -99
  167. package/docs/components/DualListSelector/examples/DualListSelector.md +201 -197
  168. package/docs/components/EmptyState/examples/EmptyState.md +130 -82
  169. package/docs/components/ExpandableSection/examples/ExpandableSection.md +23 -23
  170. package/docs/components/FileUpload/examples/FileUpload.md +8 -8
  171. package/docs/components/Form/examples/Form.md +64 -64
  172. package/docs/components/FormControl/examples/FormControl.md +20 -20
  173. package/docs/components/HelperText/examples/HelperText.md +12 -12
  174. package/docs/components/Hint/examples/Hint.md +7 -7
  175. package/docs/components/Icon/examples/Icon.md +10 -10
  176. package/docs/components/InlineEdit/examples/InlineEdit.md +29 -27
  177. package/docs/components/InputGroup/examples/InputGroup.md +10 -10
  178. package/docs/components/JumpLinks/examples/JumpLinks.md +35 -35
  179. package/docs/components/Label/examples/Label.md +1427 -746
  180. package/docs/components/LabelGroup/examples/LabelGroup.md +295 -242
  181. package/docs/components/List/examples/List.md +18 -18
  182. package/docs/components/LogViewer/examples/LogViewer.md +79 -73
  183. package/docs/components/Login/examples/Login.md +32 -32
  184. package/docs/components/Masthead/examples/masthead.md +9 -9
  185. package/docs/components/Menu/examples/Menu.md +82 -80
  186. package/docs/components/MenuToggle/examples/MenuToggle.md +28 -28
  187. package/docs/components/ModalBox/examples/ModalBox.md +106 -85
  188. package/docs/components/MultipleFileUpload/examples/MultipleFileUpload.md +25 -25
  189. package/docs/components/Nav/examples/Navigation.md +69 -69
  190. package/docs/components/NotificationBadge/examples/NotificationBadge.md +8 -8
  191. package/docs/components/NotificationDrawer/examples/NotificationDrawer.md +44 -44
  192. package/docs/components/NumberInput/examples/NumberInput.md +12 -12
  193. package/docs/components/OptionsMenu/examples/options-menu.md +27 -28
  194. package/docs/components/OverflowMenu/examples/overflow-menu.md +25 -25
  195. package/docs/components/Page/examples/Page.md +54 -54
  196. package/docs/components/Pagination/examples/Pagination.md +27 -27
  197. package/docs/components/Panel/examples/Panel.md +10 -10
  198. package/docs/components/Popover/examples/Popover.md +201 -144
  199. package/docs/components/Progress/examples/Progress.md +31 -60
  200. package/docs/components/ProgressStepper/examples/ProgressStepper.md +45 -38
  201. package/docs/components/Radio/examples/Radio.md +11 -11
  202. package/docs/components/SearchInput/examples/SearchInput.md +34 -34
  203. package/docs/components/Select/examples/Select.md +367 -313
  204. package/docs/components/Sidebar/examples/Sidebar.md +70 -14
  205. package/docs/components/SimpleList/examples/SimpleList.md +15 -15
  206. package/docs/components/Skeleton/examples/Skeleton.md +8 -8
  207. package/docs/components/SkipToContent/examples/SkipToContent.md +5 -5
  208. package/docs/components/Slider/examples/Slider.md +24 -24
  209. package/docs/components/Spinner/examples/Spinner.md +24 -24
  210. package/docs/components/Switch/examples/Switch.md +19 -19
  211. package/docs/components/TabContent/examples/TabContent.md +13 -13
  212. package/docs/components/Table/examples/Table.css +4 -0
  213. package/docs/components/Table/examples/Table.md +3163 -1712
  214. package/docs/components/Tabs/examples/Tabs.md +149 -149
  215. package/docs/components/TextInputGroup/examples/TextInputGroup.md +362 -280
  216. package/docs/components/Tile/examples/Tile.md +15 -15
  217. package/docs/components/Timestamp/examples/Timestamp.md +5 -5
  218. package/docs/components/Title/examples/Title.md +17 -17
  219. package/docs/components/ToggleGroup/examples/toggle-group.md +13 -13
  220. package/docs/components/Toolbar/examples/Toolbar.md +466 -373
  221. package/docs/components/Tooltip/examples/Tooltip.md +10 -10
  222. package/docs/components/TreeView/examples/TreeView.md +34 -34
  223. package/docs/components/Truncate/examples/Truncate.md +4 -4
  224. package/docs/components/Wizard/examples/Wizard.md +119 -127
  225. package/docs/demos/AboutModal/examples/AboutModal.md +4 -4
  226. package/docs/demos/Alert/examples/Alert.md +13 -13
  227. package/docs/demos/BackToTop/examples/BackToTop.md +4 -4
  228. package/docs/demos/Banner/examples/Banner.md +8 -9
  229. package/docs/demos/Card/examples/Card.md +219 -156
  230. package/docs/demos/CardView/examples/CardView.md +56 -29
  231. package/docs/demos/ContextSelector/examples/ContextSelector.md +18 -18
  232. package/docs/demos/Dashboard/examples/Dashboard.md +51 -35
  233. package/docs/demos/DataList/examples/DataList.md +158 -109
  234. package/docs/demos/DescriptionList/examples/DescriptionList.md +33 -22
  235. package/docs/demos/Drawer/examples/Drawer.md +24 -22
  236. package/docs/demos/Form/examples/BasicForms.md +28 -22
  237. package/docs/demos/HelperText/examples/HelperText.md +8 -9
  238. package/docs/demos/JumpLinks/examples/JumpLinks.md +28 -28
  239. package/docs/demos/Masthead/examples/Masthead.md +29 -32
  240. package/docs/demos/Modal/examples/Modal.md +54 -66
  241. package/docs/demos/Nav/examples/Nav.md +47 -47
  242. package/docs/demos/NotificationDrawer/examples/NotificationDrawer.md +40 -28
  243. package/docs/demos/Page/examples/Page.md +37 -37
  244. package/docs/demos/PasswordStrength/examples/PasswordStrength.md +32 -33
  245. package/docs/demos/PrimaryDetail/examples/PrimaryDetail.md +74 -64
  246. package/docs/demos/Skeleton/examples/Skeleton.md +4 -4
  247. package/docs/demos/Table/examples/Table.md +2454 -467
  248. package/docs/demos/Tabs/examples/Tabs.md +141 -90
  249. package/docs/demos/Toolbar/examples/Toolbar.md +1808 -174
  250. package/docs/demos/Wizard/examples/Wizard.md +289 -266
  251. package/docs/layouts/Bullseye/examples/Bullseye.md +4 -4
  252. package/docs/layouts/Flex/examples/Flex.md +98 -98
  253. package/docs/layouts/Gallery/examples/Gallery.md +7 -7
  254. package/docs/layouts/Grid/examples/Grid.md +9 -9
  255. package/docs/layouts/Level/examples/Level.md +5 -5
  256. package/docs/layouts/Split/examples/Split.md +7 -7
  257. package/docs/layouts/Stack/examples/Stack.md +6 -6
  258. package/docs/utilities/Accessibility/examples/Accessibility.md +4 -4
  259. package/docs/utilities/Alignment/examples/Alignment.md +6 -6
  260. package/docs/utilities/BackgroundColor/examples/BackgroundColor.md +12 -12
  261. package/docs/utilities/BoxShadow/examples/box-shadow.md +22 -22
  262. package/docs/utilities/Display/examples/Display.md +11 -11
  263. package/docs/utilities/Flex/examples/Flex.md +34 -34
  264. package/docs/utilities/Float/examples/Float.md +4 -4
  265. package/docs/utilities/Sizing/examples/Sizing.md +50 -50
  266. package/docs/utilities/Spacing/examples/Spacing.md +34 -34
  267. package/docs/utilities/Text/examples/Text.md +27 -27
  268. package/icons/{pf-icons.json → pf-icons.mjs} +2 -1
  269. package/layouts/Gallery/gallery.css +1 -1
  270. package/layouts/Gallery/gallery.scss +1 -1
  271. package/layouts/Grid/grid.css +7 -7
  272. package/layouts/Grid/grid.scss +2 -2
  273. package/package.json +59 -65
  274. package/patternfly-base-no-reset.css +23 -47
  275. package/patternfly-base.css +23 -47
  276. package/patternfly-no-reset.css +781 -656
  277. package/patternfly.css +781 -656
  278. package/patternfly.min.css +1 -1
  279. package/patternfly.min.css.map +1 -1
  280. package/sass-utilities/functions.scss +8 -24
  281. package/sass-utilities/mixins.scss +15 -39
  282. package/sass-utilities/scss-variables.scss +1 -1
  283. package/sass-utilities/themes/dark/scss-variables.scss +1 -1
  284. package/utilities/Spacing/spacing.scss +2 -2
  285. package/base/_shield-inheritable.scss +0 -69
  286. package/base/_shield-noninheritable.scss +0 -13
  287. package/base/patternfly-shield-inheritable.css +0 -66
  288. package/base/patternfly-shield-inheritable.scss +0 -4
  289. package/base/patternfly-shield-noninheritable.css +0 -9
  290. package/base/patternfly-shield-noninheritable.scss +0 -4
@@ -9,20 +9,31 @@ cssPrefix: pf-c-empty-state
9
9
  ```html
10
10
  <div class="pf-c-empty-state">
11
11
  <div class="pf-c-empty-state__content">
12
- <i class="fas fa-cubes pf-c-empty-state__icon" aria-hidden="true"></i>
12
+ <div class="pf-c-empty-state__header">
13
+ <div class="pf-c-empty-state__icon">
14
+ <i class="fas fa-cubes" aria-hidden="true"></i>
15
+ </div>
16
+ <div class="pf-c-empty-state__title">
17
+ <h1 class="pf-c-empty-state__title-text">Empty state</h1>
18
+ </div>
19
+ </div>
13
20
 
14
- <h1 class="pf-c-title pf-m-lg">Empty state</h1>
15
21
  <div
16
22
  class="pf-c-empty-state__body"
17
- >This represents an the empty state pattern in PatternFly 4. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
18
- <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
19
- <div class="pf-c-empty-state__secondary">
20
- <button class="pf-c-button pf-m-link" type="button">Multiple</button>
21
- <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
22
- <button class="pf-c-button pf-m-link" type="button">Can</button>
23
- <button class="pf-c-button pf-m-link" type="button">Go here</button>
24
- <button class="pf-c-button pf-m-link" type="button">In the secondary</button>
25
- <button class="pf-c-button pf-m-link" type="button">Action area</button>
23
+ >This represents an the empty state pattern in PatternFly. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
24
+
25
+ <div class="pf-c-empty-state__footer">
26
+ <div class="pf-c-empty-state__actions">
27
+ <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
28
+ </div>
29
+ <div class="pf-c-empty-state__actions">
30
+ <button class="pf-c-button pf-m-link" type="button">Multiple</button>
31
+ <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
32
+ <button class="pf-c-button pf-m-link" type="button">Can</button>
33
+ <button class="pf-c-button pf-m-link" type="button">Go here</button>
34
+ <button class="pf-c-button pf-m-link" type="button">In the second</button>
35
+ <button class="pf-c-button pf-m-link" type="button">Action area</button>
36
+ </div>
26
37
  </div>
27
38
  </div>
28
39
  </div>
@@ -34,17 +45,31 @@ cssPrefix: pf-c-empty-state
34
45
  ```html
35
46
  <div class="pf-c-empty-state pf-m-xs">
36
47
  <div class="pf-c-empty-state__content">
37
- <h1 class="pf-c-title pf-m-md">Empty state</h1>
48
+ <div class="pf-c-empty-state__header">
49
+ <div class="pf-c-empty-state__title">
50
+ <h1 class="pf-c-empty-state__title-text">Empty state</h1>
51
+ </div>
52
+ </div>
53
+
38
54
  <div
39
55
  class="pf-c-empty-state__body"
40
- >This represents an the empty state pattern in PatternFly 4. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
41
- <div class="pf-c-empty-state__secondary">
42
- <button class="pf-c-button pf-m-link" type="button">Multiple</button>
43
- <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
44
- <button class="pf-c-button pf-m-link" type="button">Can</button>
45
- <button class="pf-c-button pf-m-link" type="button">Go here</button>
46
- <button class="pf-c-button pf-m-link" type="button">In the secondary</button>
47
- <button class="pf-c-button pf-m-link" type="button">Action area</button>
56
+ >This represents an the empty state pattern in PatternFly. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
57
+
58
+ <div class="pf-c-empty-state__footer">
59
+ <div class="pf-c-empty-state__actions">
60
+ <button class="pf-c-button pf-m-link pf-m-small" type="button">Multiple</button>
61
+ <button
62
+ class="pf-c-button pf-m-link pf-m-small"
63
+ type="button"
64
+ >Action buttons</button>
65
+ <button class="pf-c-button pf-m-link pf-m-small" type="button">Can</button>
66
+ <button class="pf-c-button pf-m-link pf-m-small" type="button">Go here</button>
67
+ <button class="pf-c-button pf-m-link pf-m-small" type="button">In the</button>
68
+ <button
69
+ class="pf-c-button pf-m-link pf-m-small"
70
+ type="button"
71
+ >Action area</button>
72
+ </div>
48
73
  </div>
49
74
  </div>
50
75
  </div>
@@ -56,20 +81,32 @@ cssPrefix: pf-c-empty-state
56
81
  ```html
57
82
  <div class="pf-c-empty-state pf-m-sm">
58
83
  <div class="pf-c-empty-state__content">
59
- <i class="fas fa-cubes pf-c-empty-state__icon" aria-hidden="true"></i>
84
+ <div class="pf-c-empty-state__header">
85
+ <div class="pf-c-empty-state__icon">
86
+ <i class="fas fa-cubes" aria-hidden="true"></i>
87
+ </div>
88
+ <div class="pf-c-empty-state__title">
89
+ <h1 class="pf-c-empty-state__title-text">Empty state</h1>
90
+ </div>
91
+ </div>
60
92
 
61
- <h1 class="pf-c-title pf-m-lg">Empty state</h1>
62
93
  <div
63
94
  class="pf-c-empty-state__body"
64
- >This represents an the empty state pattern in PatternFly 4. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
65
- <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
66
- <div class="pf-c-empty-state__secondary">
67
- <button class="pf-c-button pf-m-link" type="button">Multiple</button>
68
- <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
69
- <button class="pf-c-button pf-m-link" type="button">Can</button>
70
- <button class="pf-c-button pf-m-link" type="button">Go here</button>
71
- <button class="pf-c-button pf-m-link" type="button">In the secondary</button>
72
- <button class="pf-c-button pf-m-link" type="button">Action area</button>
95
+ >This represents an the empty state pattern in PatternFly. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
96
+
97
+ <div class="pf-c-empty-state__footer">
98
+ <div class="pf-c-empty-state__actions">
99
+ <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
100
+ </div>
101
+
102
+ <div class="pf-c-empty-state__actions">
103
+ <button class="pf-c-button pf-m-link" type="button">Multiple</button>
104
+ <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
105
+ <button class="pf-c-button pf-m-link" type="button">Can</button>
106
+ <button class="pf-c-button pf-m-link" type="button">Go here</button>
107
+ <button class="pf-c-button pf-m-link" type="button">In the second</button>
108
+ <button class="pf-c-button pf-m-link" type="button">Action area</button>
109
+ </div>
73
110
  </div>
74
111
  </div>
75
112
  </div>
@@ -81,20 +118,31 @@ cssPrefix: pf-c-empty-state
81
118
  ```html
82
119
  <div class="pf-c-empty-state pf-m-lg">
83
120
  <div class="pf-c-empty-state__content">
84
- <i class="fas fa-cubes pf-c-empty-state__icon" aria-hidden="true"></i>
121
+ <div class="pf-c-empty-state__header">
122
+ <div class="pf-c-empty-state__icon">
123
+ <i class="fas fa-cubes" aria-hidden="true"></i>
124
+ </div>
125
+ <div class="pf-c-empty-state__title">
126
+ <h1 class="pf-c-empty-state__title-text">Empty state</h1>
127
+ </div>
128
+ </div>
85
129
 
86
- <h1 class="pf-c-title pf-m-lg">Empty state</h1>
87
130
  <div
88
131
  class="pf-c-empty-state__body"
89
- >This represents an the empty state pattern in PatternFly 4. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
90
- <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
91
- <div class="pf-c-empty-state__secondary">
92
- <button class="pf-c-button pf-m-link" type="button">Multiple</button>
93
- <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
94
- <button class="pf-c-button pf-m-link" type="button">Can</button>
95
- <button class="pf-c-button pf-m-link" type="button">Go here</button>
96
- <button class="pf-c-button pf-m-link" type="button">In the secondary</button>
97
- <button class="pf-c-button pf-m-link" type="button">Action area</button>
132
+ >This represents an the empty state pattern in PatternFly. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
133
+
134
+ <div class="pf-c-empty-state__footer">
135
+ <div class="pf-c-empty-state__actions">
136
+ <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
137
+ </div>
138
+ <div class="pf-c-empty-state__actions">
139
+ <button class="pf-c-button pf-m-link" type="button">Multiple</button>
140
+ <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
141
+ <button class="pf-c-button pf-m-link" type="button">Can</button>
142
+ <button class="pf-c-button pf-m-link" type="button">Go here</button>
143
+ <button class="pf-c-button pf-m-link" type="button">In the second</button>
144
+ <button class="pf-c-button pf-m-link" type="button">Action area</button>
145
+ </div>
98
146
  </div>
99
147
  </div>
100
148
  </div>
@@ -106,31 +154,30 @@ cssPrefix: pf-c-empty-state
106
154
  ```html
107
155
  <div class="pf-c-empty-state pf-m-xl">
108
156
  <div class="pf-c-empty-state__content">
109
- <i class="fas fa-cubes pf-c-empty-state__icon" aria-hidden="true"></i>
110
-
111
- <h1 class="pf-c-title pf-m-4xl">Empty state</h1>
112
- <div
113
- class="pf-c-empty-state__body"
114
- >This represents an the empty state pattern in PatternFly 4. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
115
- <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
116
- </div>
117
- </div>
118
-
119
- ```
120
-
121
- ### With primary element
122
-
123
- ```html
124
- <div class="pf-c-empty-state">
125
- <div class="pf-c-empty-state__content">
126
- <i class="fas fa-cubes pf-c-empty-state__icon" aria-hidden="true"></i>
157
+ <div class="pf-c-empty-state__header">
158
+ <div class="pf-c-empty-state__icon">
159
+ <i class="fas fa-cubes" aria-hidden="true"></i>
160
+ </div>
161
+ <div class="pf-c-empty-state__title">
162
+ <h1 class="pf-c-empty-state__title-text">Empty state</h1>
163
+ </div>
164
+ </div>
127
165
 
128
- <h1 class="pf-c-title pf-m-lg">Empty State</h1>
129
166
  <div
130
167
  class="pf-c-empty-state__body"
131
- >This represents an the empty state pattern in PatternFly 4. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
132
- <div class="pf-c-empty-state__primary">
133
- <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
168
+ >This represents an the empty state pattern in PatternFly. Hopefully it's simple enough to use but flexible enough to meet a variety of needs.</div>
169
+ <div class="pf-c-empty-state__footer">
170
+ <div class="pf-c-empty-state__actions">
171
+ <button class="pf-c-button pf-m-primary" type="button">Primary action</button>
172
+ </div>
173
+ <div class="pf-c-empty-state__actions">
174
+ <button class="pf-c-button pf-m-link" type="button">Multiple</button>
175
+ <button class="pf-c-button pf-m-link" type="button">Action buttons</button>
176
+ <button class="pf-c-button pf-m-link" type="button">Can</button>
177
+ <button class="pf-c-button pf-m-link" type="button">Go here</button>
178
+ <button class="pf-c-button pf-m-link" type="button">In the second</button>
179
+ <button class="pf-c-button pf-m-link" type="button">Action area</button>
180
+ </div>
134
181
  </div>
135
182
  </div>
136
183
  </div>
@@ -141,24 +188,25 @@ cssPrefix: pf-c-empty-state
141
188
 
142
189
  ### Accessibility
143
190
 
144
- | Attribute | Applied to | Outcome |
145
- | -------------------- | ------------------------- | --------------------------------------------------- |
146
- | `aria-hidden="true"` | `.pf-c-empty-state__icon` | Hides icon for assistive technologies. **Required** |
191
+ | Attribute | Applied to | Outcome |
192
+ | -- | -- | -- |
193
+ | `aria-hidden="true"` | `.pf-c-empty-state__icon` | Hides icon for assistive technologies. **Required** |
147
194
 
148
195
  ### Usage
149
196
 
150
- | Class | Applied to | Outcome |
151
- | ------------------------------ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
152
- | `.pf-c-empty-state` | `<div>` | Initiates an empty state component. The empty state centers its content (`.pf-c-empty-state__content`) vertically and horizontally. **Required** |
153
- | `.pf-c-empty-state__content` | `<div>` | Creates the content container. **Required** |
154
- | `.pf-c-empty-state__icon` | `<i>`, `<div>` | Creates the empty state icon or icon container when used as a `<div>`. |
155
- | `.pf-c-title` | `<h1>, <h2>, <h3>, <h4>, <h5>, <h6>` | Creates the empty state title. **Required** |
156
- | `.pf-c-empty-state__body` | `<div>` | Creates the empty state body content. You can have more than one `.pf-c-empty-state__body` elements. |
157
- | `.pf-c-button.pf-m-primary` | `<button>` | Creates the primary action button. |
158
- | `.pf-c-empty-state__primary` | `<div>` | Container for primary actions. Can be used in lieu of using `.pf-c-button.pf-m-primary`. |
159
- | `.pf-c-empty-state__secondary` | `<div>` | Container secondary actions. |
160
- | `.pf-m-xs` | `.pf-c-empty-state` | Modifies the empty state for a extra small variation and max-width. |
161
- | `.pf-m-sm` | `.pf-c-empty-state` | Modifies the empty state for a small max-width. |
162
- | `.pf-m-lg` | `.pf-c-empty-state` | Modifies the empty state for a large max-width. |
163
- | `.pf-m-xl` | `.pf-c-empty-state` | Modifies the empty state for an x-large variation and max-width. |
164
- | `.pf-m-full-height` | `.pf-c-empty-state` | Modifies the empty state to be `height: 100%`. If you need the empty state content to be centered vertically, you can use this modifier to make the empty state fill the height of its container, and center `.pf-c-empty-state__content`. **Note:** this modifier requires the parent of `.pf-c-empty-state` have an implicit or explicit `height` defined. |
197
+ | Class | Applied to | Outcome |
198
+ | -- | -- | -- |
199
+ | `.pf-c-empty-state` | `<div>` | Initiates an empty state component. The empty state centers its content (`.pf-c-empty-state__content`) vertically and horizontally. **Required** |
200
+ | `.pf-c-empty-state__content` | `<div>` | Creates the content container. **Required** |
201
+ | `.pf-c-empty-state__header` | `<div>` | Creates the header container. **Required** |
202
+ | `.pf-c-empty-state__title` | `<div>` | Creates the empty state title container. **Required** |
203
+ | `.pf-c-empty-state__title-text` | `<h1>`, `<h2>`, `<h3>`, `<h4>`, `<h5>`, `<h6>`, `<div>` | Creates the empty state title text container. |
204
+ | `.pf-c-empty-state__icon` | `<div>` | Creates the empty state icon container. |
205
+ | `.pf-c-empty-state__body` | `<div>` | Creates the empty state body content. There can be more than one `.pf-c-empty-state__body` elements. |
206
+ | `.pf-c-empty-state__footer` | `<div>` | Creates the footer container. **Required** |
207
+ | `.pf-c-empty-state__actions` | `<div>` | Container for actions. **Required** |
208
+ | `.pf-m-xs` | `.pf-c-empty-state` | Modifies the empty state for an extra small variation and max-width. |
209
+ | `.pf-m-sm` | `.pf-c-empty-state` | Modifies the empty state for a small max-width. |
210
+ | `.pf-m-lg` | `.pf-c-empty-state` | Modifies the empty state for a large max-width. |
211
+ | `.pf-m-xl` | `.pf-c-empty-state` | Modifies the empty state for an extra large variation and max-width. |
212
+ | `.pf-m-full-height` | `.pf-c-empty-state` | Modifies the empty state to be `height: 100%`. If you need the empty state content to be centered vertically, you can use this modifier to make the empty state fill the height of its container, and center `.pf-c-empty-state__content`. **Note:** this modifier requires the parent of `.pf-c-empty-state` have an implicit or explicit `height` defined. |
@@ -185,29 +185,29 @@ cssPrefix: pf-c-expandable-section
185
185
 
186
186
  ### Accessibility
187
187
 
188
- | Attribute | Applied to | Outcome |
189
- | ----------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
190
- | `aria-expanded="true"` | `.pf-c-expandable-section__toggle` | Indicates that the expandable section content is visible. **Required** |
191
- | `aria-expanded="false"` | `.pf-c-expandable-section__toggle` | Indicates the the expandable section content is hidden. **Required** |
192
- | `hidden` | `.pf-c-expandable-section__content` | Indicates that the expandable section content element is hidden. Use with `aria-expanded="false"` **Required** |
193
- | `aria-hidden="true"` | `.pf-c-expandable-section__toggle-icon` | Hides the icon from screen readers. **Required** |
194
- | `aria-controls="[id of content element]"` | `.pf-c-expandable-section.pf-m-detached .pf-c-expandable-section__toggle` | Identifies the element controlled by the toggle button. **Required** |
195
- | `id` | `.pf-c-expandable-section.pf-m-detached .pf-c-expandable-section__content` | Gives the content an `id` for use with `aria-controls` on `.pf-c-expandable-section__toggle`. **Required** |
188
+ | Attribute | Applied to | Outcome |
189
+ | -- | -- | -- |
190
+ | `aria-expanded="true"` | `.pf-c-expandable-section__toggle` | Indicates that the expandable section content is visible. **Required** |
191
+ | `aria-expanded="false"` | `.pf-c-expandable-section__toggle` | Indicates the the expandable section content is hidden. **Required** |
192
+ | `hidden` | `.pf-c-expandable-section__content` | Indicates that the expandable section content element is hidden. Use with `aria-expanded="false"` **Required** |
193
+ | `aria-hidden="true"` | `.pf-c-expandable-section__toggle-icon` | Hides the icon from screen readers. **Required** |
194
+ | `aria-controls="[id of content element]"` | `.pf-c-expandable-section.pf-m-detached .pf-c-expandable-section__toggle` | Identifies the element controlled by the toggle button. **Required** |
195
+ | `id` | `.pf-c-expandable-section.pf-m-detached .pf-c-expandable-section__content` | Gives the content an `id` for use with `aria-controls` on `.pf-c-expandable-section__toggle`. **Required** |
196
196
 
197
197
  ### Usage
198
198
 
199
- | Class | Applied to | Outcome |
200
- | ----------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
201
- | `.pf-c-expandable-section` | `<div>` | Initiates the expandable section component. **Required** |
202
- | `.pf-c-expandable-section__toggle` | `<button>` | Initiates the expandable section toggle. **Required** |
203
- | `.pf-c-expandable-section__toggle-text` | `<span>` | Initiates the expandable toggle text. **Required** |
204
- | `.pf-c-expandable-section__toggle-icon` | `<span>` | Initiates the expandable toggle icon. **Required** |
205
- | `.pf-c-expandable-section__content` | `<div>` | Initiates the expandable section content. **Required** |
206
- | `.pf-m-expanded` | `.pf-c-expandable-section` | Modifies the component for the expanded state. |
207
- | `.pf-m-display-lg` | `.pf-c-expandable-section` | Modifies the styling of the component to have large display styling. |
208
- | `.pf-m-detached` | `.pf-c-expandable-section` | Indicates that the expandable section toggle and content are detached from one another, so you can move them around independently in the markup. |
209
- | `.pf-m-indented` | `.pf-c-expandable-section` | Indicates that the expandable section content is indented and is aligned with the start of the title text to provide visual hierarchy. |
210
- | `.pf-m-truncate` | `.pf-c-expandable-section` | Indicates that the expandable section content is truncated by default, and not truncated when expanded. |
211
- | `.pf-m-active` | `.pf-c-expandable-section__toggle` | Forces display of the active state of the toggle. |
212
- | `.pf-m-expand-top` | `.pf-c-expandable-section__toggle-icon` | Modifies the toggle icon to point up when expanded. |
213
- | `--pf-c-expandable-section--m-truncate__content--LineClamp` | `.pf-c-expandable-section.pf-m-truncate` | Modifies the number of lines to show before truncating. |
199
+ | Class | Applied to | Outcome |
200
+ | -- | -- | -- |
201
+ | `.pf-c-expandable-section` | `<div>` | Initiates the expandable section component. **Required** |
202
+ | `.pf-c-expandable-section__toggle` | `<button>` | Initiates the expandable section toggle. **Required** |
203
+ | `.pf-c-expandable-section__toggle-text` | `<span>` | Initiates the expandable toggle text. **Required** |
204
+ | `.pf-c-expandable-section__toggle-icon` | `<span>` | Initiates the expandable toggle icon. **Required** |
205
+ | `.pf-c-expandable-section__content` | `<div>` | Initiates the expandable section content. **Required** |
206
+ | `.pf-m-expanded` | `.pf-c-expandable-section` | Modifies the component for the expanded state. |
207
+ | `.pf-m-display-lg` | `.pf-c-expandable-section` | Modifies the styling of the component to have large display styling. |
208
+ | `.pf-m-detached` | `.pf-c-expandable-section` | Indicates that the expandable section toggle and content are detached from one another, so you can move them around independently in the markup. |
209
+ | `.pf-m-indented` | `.pf-c-expandable-section` | Indicates that the expandable section content is indented and is aligned with the start of the title text to provide visual hierarchy. |
210
+ | `.pf-m-truncate` | `.pf-c-expandable-section` | Indicates that the expandable section content is truncated by default, and not truncated when expanded. |
211
+ | `.pf-m-active` | `.pf-c-expandable-section__toggle` | Forces display of the active state of the toggle. |
212
+ | `.pf-m-expand-top` | `.pf-c-expandable-section__toggle-icon` | Modifies the toggle icon to point up when expanded. |
213
+ | `--pf-c-expandable-section--m-truncate__content--LineClamp` | `.pf-c-expandable-section.pf-m-truncate` | Modifies the number of lines to show before truncating. |
@@ -255,11 +255,11 @@ cssPrefix: pf-c-file-upload
255
255
 
256
256
  ### Usage
257
257
 
258
- | Class | Applied to | Outcome |
259
- | ----------------------------------------- | ------------------- | --------------------------------------------------------------------------------------- |
260
- | `.pf-c-file-upload` | `<div>`, `<form>` | Initiates the file upload component. **Required**. |
261
- | `.pf-c-file-upload__file-select` | `<div>` | Initiates the file select element. **Required** |
262
- | `.pf-c-file-upload__file-details` | `<div>` | Initiates the file details element. **Required** |
263
- | `.pf-c-file-upload__file-details-spinner` | `<div>` | Initiates the file details element. **Required** |
264
- | `.pf-m-drag-hover` | `.pf-c-file-upload` | Modifies file upload for when an element is dragged or dropped inside of its container. |
265
- | `.pf-m-loading` | `.pf-c-file-upload` | Modifies file upload for the loading state. |
258
+ | Class | Applied to | Outcome |
259
+ | -- | -- | -- |
260
+ | `.pf-c-file-upload` | `<div>`, `<form>` | Initiates the file upload component. **Required**. |
261
+ | `.pf-c-file-upload__file-select` | `<div>` | Initiates the file select element. **Required** |
262
+ | `.pf-c-file-upload__file-details` | `<div>` | Initiates the file details element. **Required** |
263
+ | `.pf-c-file-upload__file-details-spinner` | `<div>` | Initiates the file details element. **Required** |
264
+ | `.pf-m-drag-hover` | `.pf-c-file-upload` | Modifies file upload for when an element is dragged or dropped inside of its container. |
265
+ | `.pf-m-loading` | `.pf-c-file-upload` | Modifies file upload for the loading state. |
@@ -681,70 +681,70 @@ To avoid the form label's required indicator or help tooltip icon from wrapping
681
681
 
682
682
  ### Accessibility
683
683
 
684
- | Attribute | Applied to | Outcome |
685
- | -------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
686
- | `for` | `<label>` | Each `<label>` must have a `for` attribute that matches its form field id. **Required** |
687
- | `id` | `<input type="radio/checkbox/text">`, `<select>`, `<textarea>` | Each `<form>` field must have an `id` attribute that matches its label's `for` value. **Required** |
688
- | `required` | `<input>`, `<select>`, `<textarea>` | Required fields must include these attributes. |
689
- | `id="{helper_text_id}"` | `.pf-c-form__helper-text` | Form fields with related `.pf-c-form__helper-text` require this attribute. Usage `<p class="pf-c-form__helper-text" id="{helper_text_id}">`. |
690
- | `aria-describedby="{helper_text_id}"` | `<input>`, `<select>`, `<textarea>` | Form fields with related `.pf-c-form__helper-text` require this attribute. Usage `<input aria-describedby="{helper_text_id}">`. |
691
- | `aria-invalid="true" aria-describedby="{helper_text_id}"` | `<input>`, `<select>`, `<textarea>` | When form validation fails `aria-describedby` is used to communicate the error to the user. These attributes need to be handled with Javascript so that `aria-describedby` only references help text that explains the error, and so that `aria-invalid="true"` is only present when validation fails. For proper styling of errors `aria-invalid="true"` is required. |
692
- | `aria-hidden="true"` | `.pf-c-form__label-required` | Hides the required indicator from assistive technologies. |
693
- | `role="group"` | `.pf-c-form__group`, `.pf-c-form__section`, `.pf-c-form__field-group` | Provides group role for form groups, form sections, and form field groups. **Required for checkbox groups, form groups, form sections, and form field groups.** |
694
- | `role="radiogroup"` | `.pf-c-form__group` | Provides group role for radio input groups. **Required for radio input groups** |
695
- | `role="button"` | `.pf-c-form__group-label-help` | Provides button role for group label help spans. **Required for group label help.** |
696
- | `id` | `.pf-c-form__group-label` | Generates an `id` for use in the `aria-labelledby` attribute in a checkbox or radio form group. |
697
- | `id` | `.pf-c-form__field-group-title-text` | Generates an `id` for use in the `aria-labelledby` attribute in an expandable field group's toggle button. |
698
- | `id` | `.pf-c-form__field-group-toggle-button > button` | Generates an `id` for use in the `aria-labelledby` attribute in an expandable field group's toggle button. |
699
- | `aria-labelledby="{label id}"` | `.pf-c-form__group`, `.pf-c-form__section`, `.pf-c-form__field-group` | Provides an accessible label for form groups, form sections, and form field groups. **Required for form groups, form sections, and form field groups that contain labels.** |
700
- | `aria-label` | `.pf-c-form__field-group-toggle-button > button` | Provides an accessible label for the field group toggle button. |
701
- | `aria-labelledby="{title id} {toggle button id}"` | `.pf-c-form__field-group-toggle-button > button` | Provides an accessible label for the field group toggle button. |
702
- | `aria-expanded="true/false"` | `.pf-c-form__field-group-toggle-button > button` | Indicates whether the field group body is visible or hidden. |
703
- | `id="{form_label_id}"` | `.pf-c-form__label` | Generates an `id` for use in the `aria-describedby` attribute in a `.pf-c-form__group-label-help`. |
704
- | `aria-label="{descriptive text}" aria-describedby="{form_label_id}"` | `.pf-c-form__group-label-help` | Provides an accessible label on a button that provides additional information for a form element. |
684
+ | Attribute | Applied to | Outcome |
685
+ | -- | -- | -- |
686
+ | `for` | `<label>` | Each `<label>` must have a `for` attribute that matches its form field id. **Required** |
687
+ | `id` | `<input type="radio/checkbox/text">`, `<select>`, `<textarea>` | Each `<form>` field must have an `id` attribute that matches its label's `for` value. **Required** |
688
+ | `required` | `<input>`, `<select>`, `<textarea>` | Required fields must include these attributes. |
689
+ | `id="{helper_text_id}"` | `.pf-c-form__helper-text` | Form fields with related `.pf-c-form__helper-text` require this attribute. Usage `<p class="pf-c-form__helper-text" id="{helper_text_id}">`. |
690
+ | `aria-describedby="{helper_text_id}"` | `<input>`, `<select>`, `<textarea>` | Form fields with related `.pf-c-form__helper-text` require this attribute. Usage `<input aria-describedby="{helper_text_id}">`. |
691
+ | `aria-invalid="true" aria-describedby="{helper_text_id}"` | `<input>`, `<select>`, `<textarea>` | When form validation fails `aria-describedby` is used to communicate the error to the user. These attributes need to be handled with Javascript so that `aria-describedby` only references help text that explains the error, and so that `aria-invalid="true"` is only present when validation fails. For proper styling of errors `aria-invalid="true"` is required. |
692
+ | `aria-hidden="true"` | `.pf-c-form__label-required` | Hides the required indicator from assistive technologies. |
693
+ | `role="group"` | `.pf-c-form__group`, `.pf-c-form__section`, `.pf-c-form__field-group` | Provides group role for form groups, form sections, and form field groups. **Required for checkbox groups, form groups, form sections, and form field groups.** |
694
+ | `role="radiogroup"` | `.pf-c-form__group` | Provides group role for radio input groups. **Required for radio input groups** |
695
+ | `role="button"` | `.pf-c-form__group-label-help` | Provides button role for group label help spans. **Required for group label help.** |
696
+ | `id` | `.pf-c-form__group-label` | Generates an `id` for use in the `aria-labelledby` attribute in a checkbox or radio form group. |
697
+ | `id` | `.pf-c-form__field-group-title-text` | Generates an `id` for use in the `aria-labelledby` attribute in an expandable field group's toggle button. |
698
+ | `id` | `.pf-c-form__field-group-toggle-button > button` | Generates an `id` for use in the `aria-labelledby` attribute in an expandable field group's toggle button. |
699
+ | `aria-labelledby="{label id}"` | `.pf-c-form__group`, `.pf-c-form__section`, `.pf-c-form__field-group` | Provides an accessible label for form groups, form sections, and form field groups. **Required for form groups, form sections, and form field groups that contain labels.** |
700
+ | `aria-label` | `.pf-c-form__field-group-toggle-button > button` | Provides an accessible label for the field group toggle button. |
701
+ | `aria-labelledby="{title id} {toggle button id}"` | `.pf-c-form__field-group-toggle-button > button` | Provides an accessible label for the field group toggle button. |
702
+ | `aria-expanded="true/false"` | `.pf-c-form__field-group-toggle-button > button` | Indicates whether the field group body is visible or hidden. |
703
+ | `id="{form_label_id}"` | `.pf-c-form__label` | Generates an `id` for use in the `aria-describedby` attribute in a `.pf-c-form__group-label-help`. |
704
+ | `aria-label="{descriptive text}" aria-describedby="{form_label_id}"` | `.pf-c-form__group-label-help` | Provides an accessible label on a button that provides additional information for a form element. |
705
705
 
706
706
  ### Usage
707
707
 
708
- | Class | Applied to | Outcome |
709
- | ------------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
710
- | `.pf-c-form` | `<form>` | Initiates a standard form. **Required** |
711
- | `.pf-c-form__section` | `<div>, <section>` | Initiates a form section. |
712
- | `.pf-c-form__section-title` | `<h1>`,`<h2>`,`<h3>`,`<h4>`,`<h5>`,`<h6>`, `<div>` | Initiates a form section title. |
713
- | `.pf-c-form__group` | `<div>` | Initiates a form group. |
714
- | `.pf-c-form__group-label` | `<div>` | Initiates a form group label. |
715
- | `.pf-c-form__label` | `<label>`, `<span>` | Initiates a form label. **Required** |
716
- | `.pf-c-form__label-text` | `<span>` | Initiates a form label text. **Required** |
717
- | `.pf-c-form__label-required` | `<span>` | Initiates a form label required indicator. |
718
- | `.pf-c-form__group-label-main` | `<div>` | Initiates a form group label main container. |
719
- | `.pf-c-form__group-label-info` | `<div>` | Initiates a form group info label. |
720
- | `.pf-c-form__group-label-help` | `<button>`, `<span>` | Initiates a field level help span/button. |
721
- | `.pf-c-form__group-control` | `<div>` | Initiates a form group control section. |
722
- | `.pf-c-form__actions` | `<div>` | Iniates a row of actions. |
723
- | `.pf-c-form__helper-text` | `<p>`, `<div>` | Initiates a form helper text block. |
724
- | `.pf-c-form__helper-text-icon` | `<span>` | Initiates a form helper text icon. |
725
- | `.pf-c-form__alert` | `<div>` | Initiates the form alert container for inline alerts. |
726
- | `.pf-c-form__field-group` | `<div>` | Initiates a form field group. |
727
- | `.pf-c-form__field-group-toggle` | `<div>` | Initiates the form field group toggle. |
728
- | `.pf-c-form__field-group-toggle-button` | `<div>` | Initiates the form field group toggle button. |
729
- | `.pf-c-form__field-group-toggle-icon` | `<span>` | Initiates the form field group toggle icon. |
730
- | `.pf-c-form__field-group-header` | `<div>` | Initiates the form field group header. |
731
- | `.pf-c-form__field-group-header-main` | `<div>` | Initiates the form field group main section. |
732
- | `.pf-c-form__field-group-header-title` | `<div>` | Initiates the form field group title. |
733
- | `.pf-c-form__field-group-header-title-text` | `<div>` | Initiates the form field group title text. |
734
- | `.pf-c-form__field-group-header-description` | `<div>` | Initiates the form field group description. |
735
- | `.pf-c-form__field-group-header-actions` | `<div>` | Initiates the form field group actions container. |
736
- | `.pf-c-form__field-group-body` | `<div>` | Initiates the form field group body. |
737
- | `.pf-m-horizontal{-on-[xs, sm, md, lg, xl, 2xl]}` | `.pf-c-form` | Modifies the form for a horizontal layout at an optional breakpoint. The default breakpoint is `-md`. |
738
- | `.pf-m-limit-width` | `.pf-c-form` | Limits the overall max-width of the form. Configurable by defining `--pf-c-form--m-limit-width--MaxWidth`. |
739
- | `.pf-m-info` | `.pf-c-form__group-label` | Modifies the form group label to contain form group label info. |
740
- | `.pf-m-action` | `.pf-c-form__group` | Modifies form group margin-top. |
741
- | `.pf-m-success` | `.pf-c-form__helper-text` | Modifies text color of helper text for success state. |
742
- | `.pf-m-warning` | `.pf-c-form__helper-text` | Modifies text color of helper text for warning state. |
743
- | `.pf-m-error` | `.pf-c-form__helper-text` | Modifies text color of helper text for error state. |
744
- | `.pf-m-inactive` | `.pf-c-form__helper-text` | Modifies display of helper text to none. |
745
- | `.pf-m-disabled` | `.pf-c-form__label` | Modifies form label to show disabled state. |
746
- | `.pf-m-no-padding-top` | `.pf-c-form__group-label` | Removes top padding from the label element for labels adjacent to an element that isn't a form control. |
747
- | `.pf-m-inline` | `.pf-c-form__group-control` | Modifies form group children to be inline (this is primarily for radio buttons and checkboxes). |
748
- | `.pf-m-stack` | `.pf-c-form__group-control` | Modifies form group children to be stacked with space between children. |
749
- | `.pf-m-expanded` | `.pf-c-form__field-group` | Modifies an expandable field group for the expanded state. |
750
- | `--pf-c-form--m-limit-width--MaxWidth` | `.pf-c-form.pf-m-limit-width` | Sets a custom `max-width` for a width limited form. |
708
+ | Class | Applied to | Outcome |
709
+ | -- | -- | -- |
710
+ | `.pf-c-form` | `<form>` | Initiates a standard form. **Required** |
711
+ | `.pf-c-form__section` | `<div>, <section>` | Initiates a form section. |
712
+ | `.pf-c-form__section-title` | `<h1>`,`<h2>`,`<h3>`,`<h4>`,`<h5>`,`<h6>`, `<div>` | Initiates a form section title. |
713
+ | `.pf-c-form__group` | `<div>` | Initiates a form group. |
714
+ | `.pf-c-form__group-label` | `<div>` | Initiates a form group label. |
715
+ | `.pf-c-form__label` | `<label>`, `<span>` | Initiates a form label. **Required** |
716
+ | `.pf-c-form__label-text` | `<span>` | Initiates a form label text. **Required** |
717
+ | `.pf-c-form__label-required` | `<span>` | Initiates a form label required indicator. |
718
+ | `.pf-c-form__group-label-main` | `<div>` | Initiates a form group label main container. |
719
+ | `.pf-c-form__group-label-info` | `<div>` | Initiates a form group info label. |
720
+ | `.pf-c-form__group-label-help` | `<button>`, `<span>` | Initiates a field level help span/button. |
721
+ | `.pf-c-form__group-control` | `<div>` | Initiates a form group control section. |
722
+ | `.pf-c-form__actions` | `<div>` | Iniates a row of actions. |
723
+ | `.pf-c-form__helper-text` | `<p>`, `<div>` | Initiates a form helper text block. |
724
+ | `.pf-c-form__helper-text-icon` | `<span>` | Initiates a form helper text icon. |
725
+ | `.pf-c-form__alert` | `<div>` | Initiates the form alert container for inline alerts. |
726
+ | `.pf-c-form__field-group` | `<div>` | Initiates a form field group. |
727
+ | `.pf-c-form__field-group-toggle` | `<div>` | Initiates the form field group toggle. |
728
+ | `.pf-c-form__field-group-toggle-button` | `<div>` | Initiates the form field group toggle button. |
729
+ | `.pf-c-form__field-group-toggle-icon` | `<span>` | Initiates the form field group toggle icon. |
730
+ | `.pf-c-form__field-group-header` | `<div>` | Initiates the form field group header. |
731
+ | `.pf-c-form__field-group-header-main` | `<div>` | Initiates the form field group main section. |
732
+ | `.pf-c-form__field-group-header-title` | `<div>` | Initiates the form field group title. |
733
+ | `.pf-c-form__field-group-header-title-text` | `<div>` | Initiates the form field group title text. |
734
+ | `.pf-c-form__field-group-header-description` | `<div>` | Initiates the form field group description. |
735
+ | `.pf-c-form__field-group-header-actions` | `<div>` | Initiates the form field group actions container. |
736
+ | `.pf-c-form__field-group-body` | `<div>` | Initiates the form field group body. |
737
+ | `.pf-m-horizontal{-on-[xs, sm, md, lg, xl, 2xl]}` | `.pf-c-form` | Modifies the form for a horizontal layout at an optional breakpoint. The default breakpoint is `-md`. |
738
+ | `.pf-m-limit-width` | `.pf-c-form` | Limits the overall max-width of the form. Configurable by defining `--pf-c-form--m-limit-width--MaxWidth`. |
739
+ | `.pf-m-info` | `.pf-c-form__group-label` | Modifies the form group label to contain form group label info. |
740
+ | `.pf-m-action` | `.pf-c-form__group` | Modifies form group margin-top. |
741
+ | `.pf-m-success` | `.pf-c-form__helper-text` | Modifies text color of helper text for success state. |
742
+ | `.pf-m-warning` | `.pf-c-form__helper-text` | Modifies text color of helper text for warning state. |
743
+ | `.pf-m-error` | `.pf-c-form__helper-text`| Modifies text color of helper text for error state. |
744
+ | `.pf-m-inactive` | `.pf-c-form__helper-text`| Modifies display of helper text to none. |
745
+ | `.pf-m-disabled` | `.pf-c-form__label` | Modifies form label to show disabled state. |
746
+ | `.pf-m-no-padding-top` | `.pf-c-form__group-label` | Removes top padding from the label element for labels adjacent to an element that isn't a form control. |
747
+ | `.pf-m-inline` | `.pf-c-form__group-control` | Modifies form group children to be inline (this is primarily for radio buttons and checkboxes). |
748
+ | `.pf-m-stack` | `.pf-c-form__group-control` | Modifies form group children to be stacked with space between children. |
749
+ | `.pf-m-expanded` | `.pf-c-form__field-group` | Modifies an expandable field group for the expanded state. |
750
+ | `--pf-c-form--m-limit-width--MaxWidth` | `.pf-c-form.pf-m-limit-width` | Sets a custom `max-width` for a width limited form. |