@patternfly/react-core 4.221.13 → 4.221.16

package/src/components/DualListSelector/examples/DualListSelectorBasic.tsx

@@ -0,0 +1,26 @@
+import React from 'react';
+import { DualListSelector } from '@patternfly/react-core';
+
+export const DualListSelectorBasic: React.FunctionComponent = () => {
+  const [availableOptions, setAvailableOptions] = React.useState<React.ReactNode[]>([
+    'Option 1',
+    'Option 2',
+    'Option 3',
+    'Option 4'
+  ]);
+  const [chosenOptions, setChosenOptions] = React.useState<React.ReactNode[]>([]);
+
+  const onListChange = (newAvailableOptions: React.ReactNode[], newChosenOptions: React.ReactNode[]) => {
+    setAvailableOptions(newAvailableOptions.sort());
+    setChosenOptions(newChosenOptions.sort());
+  };
+
+  return (
+    <DualListSelector
+      availableOptions={availableOptions}
+      chosenOptions={chosenOptions}
+      onListChange={onListChange}
+      id="dual-list-selector-basic"
+    />
+  );
+};

package/src/components/DualListSelector/examples/DualListSelectorBasicSearch.tsx

@@ -0,0 +1,27 @@
+import React from 'react';
+import { DualListSelector } from '@patternfly/react-core';
+
+export const DualListSelectorBasicSearch: React.FunctionComponent = () => {
+  const [availableOptions, setAvailableOptions] = React.useState<React.ReactNode[]>([
+    'Option 1',
+    'Option 2',
+    'Option 3',
+    'Option 4'
+  ]);
+  const [chosenOptions, setChosenOptions] = React.useState<React.ReactNode[]>([]);
+
+  const onListChange = (newAvailableOptions: React.ReactNode[], newChosenOptions: React.ReactNode[]) => {
+    setAvailableOptions(newAvailableOptions.sort());
+    setChosenOptions(newChosenOptions.sort());
+  };
+
+  return (
+    <DualListSelector
+      isSearchable
+      availableOptions={availableOptions}
+      chosenOptions={chosenOptions}
+      onListChange={onListChange}
+      id="dual-list-selector-basic-search"
+    />
+  );
+};

package/src/components/DualListSelector/examples/DualListSelectorBasicTooltips.tsx

@@ -0,0 +1,34 @@
+import React from 'react';
+import { DualListSelector } from '@patternfly/react-core';
+
+export const DualListSelectorBasicTooltips: React.FunctionComponent = () => {
+  const [availableOptions, setAvailableOptions] = React.useState<React.ReactNode[]>([
+    'Option 1',
+    'Option 2',
+    'Option 3',
+    'Option 4'
+  ]);
+  const [chosenOptions, setChosenOptions] = React.useState<React.ReactNode[]>([]);
+
+  const onListChange = (newAvailableOptions: React.ReactNode[], newChosenOptions: React.ReactNode[]) => {
+    setAvailableOptions(newAvailableOptions.sort());
+    setChosenOptions(newChosenOptions.sort());
+  };
+
+  return (
+    <DualListSelector
+      availableOptions={availableOptions}
+      chosenOptions={chosenOptions}
+      onListChange={onListChange}
+      addAllTooltip="Add all options"
+      addAllTooltipProps={{ position: 'top' }}
+      addSelectedTooltip="Add selected options"
+      addSelectedTooltipProps={{ position: 'right' }}
+      removeSelectedTooltip="Remove selected options"
+      removeSelectedTooltipProps={{ position: 'left' }}
+      removeAllTooltip="Remove all options"
+      removeAllTooltipProps={{ position: 'bottom' }}
+      id="dual-list-selector-basic-tooltips"
+    />
+  );
+};

package/src/components/DualListSelector/examples/DualListSelectorComplexOptionsActions.tsx

@@ -0,0 +1,146 @@
+import React from 'react';
+import {
+  Button,
+  ButtonVariant,
+  Checkbox,
+  Dropdown,
+  DropdownItem,
+  DualListSelector,
+  KebabToggle
+} from '@patternfly/react-core';
+import PficonSortCommonAscIcon from '@patternfly/react-icons/dist/esm/icons/pficon-sort-common-asc-icon';
+
+export const DualListSelectorComplexOptionsActions: React.FunctionComponent = () => {
+  const [availableOptions, setAvailableOptions] = React.useState<React.ReactNode[]>([
+    <span key="option1">Option 1</span>,
+    <span key="option3">Option 3</span>,
+    <span key="option4">Option 4</span>,
+    <span key="option2">Option 2</span>
+  ]);
+  const [chosenOptions, setChosenOptions] = React.useState<React.ReactNode[]>([]);
+  const [isAvailableKebabOpen, setIsAvailableKebabOpen] = React.useState(false);
+  const [isChosenKebabOpen, setIsChosenKebabOpen] = React.useState(false);
+  const [isDisabled, setIsDisabled] = React.useState(false);
+
+  const onListChange = (newAvailableOptions: React.ReactNode[], newChosenOptions: React.ReactNode[]) => {
+    setAvailableOptions(newAvailableOptions);
+    setChosenOptions(newChosenOptions);
+  };
+
+  const onSort = (pane: string) => {
+    const toSort = pane === 'available' ? [...availableOptions] : [...chosenOptions];
+    (toSort as React.ReactElement[]).sort((a, b) => {
+      if (a.props.children > b.props.children) {
+        return 1;
+      }
+      if (a.props.children < b.props.children) {
+        return -1;
+      }
+      return 0;
+    });
+
+    if (pane === 'available') {
+      setAvailableOptions(toSort);
+    } else {
+      setChosenOptions(toSort);
+    }
+  };
+
+  const onToggle = (isOpen: boolean, pane: string) => {
+    if (pane === 'available') {
+      setIsAvailableKebabOpen(isOpen);
+    } else {
+      setIsChosenKebabOpen(isOpen);
+    }
+  };
+
+  const filterOption = (option: React.ReactNode, input: string) =>
+    (option as React.ReactElement).props.children.includes(input);
+
+  const dropdownItems = [
+    <DropdownItem key="link">Link</DropdownItem>,
+    <DropdownItem key="action" component="button">
+      Action
+    </DropdownItem>,
+    <DropdownItem key="secondAction" component="button">
+      Second Action
+    </DropdownItem>
+  ];
+
+  const availableOptionsActions = [
+    <Button
+      variant={ButtonVariant.plain}
+      onClick={() => onSort('available')}
+      aria-label="Sort available options"
+      key="availableSortButton"
+      isDisabled={isDisabled}
+    >
+      <PficonSortCommonAscIcon />
+    </Button>,
+    <Dropdown
+      toggle={
+        <KebabToggle
+          isDisabled={isDisabled}
+          onToggle={isOpen => onToggle(isOpen, 'available')}
+          id="complex-available-toggle"
+        />
+      }
+      isOpen={isAvailableKebabOpen}
+      isPlain
+      dropdownItems={dropdownItems}
+      key="availableDropdown"
+    />
+  ];
+
+  const chosenOptionsActions = [
+    <Button
+      variant={ButtonVariant.plain}
+      onClick={() => onSort('chosen')}
+      aria-label="Sort chosen options"
+      key="chosenSortButton"
+      isDisabled={isDisabled}
+    >
+      <PficonSortCommonAscIcon />
+    </Button>,
+    <Dropdown
+      toggle={
+        <KebabToggle
+          isDisabled={isDisabled}
+          onToggle={isOpen => onToggle(isOpen, 'chosen')}
+          id="complex-chosen-toggle"
+        />
+      }
+      isOpen={isChosenKebabOpen}
+      isPlain
+      dropdownItems={dropdownItems}
+      key="chosenDropdown"
+    />
+  ];
+
+  return (
+    <React.Fragment>
+      <DualListSelector
+        isSearchable
+        availableOptions={availableOptions}
+        availableOptionsActions={availableOptionsActions}
+        chosenOptions={chosenOptions}
+        chosenOptionsActions={chosenOptionsActions}
+        addAll={onListChange}
+        removeAll={onListChange}
+        addSelected={onListChange}
+        removeSelected={onListChange}
+        filterOption={filterOption}
+        isDisabled={isDisabled}
+        id="dual-list-selector-complex"
+      />
+      <Checkbox
+        key="isDisabled"
+        id="isDisabled"
+        label="isDisabled"
+        aria-label="isDisabled"
+        isChecked={isDisabled}
+        onChange={() => setIsDisabled(!isDisabled)}
+      />
+    </React.Fragment>
+  );
+};

package/src/components/DualListSelector/examples/DualListSelectorComposable.tsx

@@ -0,0 +1,214 @@
+import React from 'react';
+import {
+  Button,
+  ButtonVariant,
+  DualListSelector,
+  DualListSelectorPane,
+  DualListSelectorList,
+  DualListSelectorListItem,
+  DualListSelectorControlsWrapper,
+  DualListSelectorControl,
+  SearchInput
+} from '@patternfly/react-core';
+import AngleDoubleLeftIcon from '@patternfly/react-icons/dist/esm/icons/angle-double-left-icon';
+import AngleLeftIcon from '@patternfly/react-icons/dist/esm/icons/angle-left-icon';
+import AngleDoubleRightIcon from '@patternfly/react-icons/dist/esm/icons/angle-double-right-icon';
+import AngleRightIcon from '@patternfly/react-icons/dist/esm/icons/angle-right-icon';
+import PficonSortCommonAscIcon from '@patternfly/react-icons/dist/esm/icons/pficon-sort-common-asc-icon';
+
+export const DualListSelectorComposable: React.FunctionComponent = () => {
+  const [availableOptions, setAvailableOptions] = React.useState([
+    { text: 'Apple', selected: false, isVisible: true },
+    { text: 'Banana', selected: false, isVisible: true },
+    { text: 'Pineapple', selected: false, isVisible: true },
+    { text: 'Orange', selected: false, isVisible: true },
+    { text: 'Grape', selected: false, isVisible: true },
+    { text: 'Peach', selected: false, isVisible: true },
+    { text: 'Strawberry', selected: false, isVisible: true }
+  ]);
+  const [chosenOptions, setChosenOptions] = React.useState([]);
+  const [availableFilter, setAvailableFilter] = React.useState('');
+  const [chosenFilter, setChosenFilter] = React.useState('');
+
+  // callback for moving selected options between lists
+  const moveSelected = (fromAvailable: boolean) => {
+    const sourceOptions = fromAvailable ? availableOptions : chosenOptions;
+    const destinationOptions = fromAvailable ? chosenOptions : availableOptions;
+    for (let i = 0; i < sourceOptions.length; i++) {
+      const option = sourceOptions[i];
+      if (option.selected && option.isVisible) {
+        sourceOptions.splice(i, 1);
+        destinationOptions.push(option);
+        option.selected = false;
+        i--;
+      }
+    }
+    if (fromAvailable) {
+      setAvailableOptions([...sourceOptions]);
+      setChosenOptions([...destinationOptions]);
+    } else {
+      setChosenOptions([...sourceOptions]);
+      setAvailableOptions([...destinationOptions]);
+    }
+  };
+
+  // callback for moving all options between lists
+  const moveAll = (fromAvailable: boolean) => {
+    if (fromAvailable) {
+      setChosenOptions([...availableOptions.filter(option => option.isVisible), ...chosenOptions]);
+      setAvailableOptions([...availableOptions.filter(option => !option.isVisible)]);
+    } else {
+      setAvailableOptions([...chosenOptions.filter(option => option.isVisible), ...availableOptions]);
+      setChosenOptions([...chosenOptions.filter(option => !option.isVisible)]);
+    }
+  };
+
+  // callback when option is selected
+  const onOptionSelect = (
+    event: React.MouseEvent | React.ChangeEvent | React.KeyboardEvent,
+    index: number,
+    isChosen: boolean
+  ) => {
+    if (isChosen) {
+      const newChosen = [...chosenOptions];
+      newChosen[index].selected = !chosenOptions[index].selected;
+      setChosenOptions(newChosen);
+    } else {
+      const newAvailable = [...availableOptions];
+      newAvailable[index].selected = !availableOptions[index].selected;
+      setAvailableOptions(newAvailable);
+    }
+  };
+
+  // builds a search input - used in each dual list selector pane
+  const buildSearchInput = (isAvailable: boolean) => {
+    const onChange = (value: string) => {
+      isAvailable ? setAvailableFilter(value) : setChosenFilter(value);
+      const toFilter = isAvailable ? [...availableOptions] : [...chosenOptions];
+      toFilter.forEach(option => {
+        option.isVisible = value === '' || option.text.toLowerCase().includes(value.toLowerCase());
+      });
+    };
+
+    return (
+      <SearchInput
+        value={isAvailable ? availableFilter : chosenFilter}
+        onChange={onChange}
+        onClear={() => onChange('')}
+      />
+    );
+  };
+
+  // builds a sort control - passed to both dual list selector panes
+  const buildSort = (isAvailable: boolean) => {
+    const onSort = () => {
+      const toSort = isAvailable ? [...availableOptions] : [...chosenOptions];
+      toSort.sort((a, b) => {
+        if (a.text > b.text) {
+          return 1;
+        }
+        if (a.text < b.text) {
+          return -1;
+        }
+        return 0;
+      });
+      if (isAvailable) {
+        setAvailableOptions(toSort);
+      } else {
+        setChosenOptions(toSort);
+      }
+    };
+
+    return (
+      <Button variant={ButtonVariant.plain} onClick={onSort} aria-label="Sort" key="sortButton">
+        <PficonSortCommonAscIcon />
+      </Button>
+    );
+  };
+
+  return (
+    <DualListSelector>
+      <DualListSelectorPane
+        title="Available"
+        status={`${availableOptions.filter(option => option.selected && option.isVisible).length} of ${
+          availableOptions.filter(option => option.isVisible).length
+        } options selected`}
+        searchInput={buildSearchInput(true)}
+        actions={[buildSort(true)]}
+      >
+        <DualListSelectorList>
+          {availableOptions.map((option, index) =>
+            option.isVisible ? (
+              <DualListSelectorListItem
+                key={index}
+                isSelected={option.selected}
+                id={`composable-available-option-${index}`}
+                onOptionSelect={e => onOptionSelect(e, index, false)}
+              >
+                {option.text}
+              </DualListSelectorListItem>
+            ) : null
+          )}
+        </DualListSelectorList>
+      </DualListSelectorPane>
+      <DualListSelectorControlsWrapper aria-label="Selector controls">
+        <DualListSelectorControl
+          isDisabled={!availableOptions.some(option => option.selected)}
+          onClick={() => moveSelected(true)}
+          aria-label="Add selected"
+          tooltipContent="Add selected"
+        >
+          <AngleRightIcon />
+        </DualListSelectorControl>
+        <DualListSelectorControl
+          isDisabled={availableOptions.length === 0}
+          onClick={() => moveAll(true)}
+          aria-label="Add all"
+          tooltipContent="Add all"
+        >
+          <AngleDoubleRightIcon />
+        </DualListSelectorControl>
+        <DualListSelectorControl
+          isDisabled={chosenOptions.length === 0}
+          onClick={() => moveAll(false)}
+          aria-label="Remove all"
+          tooltipContent="Remove all"
+        >
+          <AngleDoubleLeftIcon />
+        </DualListSelectorControl>
+        <DualListSelectorControl
+          onClick={() => moveSelected(false)}
+          isDisabled={!chosenOptions.some(option => option.selected)}
+          aria-label="Remove selected"
+          tooltipContent="Remove selected"
+        >
+          <AngleLeftIcon />
+        </DualListSelectorControl>
+      </DualListSelectorControlsWrapper>
+      <DualListSelectorPane
+        title="Chosen"
+        status={`${chosenOptions.filter(option => option.selected && option.isVisible).length} of ${
+          chosenOptions.filter(option => option.isVisible).length
+        } options selected`}
+        searchInput={buildSearchInput(false)}
+        actions={[buildSort(false)]}
+        isChosen
+      >
+        <DualListSelectorList>
+          {chosenOptions.map((option, index) =>
+            option.isVisible ? (
+              <DualListSelectorListItem
+                key={index}
+                isSelected={option.selected}
+                id={`composable-chosen-option-${index}`}
+                onOptionSelect={e => onOptionSelect(e, index, true)}
+              >
+                {option.text}
+              </DualListSelectorListItem>
+            ) : null
+          )}
+        </DualListSelectorList>
+      </DualListSelectorPane>
+    </DualListSelector>
+  );
+};

package/src/components/DualListSelector/examples/DualListSelectorComposableDragDrop.tsx

@@ -0,0 +1,190 @@
+import React from 'react';
+import {
+  DragDrop,
+  Droppable,
+  Draggable,
+  DualListSelector,
+  DualListSelectorPane,
+  DualListSelectorList,
+  DualListSelectorListItem,
+  DualListSelectorControlsWrapper,
+  DualListSelectorControl
+} from '@patternfly/react-core';
+import AngleDoubleLeftIcon from '@patternfly/react-icons/dist/esm/icons/angle-double-left-icon';
+import AngleLeftIcon from '@patternfly/react-icons/dist/esm/icons/angle-left-icon';
+import AngleDoubleRightIcon from '@patternfly/react-icons/dist/esm/icons/angle-double-right-icon';
+import AngleRightIcon from '@patternfly/react-icons/dist/esm/icons/angle-right-icon';
+
+interface SourceType {
+  droppableId: string;
+  index: number;
+}
+
+interface DestinationType extends SourceType {}
+
+export const DualListSelectorComposableDragDrop: React.FunctionComponent = () => {
+  const [ignoreNextOptionSelect, setIgnoreNextOptionSelect] = React.useState(false);
+  const [availableOptions, setAvailableOptions] = React.useState([
+    { text: 'Apple', selected: false, isVisible: true },
+    { text: 'Banana', selected: false, isVisible: true },
+    { text: 'Pineapple', selected: false, isVisible: true }
+  ]);
+  const [chosenOptions, setChosenOptions] = React.useState([
+    { text: 'Orange', selected: false, isVisible: true },
+    { text: 'Grape', selected: false, isVisible: true },
+    { text: 'Peach', selected: false, isVisible: true },
+    { text: 'Strawberry', selected: false, isVisible: true }
+  ]);
+
+  const moveSelected = (fromAvailable: boolean) => {
+    const sourceOptions = fromAvailable ? availableOptions : chosenOptions;
+    const destinationOptions = fromAvailable ? chosenOptions : availableOptions;
+    for (let i = 0; i < sourceOptions.length; i++) {
+      const option = sourceOptions[i];
+      if (option.selected && option.isVisible) {
+        sourceOptions.splice(i, 1);
+        destinationOptions.push(option);
+        option.selected = false;
+        i--;
+      }
+    }
+    if (fromAvailable) {
+      setAvailableOptions([...sourceOptions]);
+      setChosenOptions([...destinationOptions]);
+    } else {
+      setChosenOptions([...sourceOptions]);
+      setAvailableOptions([...destinationOptions]);
+    }
+  };
+
+  const moveAll = (fromAvailable: boolean) => {
+    if (fromAvailable) {
+      setChosenOptions([...availableOptions.filter(option => option.isVisible), ...chosenOptions]);
+      setAvailableOptions([...availableOptions.filter(option => !option.isVisible)]);
+    } else {
+      setAvailableOptions([...chosenOptions.filter(option => option.isVisible), ...availableOptions]);
+      setChosenOptions([...chosenOptions.filter(option => !option.isVisible)]);
+    }
+  };
+
+  const onOptionSelect = (
+    event: React.MouseEvent | React.ChangeEvent | React.KeyboardEvent,
+    index: number,
+    isChosen: boolean
+  ) => {
+    if (ignoreNextOptionSelect) {
+      setIgnoreNextOptionSelect(false);
+      return;
+    }
+    if (isChosen) {
+      const newChosen = [...chosenOptions];
+      newChosen[index].selected = !chosenOptions[index].selected;
+      setChosenOptions(newChosen);
+    } else {
+      const newAvailable = [...availableOptions];
+      newAvailable[index].selected = !availableOptions[index].selected;
+      setAvailableOptions(newAvailable);
+    }
+  };
+
+  const onDrop = (source: SourceType, dest: DestinationType) => {
+    if (dest) {
+      const newList = [...chosenOptions];
+      const [removed] = newList.splice(source.index, 1);
+      newList.splice(dest.index, 0, removed);
+      setChosenOptions(newList);
+      return true;
+    }
+    return false;
+  };
+
+  return (
+    <DualListSelector>
+      <DualListSelectorPane
+        title="Available"
+        status={`${availableOptions.filter(option => option.selected && option.isVisible).length} of ${
+          availableOptions.filter(option => option.isVisible).length
+        } options selected`}
+      >
+        <DualListSelectorList>
+          {availableOptions.map((option, index) =>
+            option.isVisible ? (
+              <DualListSelectorListItem
+                key={index}
+                isSelected={option.selected}
+                id={`composable-drag-drop-available-option-${index}`}
+                onOptionSelect={e => onOptionSelect(e, index, false)}
+              >
+                {option.text}
+              </DualListSelectorListItem>
+            ) : null
+          )}
+        </DualListSelectorList>
+      </DualListSelectorPane>
+      <DualListSelectorControlsWrapper aria-label="Selector controls">
+        <DualListSelectorControl
+          isDisabled={!availableOptions.some(option => option.selected)}
+          onClick={() => moveSelected(true)}
+          aria-label="Add selected"
+        >
+          <AngleRightIcon />
+        </DualListSelectorControl>
+        <DualListSelectorControl
+          isDisabled={availableOptions.length === 0}
+          onClick={() => moveAll(true)}
+          aria-label="Add all"
+        >
+          <AngleDoubleRightIcon />
+        </DualListSelectorControl>
+        <DualListSelectorControl
+          isDisabled={chosenOptions.length === 0}
+          onClick={() => moveAll(false)}
+          aria-label="Remove all"
+        >
+          <AngleDoubleLeftIcon />
+        </DualListSelectorControl>
+        <DualListSelectorControl
+          onClick={() => moveSelected(false)}
+          isDisabled={!chosenOptions.some(option => option.selected)}
+          aria-label="Remove selected"
+        >
+          <AngleLeftIcon />
+        </DualListSelectorControl>
+      </DualListSelectorControlsWrapper>
+      <DragDrop
+        onDrag={() => {
+          setIgnoreNextOptionSelect(true);
+          return true;
+        }}
+        onDrop={onDrop}
+      >
+        <DualListSelectorPane
+          title="Chosen"
+          status={`${chosenOptions.filter(option => option.selected && option.isVisible).length} of ${
+            chosenOptions.filter(option => option.isVisible).length
+          } options selected`}
+          isChosen
+        >
+          <Droppable hasNoWrapper>
+            <DualListSelectorList>
+              {chosenOptions.map((option, index) =>
+                option.isVisible ? (
+                  <Draggable key={index} hasNoWrapper>
+                    <DualListSelectorListItem
+                      isSelected={option.selected}
+                      id={`composable-drag-drop-chosen-option-${index}`}
+                      onOptionSelect={e => onOptionSelect(e, index, true)}
+                      isDraggable
+                    >
+                      {option.text}
+                    </DualListSelectorListItem>
+                  </Draggable>
+                ) : null
+              )}
+            </DualListSelectorList>
+          </Droppable>
+        </DualListSelectorPane>
+      </DragDrop>
+    </DualListSelector>
+  );
+};

package/src/components/DualListSelector/examples/{ComposableTree.tsx → DualListSelectorComposableTree.tsx}

@@ -24,7 +24,7 @@ interface ExampleProps {
   data: FoodNode[];
 }
 
-export const ComposableDualListSelectorTree: React.FunctionComponent<ExampleProps> = ({ data }: ExampleProps) => {
+export const DualListSelectorComposableTree: React.FunctionComponent<ExampleProps> = ({ data }: ExampleProps) => {
   const [checkedLeafIds, setCheckedLeafIds] = React.useState<string[]>([]);
   const [chosenLeafIds, setChosenLeafIds] = React.useState<string[]>(['beans', 'beef', 'chicken', 'tofu']);
   const [chosenFilter, setChosenFilter] = React.useState<string>('');
@@ -290,8 +290,8 @@ export const ComposableDualListSelectorTree: React.FunctionComponent<ExampleProp
   );
 };
 
-export const ComposableDualListSelectorTreeExample: React.FunctionComponent = () => (
-  <ComposableDualListSelectorTree
+export const DualListSelectorComposableTreeExample: React.FunctionComponent = () => (
+  <DualListSelectorComposableTree
     data={[
       {
         id: 'fruits',