@patternfly/patternfly 4.162.0 → 4.164.0

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.
@@ -571,6 +571,144 @@ cssPrefix: pf-c-dropdown
571
571
 
572
572
  ```
573
573
 
574
+ ### Plain with text
575
+
576
+ ```html
577
+ <div class="pf-c-dropdown">
578
+ <button
579
+ class="pf-c-dropdown__toggle pf-m-plain pf-m-text"
580
+ id="plain-with-text-example-disabled-button"
581
+ aria-expanded="false"
582
+ type="button"
583
+ disabled
584
+ >
585
+ <span class="pf-c-dropdown__toggle-text">Custom text</span>
586
+ <span class="pf-c-dropdown__toggle-icon">
587
+ <i class="fas fa-caret-down" aria-hidden="true"></i>
588
+ </span>
589
+ </button>
590
+ <ul
591
+ class="pf-c-dropdown__menu"
592
+ aria-labelledby="plain-with-text-example-disabled-button"
593
+ hidden
594
+ >
595
+ <li>
596
+ <a class="pf-c-dropdown__menu-item" href="#">Link</a>
597
+ </li>
598
+ <li>
599
+ <button class="pf-c-dropdown__menu-item" type="button">Action</button>
600
+ </li>
601
+ <li>
602
+ <a
603
+ class="pf-c-dropdown__menu-item pf-m-disabled"
604
+ href="#"
605
+ aria-disabled="true"
606
+ tabindex="-1"
607
+ >Disabled link</a>
608
+ </li>
609
+ <li>
610
+ <button
611
+ class="pf-c-dropdown__menu-item"
612
+ type="button"
613
+ disabled
614
+ >Disabled action</button>
615
+ </li>
616
+ <li class="pf-c-divider" role="separator"></li>
617
+ <li>
618
+ <a class="pf-c-dropdown__menu-item" href="#">Separated link</a>
619
+ </li>
620
+ </ul>
621
+ </div>&nbsp;
622
+ <div class="pf-c-dropdown">
623
+ <button
624
+ class="pf-c-dropdown__toggle pf-m-plain pf-m-text"
625
+ id="plain-with-text-example-button"
626
+ aria-expanded="false"
627
+ type="button"
628
+ >
629
+ <span class="pf-c-dropdown__toggle-text">Custom text</span>
630
+ <span class="pf-c-dropdown__toggle-icon">
631
+ <i class="fas fa-caret-down" aria-hidden="true"></i>
632
+ </span>
633
+ </button>
634
+ <ul
635
+ class="pf-c-dropdown__menu"
636
+ aria-labelledby="plain-with-text-example-button"
637
+ hidden
638
+ >
639
+ <li>
640
+ <a class="pf-c-dropdown__menu-item" href="#">Link</a>
641
+ </li>
642
+ <li>
643
+ <button class="pf-c-dropdown__menu-item" type="button">Action</button>
644
+ </li>
645
+ <li>
646
+ <a
647
+ class="pf-c-dropdown__menu-item pf-m-disabled"
648
+ href="#"
649
+ aria-disabled="true"
650
+ tabindex="-1"
651
+ >Disabled link</a>
652
+ </li>
653
+ <li>
654
+ <button
655
+ class="pf-c-dropdown__menu-item"
656
+ type="button"
657
+ disabled
658
+ >Disabled action</button>
659
+ </li>
660
+ <li class="pf-c-divider" role="separator"></li>
661
+ <li>
662
+ <a class="pf-c-dropdown__menu-item" href="#">Separated link</a>
663
+ </li>
664
+ </ul>
665
+ </div>&nbsp;
666
+ <div class="pf-c-dropdown pf-m-expanded">
667
+ <button
668
+ class="pf-c-dropdown__toggle pf-m-plain pf-m-text"
669
+ id="plain-with-text-example-expanded-button"
670
+ aria-expanded="true"
671
+ type="button"
672
+ >
673
+ <span class="pf-c-dropdown__toggle-text">Custom text (expanded)</span>
674
+ <span class="pf-c-dropdown__toggle-icon">
675
+ <i class="fas fa-caret-down" aria-hidden="true"></i>
676
+ </span>
677
+ </button>
678
+ <ul
679
+ class="pf-c-dropdown__menu"
680
+ aria-labelledby="plain-with-text-example-expanded-button"
681
+ >
682
+ <li>
683
+ <a class="pf-c-dropdown__menu-item" href="#">Link</a>
684
+ </li>
685
+ <li>
686
+ <button class="pf-c-dropdown__menu-item" type="button">Action</button>
687
+ </li>
688
+ <li>
689
+ <a
690
+ class="pf-c-dropdown__menu-item pf-m-disabled"
691
+ href="#"
692
+ aria-disabled="true"
693
+ tabindex="-1"
694
+ >Disabled link</a>
695
+ </li>
696
+ <li>
697
+ <button
698
+ class="pf-c-dropdown__menu-item"
699
+ type="button"
700
+ disabled
701
+ >Disabled action</button>
702
+ </li>
703
+ <li class="pf-c-divider" role="separator"></li>
704
+ <li>
705
+ <a class="pf-c-dropdown__menu-item" href="#">Separated link</a>
706
+ </li>
707
+ </ul>
708
+ </div>
709
+
710
+ ```
711
+
574
712
  ### Badge toggle
575
713
 
576
714
  ```html
@@ -1434,6 +1572,51 @@ The dropdown panel is provided for flexibility in allowing various content withi
1434
1572
  </li>
1435
1573
  </ul>
1436
1574
  </div>
1575
+ <div class="pf-c-dropdown">
1576
+ <button
1577
+ class="pf-c-dropdown__toggle pf-m-primary"
1578
+ id="dropdown-primary-toggle-disabled-button"
1579
+ aria-expanded="false"
1580
+ type="button"
1581
+ disabled
1582
+ >
1583
+ <span class="pf-c-dropdown__toggle-text">Disabled</span>
1584
+ <span class="pf-c-dropdown__toggle-icon">
1585
+ <i class="fas fa-caret-down" aria-hidden="true"></i>
1586
+ </span>
1587
+ </button>
1588
+ <ul
1589
+ class="pf-c-dropdown__menu"
1590
+ aria-labelledby="dropdown-primary-toggle-disabled-button"
1591
+ hidden
1592
+ >
1593
+ <li>
1594
+ <a class="pf-c-dropdown__menu-item" href="#">Link</a>
1595
+ </li>
1596
+ <li>
1597
+ <button class="pf-c-dropdown__menu-item" type="button">Action</button>
1598
+ </li>
1599
+ <li>
1600
+ <a
1601
+ class="pf-c-dropdown__menu-item pf-m-disabled"
1602
+ href="#"
1603
+ aria-disabled="true"
1604
+ tabindex="-1"
1605
+ >Disabled link</a>
1606
+ </li>
1607
+ <li>
1608
+ <button
1609
+ class="pf-c-dropdown__menu-item"
1610
+ type="button"
1611
+ disabled
1612
+ >Disabled action</button>
1613
+ </li>
1614
+ <li class="pf-c-divider" role="separator"></li>
1615
+ <li>
1616
+ <a class="pf-c-dropdown__menu-item" href="#">Separated link</a>
1617
+ </li>
1618
+ </ul>
1619
+ </div>
1437
1620
 
1438
1621
  ```
1439
1622
 
@@ -1527,6 +1710,51 @@ The dropdown panel is provided for flexibility in allowing various content withi
1527
1710
  </li>
1528
1711
  </ul>
1529
1712
  </div>
1713
+ <div class="pf-c-dropdown">
1714
+ <button
1715
+ class="pf-c-dropdown__toggle pf-m-secondary"
1716
+ id="dropdown-secondary-toggle-disabled-button"
1717
+ aria-expanded="false"
1718
+ type="button"
1719
+ disabled
1720
+ >
1721
+ <span class="pf-c-dropdown__toggle-text">Disabled</span>
1722
+ <span class="pf-c-dropdown__toggle-icon">
1723
+ <i class="fas fa-caret-down" aria-hidden="true"></i>
1724
+ </span>
1725
+ </button>
1726
+ <ul
1727
+ class="pf-c-dropdown__menu"
1728
+ aria-labelledby="dropdown-secondary-toggle-disabled-button"
1729
+ hidden
1730
+ >
1731
+ <li>
1732
+ <a class="pf-c-dropdown__menu-item" href="#">Link</a>
1733
+ </li>
1734
+ <li>
1735
+ <button class="pf-c-dropdown__menu-item" type="button">Action</button>
1736
+ </li>
1737
+ <li>
1738
+ <a
1739
+ class="pf-c-dropdown__menu-item pf-m-disabled"
1740
+ href="#"
1741
+ aria-disabled="true"
1742
+ tabindex="-1"
1743
+ >Disabled link</a>
1744
+ </li>
1745
+ <li>
1746
+ <button
1747
+ class="pf-c-dropdown__menu-item"
1748
+ type="button"
1749
+ disabled
1750
+ >Disabled action</button>
1751
+ </li>
1752
+ <li class="pf-c-divider" role="separator"></li>
1753
+ <li>
1754
+ <a class="pf-c-dropdown__menu-item" href="#">Separated link</a>
1755
+ </li>
1756
+ </ul>
1757
+ </div>
1530
1758
 
1531
1759
  ```
1532
1760
 
@@ -1704,6 +1932,7 @@ The dropdown menu can contain either links or buttons, depending on the expected
1704
1932
  | `.pf-m-action` | `.pf-c-dropdown__toggle.pf-m-split-button` | Modifies the dropdown toggle for when an action is placed beside a toggle button in a split button dropdown. |
1705
1933
  | `.pf-m-text` | `.pf-c-dropdown__menu-item` | Modifies a menu item to be non-interactive text. |
1706
1934
  | `.pf-m-plain` | `.pf-c-dropdown__toggle` | Modifies to display the toggle with no border. |
1935
+ | `.pf-m-text` | `.pf-c-dropdown__toggle` | Modifies the dropdown toggle for the text variation. |
1707
1936
  | `.pf-m-primary` | `.pf-c-dropdown__toggle` | Modifies to display the toggle with primary styles. |
1708
1937
  | `.pf-m-secondary` | `.pf-c-dropdown__toggle` | Modifies to display the toggle with secondary styles. |
1709
1938
  | `.pf-m-full-height` | `.pf-c-dropdown` | Modifies a dropdown to full height of parent. See masthead for use. |
@@ -118,6 +118,34 @@ cssPrefix: pf-c-form
118
118
 
119
119
  ```
120
120
 
121
+ ### Horizontal layout at a custom breakpoint
122
+
123
+ ```html
124
+ <form novalidate class="pf-c-form pf-m-horizontal-on-sm">
125
+ <div class="pf-c-form__group">
126
+ <div class="pf-c-form__group-label">
127
+ <label class="pf-c-form__label" for="form-horizontal-name">
128
+ <span class="pf-c-form__label-text">Name</span>
129
+ <span class="pf-c-form__label-required" aria-hidden="true">&#42;</span>
130
+ </label>
131
+ <button class="pf-c-form__group-label-help" aria-label="More info">
132
+ <i class="pficon pf-icon-help" aria-hidden="true"></i>
133
+ </button>
134
+ </div>
135
+ <div class="pf-c-form__group-control">
136
+ <input
137
+ class="pf-c-form-control"
138
+ type="text"
139
+ id="form-horizontal-name"
140
+ name="form-horizontal-name"
141
+ required
142
+ />
143
+ </div>
144
+ </div>
145
+ </form>
146
+
147
+ ```
148
+
121
149
  ### Form sections
122
150
 
123
151
  ```html
@@ -1119,44 +1147,44 @@ cssPrefix: pf-c-form
1119
1147
 
1120
1148
  ### Usage
1121
1149
 
1122
- | Class | Applied to | Outcome |
1123
- | -------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
1124
- | `.pf-c-form` | `<form>` | Initiates a standard form. **Required** |
1125
- | `.pf-c-form__section` | `<div>, <section>` | Initiates a form section. |
1126
- | `.pf-c-form__section-title` | `<h1>`,`<h2>`,`<h3>`,`<h4>`,`<h5>`,`<h6>`, `<div>` | Initiates a form section title. |
1127
- | `.pf-c-form__group` | `<div>` | Initiates a form group. |
1128
- | `.pf-c-form__group-label` | `<div>` | Initiates a form group label. |
1129
- | `.pf-c-form__label` | `<label>`, `<span>` | Initiates a form label. **Required** |
1130
- | `.pf-c-form__label-text` | `<span>` | Initiates a form label text. **Required** |
1131
- | `.pf-c-form__label-required` | `<span>` | Initiates a form label required indicator. |
1132
- | `.pf-c-form__group-label-main` | `<div>` | Initiates a form group label main container. |
1133
- | `.pf-c-form__group-label-info` | `<div>` | Initiates a form group info label. |
1134
- | `.pf-c-form__group-label-help` | `<button>` | Initiates a field level help button. |
1135
- | `.pf-c-form__group-control` | `<div>` | Initiates a form group control section. |
1136
- | `.pf-c-form__actions` | `<div>` | Iniates a row of actions. |
1137
- | `.pf-c-form__helper-text` | `<p>`, `<div>` | Initiates a form helper text block. |
1138
- | `.pf-c-form__helper-text-icon` | `<span>` | Initiates a form helper text icon. |
1139
- | `.pf-c-form__alert` | `<div>` | Initiates the form alert container for inline alerts. |
1140
- | `.pf-c-form__field-group` | `<div>` | Initiates a form field group. |
1141
- | `.pf-c-form__field-group-toggle` | `<div>` | Initiates the form field group toggle. |
1142
- | `.pf-c-form__field-group-toggle-button` | `<div>` | Initiates the form field group toggle button. |
1143
- | `.pf-c-form__field-group-toggle-icon` | `<span>` | Initiates the form field group toggle icon. |
1144
- | `.pf-c-form__field-group-header` | `<div>` | Initiates the form field group header. |
1145
- | `.pf-c-form__field-group-header-main` | `<div>` | Initiates the form field group main section. |
1146
- | `.pf-c-form__field-group-header-title` | `<div>` | Initiates the form field group title. |
1147
- | `.pf-c-form__field-group-header-title-text` | `<div>` | Initiates the form field group title text. |
1148
- | `.pf-c-form__field-group-header-description` | `<div>` | Initiates the form field group description. |
1149
- | `.pf-c-form__field-group-header-actions` | `<div>` | Initiates the form field group actions container. |
1150
- | `.pf-c-form__field-group-body` | `<div>` | Initiates the form field group body. |
1151
- | `.pf-m-horizontal` | `.pf-c-form` | Modifies form for a horizontal layout. |
1152
- | `.pf-m-info` | `.pf-c-form__group-label` | Modifies the form group label to contain form group label info. |
1153
- | `.pf-m-action` | `.pf-c-form__group` | Modifies form group margin-top. |
1154
- | `.pf-m-success` | `.pf-c-form__helper-text` | Modifies text color of helper text for success state. |
1155
- | `.pf-m-warning` | `.pf-c-form__helper-text` | Modifies text color of helper text for warning state. |
1156
- | `.pf-m-error` | `.pf-c-form__helper-text` | Modifies text color of helper text for error state. |
1157
- | `.pf-m-inactive` | `.pf-c-form__helper-text` | Modifies display of helper text to none. |
1158
- | `.pf-m-disabled` | `.pf-c-form__label` | Modifies form label to show disabled state. |
1159
- | `.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. |
1160
- | `.pf-m-inline` | `.pf-c-form__group-control` | Modifies form group children to be inline (this is primarily for radio buttons and checkboxes). |
1161
- | `.pf-m-stack` | `.pf-c-form__group-control` | Modifies form group children to be stacked with space between children. |
1162
- | `.pf-m-expanded` | `.pf-c-form__field-group` | Modifies an expandable field group for the expanded state. |
1150
+ | Class | Applied to | Outcome |
1151
+ | ------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
1152
+ | `.pf-c-form` | `<form>` | Initiates a standard form. **Required** |
1153
+ | `.pf-c-form__section` | `<div>, <section>` | Initiates a form section. |
1154
+ | `.pf-c-form__section-title` | `<h1>`,`<h2>`,`<h3>`,`<h4>`,`<h5>`,`<h6>`, `<div>` | Initiates a form section title. |
1155
+ | `.pf-c-form__group` | `<div>` | Initiates a form group. |
1156
+ | `.pf-c-form__group-label` | `<div>` | Initiates a form group label. |
1157
+ | `.pf-c-form__label` | `<label>`, `<span>` | Initiates a form label. **Required** |
1158
+ | `.pf-c-form__label-text` | `<span>` | Initiates a form label text. **Required** |
1159
+ | `.pf-c-form__label-required` | `<span>` | Initiates a form label required indicator. |
1160
+ | `.pf-c-form__group-label-main` | `<div>` | Initiates a form group label main container. |
1161
+ | `.pf-c-form__group-label-info` | `<div>` | Initiates a form group info label. |
1162
+ | `.pf-c-form__group-label-help` | `<button>` | Initiates a field level help button. |
1163
+ | `.pf-c-form__group-control` | `<div>` | Initiates a form group control section. |
1164
+ | `.pf-c-form__actions` | `<div>` | Iniates a row of actions. |
1165
+ | `.pf-c-form__helper-text` | `<p>`, `<div>` | Initiates a form helper text block. |
1166
+ | `.pf-c-form__helper-text-icon` | `<span>` | Initiates a form helper text icon. |
1167
+ | `.pf-c-form__alert` | `<div>` | Initiates the form alert container for inline alerts. |
1168
+ | `.pf-c-form__field-group` | `<div>` | Initiates a form field group. |
1169
+ | `.pf-c-form__field-group-toggle` | `<div>` | Initiates the form field group toggle. |
1170
+ | `.pf-c-form__field-group-toggle-button` | `<div>` | Initiates the form field group toggle button. |
1171
+ | `.pf-c-form__field-group-toggle-icon` | `<span>` | Initiates the form field group toggle icon. |
1172
+ | `.pf-c-form__field-group-header` | `<div>` | Initiates the form field group header. |
1173
+ | `.pf-c-form__field-group-header-main` | `<div>` | Initiates the form field group main section. |
1174
+ | `.pf-c-form__field-group-header-title` | `<div>` | Initiates the form field group title. |
1175
+ | `.pf-c-form__field-group-header-title-text` | `<div>` | Initiates the form field group title text. |
1176
+ | `.pf-c-form__field-group-header-description` | `<div>` | Initiates the form field group description. |
1177
+ | `.pf-c-form__field-group-header-actions` | `<div>` | Initiates the form field group actions container. |
1178
+ | `.pf-c-form__field-group-body` | `<div>` | Initiates the form field group body. |
1179
+ | `.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`. |
1180
+ | `.pf-m-info` | `.pf-c-form__group-label` | Modifies the form group label to contain form group label info. |
1181
+ | `.pf-m-action` | `.pf-c-form__group` | Modifies form group margin-top. |
1182
+ | `.pf-m-success` | `.pf-c-form__helper-text` | Modifies text color of helper text for success state. |
1183
+ | `.pf-m-warning` | `.pf-c-form__helper-text` | Modifies text color of helper text for warning state. |
1184
+ | `.pf-m-error` | `.pf-c-form__helper-text` | Modifies text color of helper text for error state. |
1185
+ | `.pf-m-inactive` | `.pf-c-form__helper-text` | Modifies display of helper text to none. |
1186
+ | `.pf-m-disabled` | `.pf-c-form__label` | Modifies form label to show disabled state. |
1187
+ | `.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. |
1188
+ | `.pf-m-inline` | `.pf-c-form__group-control` | Modifies form group children to be inline (this is primarily for radio buttons and checkboxes). |
1189
+ | `.pf-m-stack` | `.pf-c-form__group-control` | Modifies form group children to be stacked with space between children. |
1190
+ | `.pf-m-expanded` | `.pf-c-form__field-group` | Modifies an expandable field group for the expanded state. |