From 966040b03c8097c55cf9bb5001edae50d00ad073 Mon Sep 17 00:00:00 2001
From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com>
Date: Tue, 24 Feb 2026 11:37:07 -0500
Subject: [PATCH] docs(bulk-selection): Updates the docs, images,, and adds
more guidance around behavior.
---
.../patterns/bulk-selection/bulk-selection.md | 115 ++++++++++++++----
.../img/bulk-select-checkbox.png | Bin 50529 -> 0 bytes
.../img/bulk-selection-example.png | Bin 195970 -> 0 bytes
.../img/bulk-selection-no-toolbar.png | Bin 161787 -> 0 bytes
.../img/bulk-selection-selected.svg | 87 +++++++++++++
.../img/bulk-selection-table.svg | 73 +++++++++++
.../img/bulk-selection-toolbar.svg | 102 ++++++++++++++++
.../bulk-selection/img/bulk-selection.svg | 43 +++++++
.../bulk-selection/img/bulk-selector.png | Bin 230707 -> 0 bytes
.../bulk-selection/img/checkbox-states.svg | 64 ++++++++++
.../bulk-selection/img/empty-selection.svg | 46 +++++++
.../bulk-selection/img/full-selection.svg | 47 +++++++
.../bulk-selection/img/partial-selection.svg | 47 +++++++
13 files changed, 599 insertions(+), 25 deletions(-)
delete mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-select-checkbox.png
delete mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-selection-example.png
delete mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-selection-no-toolbar.png
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-selection-selected.svg
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-selection-table.svg
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-selection-toolbar.svg
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-selection.svg
delete mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-selector.png
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/checkbox-states.svg
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/empty-selection.svg
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/full-selection.svg
create mode 100644 packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/partial-selection.svg
diff --git a/packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/bulk-selection.md b/packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/bulk-selection.md
index 7fd3fa7e3b..7abd3f9edd 100644
--- a/packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/bulk-selection.md
+++ b/packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/bulk-selection.md
@@ -2,48 +2,113 @@
id: Bulk selection
section: patterns
---
+import '../../components/components.css';
-## Bulk selection
-Use a bulk selection pattern when you want to select or deselect multiple items in a content view (list, table, or card grid). The bulk selector uses a [split button](/components/menus/menu-toggle#split-button-toggle-with-checkbox) component to control selection from the [toolbar](/components/toolbar). Besides controlling selection, the bulk selector reflects the selection status of the related component (partially selected, all items selected, or no items selected).
+**Bulk selection** enables users to select or deselect multiple items in a content view, such as lists, tables, or card views.
## Bulk selector
-The bulk selector is created using a Split button and is always located as the leftmost item in a toolbar.
+You can add a bulk selection control in the toolbar of a content view. This control, a bulk selector, lets users control selection via a [split button](/components/menus/menu-toggle#split-button-toggle-with-checkbox) component. The bulk selector also reflects the selection status of the related content, including partial selection, full selection, or no selection.
-
+
+
+
-**1. Bulk selector:** The bulk selector uses a split button to combine a selection checkbox with a dropdown menu.
+1. **Bulk selector:** A split button that combines a selection checkbox with a dropdown menu toggle.
-**2. Checkbox:** The state of the checkbox reflects the current selection state of the list, table, or card grid.
+2. **Menu:** A list of bulk selection options for the related content view. A bulk selection menu should include the following options:
+ - "Select none", which clears a previous selection.
+ - "Select page", which selects all items on the current page (when pagination is in use).
+ - "Select all", which selects all items across all pages. This can be omitted if this isn't supported in your implementation.
+ - (Optionally) Additional menu items that match some predetermined filter criteria, such as “Running VMs”, "Errors”, and so on.
-
+
+
+
-**3. Items selected:** This text always reflects the total number of items selected. If pagination is in use, it will reflect the items selected across all pages.
+1. **Checkbox:** Control that reflects the current selection state of the item. Checkbox states will be automatically updated by bulk selector menu selections, but can also be manually selected. Manually clicking the checkbox in the bulk selector will select all items in the related content view.
-**4. Menu:** at a minimum the menu will include:
-* Select none - to clear selections across all pages.
-* Select page - to select all items on the current page (when pagination is in use).
-* Select all - to select all items across pages.
+2. **Selection status:** Text label that reflects the total number of items selected. If pagination is in use, it will reflect the number of items selected across all pages.
-Additional menu items can be added to select items that match some predetermined filter criteria, such as “Red Cars or Blue Cars” / “Running VMs”, etc.
+3. **Selected checkbox:** Indicates that an item has been selected. Either a partial selection (dash) or a full selection (check mark) can be displayed in a checkbox. For more details about the behavior of the checkbox, refer to [checkbox states](#checkbox-states).
+
+4. **Empty checkbox:** Indicates that an item has not been selected.
## Usage
-### Bulk selection from the toolbar
-The example below shows a bulk selector placed in a toolbar above a table using pagination.
-
+### Selection in toolbars
+A bulk selector is often placed in the toolbar of a table that uses pagination.
+
+
+
+
+
+In this example, there are 50 total items in this dataset across 10 pages. Only the first page has been selected, so partial selection is reflected across checkboxes. The user can select (or deselect) additional items via the bulk selection checkbox, the bulk selection menu, or by clicking on a row's checkbox. The selected items count will update whenever selection is changed.
+
+### Selection for global actions
+Bulk selection is often used to select multiple items and perform an action on them. In these instances, the selection state persists—even after the action has completed—until the user purposefully changes the selection.
+
+### Integrated selection for tables
+Tables include integrated bulk selection by default in the header row.
+
+
+
+
+
+A checkbox in a table's header row will select or deselect all items in the table (or all items on the current page if pagination is in use).
+
+We recommend only using integrated bulk selection when a table doesn't contain a toolbar. When a toolbar is present, you should instead default to controlling bulk selection via the toolbar. This provides better visibility for the number of selected item, maintains better consistency between view types, and allows for more selection flexibility.
+
+**Note:** To hide integrated bulk selection and enable the toolbar control in our [table component](/components/table), set the `canSelectAll` prop to "false".
+
+## Behavior
+
+### Checkbox states
+
+
+
+
+
+There are a few checkbox states that can result from bulk selection:
+
+1. **Disabled:** Cannot be interacted with.
+2. **Partial selection:** Uses the minus icon to represent that the item is part of a partial selection, meaning that only some items are selected.
+3. **Unchecked:** Represents that the item hasn't been selected.
+4. **Full selection:** Uses the check mark icon to represent that the item is part of a full selection, where all items are selected in a content view.
+
+#### No items selected
+
+
+
+
+
+1. **Checkbox:** Empty. When clicked, selects all items.
+2. **Menu toggle:** Opens and closes the selection menu.
+3. **Menu:** Displays selection options. "Select none" is disabled, since no items are selected.
+
+#### Some items selected
+
+
+
+
-There are 50 total items in this dataset spread across 10 pages (5 items per page), but only the first page has been selected and therefore partial selection is reflected in the checkbox. The user may select (or deselect) additional items either through the use of the bulk selection checkbox, the bulk selection menu, or by clicking on the checkbox at the front of a row. The selected items count will update whenever selection is changed.
+1. **Checkbox:** Filled, containing a minus icon. When clicked, deselects all selected items.
+2. **Text label:** Displays the number of selected items. When clicked, opens and closes the selection menu.
+3. **Menu toggle:** Opens and closes the selection menu.
+4. **Menu:** Displays selection options.
-### Bulk selection and global actions
-Bulk selection is often used to select multiple items and perform an action on them. Note that after an action is completed, the selection state remains as is until the user changes the selection.
+The following guidance outlines the behavior of the bulk selector for different selection states.
-### Integrated bulk selection for tables
-Tables are unique to other view in that they include integrated bulk selection by default. Below is an example of a PatternFly table component with integrated bulk selection in the header row.
+#### All items selected
-
+
+
+
-**1. Bulk selection checkbox:** A checkbox in the header row of a table will select (or deselect) all items in the table or all items on the current page if pagination is in use.
+1. **Checkbox:** Filled, containing a check mark icon. When clicked, deselects all selected items.
+2. **Text label:** Displays the number of selected items. When clicked, opens and closes the selection menu.
+3. **Menu toggle:** Opens and closes the selection menu.
+4. **Menu:** Displays selection options.
-In PatternFly we recommend that integrated bulk selection only be used in cases where a table is placed in a page without a toolbar. Whenever a toolbar is present, we recommend using the toolbar to control bulk selection. This will provide for better visibility on the count of selected items, lead to better consistency between view types, and allow for more variety of selection options.
+## Placement
-Note: To hide integrated bulk selection and enable selection control from the toolbar in the PatternFly React Table component, set the canSelectAll prop to ‘false’.
+When used in a toolbar, the bulk selector should be the first item.
\ No newline at end of file
diff --git a/packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-select-checkbox.png b/packages/documentation-site/patternfly-docs/content/patterns/bulk-selection/img/bulk-select-checkbox.png
deleted file mode 100644
index 09ac40db2898b54e30aae8c3675127a278ed1e08..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 50529
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%0D%F{KgM{gs70%MO
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
z