import * as React from 'react'; import styles from '@patternfly/react-styles/css/components/Select/select'; import buttonStyles from '@patternfly/react-styles/css/components/Button/button'; import { css } from '@patternfly/react-styles'; import CaretDownIcon from '@patternfly/react-icons/dist/esm/icons/caret-down-icon'; import { SelectVariant, SelectFooterTabbableItems } from './selectConstants'; import { PickOptional } from '../../../helpers/typeUtils'; import { findTabbableElements } from '../../../helpers/util'; import { KeyTypes } from '../../../helpers/constants'; export interface SelectToggleProps extends Omit, 'ref'> { /** HTML ID of dropdown toggle */ id: string; /** Anything which can be rendered as dropdown toggle */ children: React.ReactNode; /** Classes applied to root element of dropdown toggle */ className?: string; /** Flag to indicate if select is open */ isOpen?: boolean; /** Callback called when toggle is clicked */ onToggle?: (event: React.MouseEvent | React.ChangeEvent | React.KeyboardEvent | Event, isExpanded: boolean) => void; /** Callback for toggle open on keyboard entry */ onEnter?: () => void; /** Callback for toggle close */ onClose?: () => void; /** Callback for toggle blur */ onBlur?: (event?: any) => void; /** @hide Internal callback for toggle keyboard navigation */ handleTypeaheadKeys?: (position: string, shiftKey?: boolean) => void; /** @hide Internal callback to move focus to last menu item */ moveFocusToLastMenuItem?: () => void; /** Element which wraps toggle */ parentRef: React.RefObject; /** Custom icon for the dropdown replacing the CaretDownIcon */ toggleIndicator?: React.ReactElement; /** The menu element */ menuRef?: React.RefObject; /** The menu footer element */ footerRef?: React.RefObject; /** Forces active state */ isActive?: boolean; /** Display the toggle with no border or background */ isPlain?: boolean; /** Flag indicating if select is disabled */ isDisabled?: boolean; /** Flag indicating if placeholder styles should be applied */ hasPlaceholderStyle?: boolean; /** Type of the toggle button, defaults to 'button' */ type?: 'reset' | 'button' | 'submit' | undefined; /** Id of label for the Select aria-labelledby */ 'aria-labelledby'?: string; /** Label for toggle of select variants */ 'aria-label'?: string; /** Flag for variant, determines toggle rules and interaction */ variant?: 'single' | 'checkbox' | 'typeahead' | 'typeaheadmulti'; /** Flag indicating if select toggle has an clear button */ hasClearButton?: boolean; /** Flag indicating if select menu has a footer */ hasFooter?: boolean; /** @hide Internal callback for handling focus when typeahead toggle button clicked. */ onClickTypeaheadToggleButton?: () => void; /** @hide Internal ref for the select toggle */ innerRef?: React.Ref; } class SelectToggleBase extends React.Component { static displayName = 'SelectToggle'; private toggle: React.RefObject | React.RefObject; static defaultProps: PickOptional = { className: '', isOpen: false, isActive: false, isPlain: false, isDisabled: false, hasPlaceholderStyle: false, hasClearButton: false, hasFooter: false, variant: 'single', 'aria-labelledby': '', 'aria-label': '', type: 'button', onToggle: () => {}, onEnter: () => {}, onClose: () => {}, onClickTypeaheadToggleButton: () => {} }; constructor(props: SelectToggleProps) { super(props); const { variant } = props; const isTypeahead = variant === SelectVariant.typeahead || variant === SelectVariant.typeaheadMulti; if (this.props.innerRef) { this.toggle = this.props.innerRef as React.RefObject | React.RefObject; } else { this.toggle = isTypeahead ? React.createRef() : React.createRef(); } } componentDidMount() { document.addEventListener('click', this.onDocClick, { capture: true }); document.addEventListener('touchstart', this.onDocClick); document.addEventListener('keydown', this.handleGlobalKeys); } componentWillUnmount() { document.removeEventListener('click', this.onDocClick, { capture: true }); document.removeEventListener('touchstart', this.onDocClick); document.removeEventListener('keydown', this.handleGlobalKeys); } onDocClick = (event: Event) => { const { parentRef, menuRef, footerRef, isOpen, onToggle, onClose } = this.props; const clickedOnToggle = parentRef && parentRef.current && parentRef.current.contains(event.target as Node); const clickedWithinMenu = menuRef && menuRef.current && menuRef.current.contains && menuRef.current.contains(event.target as Node); const clickedWithinFooter = footerRef && footerRef.current && footerRef.current.contains && footerRef.current.contains(event.target as Node); if (isOpen && !(clickedOnToggle || clickedWithinMenu || clickedWithinFooter)) { onToggle(event, false); onClose(); } }; handleGlobalKeys = (event: KeyboardEvent) => { const { parentRef, menuRef, hasFooter, footerRef, isOpen, variant, onToggle, onClose, moveFocusToLastMenuItem } = this.props; const escFromToggle = parentRef && parentRef.current && parentRef.current.contains(event.target as Node); const escFromWithinMenu = menuRef && menuRef.current && menuRef.current.contains && menuRef.current.contains(event.target as Node); if ( isOpen && event.key === KeyTypes.Tab && (variant === SelectVariant.typeahead || variant === SelectVariant.typeaheadMulti) ) { this.props.handleTypeaheadKeys('tab', event.shiftKey); event.preventDefault(); return; } if (isOpen && event.key === KeyTypes.Tab && hasFooter) { const tabbableItems = findTabbableElements(footerRef, SelectFooterTabbableItems); // If no tabbable item in footer close select if (tabbableItems.length <= 0) { onToggle(event, false); onClose(); this.toggle.current.focus(); return; } else { // if current element is not in footer, tab to first tabbable element in footer, or close if shift clicked const currentElementIndex = tabbableItems.findIndex((item: any) => item === document.activeElement); if (currentElementIndex === -1) { if (event.shiftKey) { if (variant !== 'checkbox') { // only close non checkbox variation on shift clicked onToggle(event, false); onClose(); this.toggle.current.focus(); } } else { // tab to footer tabbableItems[0].focus(); return; } } // Current element is in footer. if (event.shiftKey) { // Move focus back to menu if current tab index is 0 if (currentElementIndex === 0) { moveFocusToLastMenuItem(); event.preventDefault(); } return; } // Tab to next element in footer or close if there are none if (currentElementIndex + 1 < tabbableItems.length) { tabbableItems[currentElementIndex + 1].focus(); } else { // no more footer items close menu onToggle(event, false); onClose(); this.toggle.current.focus(); } event.preventDefault(); return; } } if ( isOpen && (event.key === KeyTypes.Escape || event.key === KeyTypes.Tab) && (escFromToggle || escFromWithinMenu) ) { onToggle(event, false); onClose(); this.toggle.current.focus(); } }; onKeyDown = (event: React.KeyboardEvent) => { const { isOpen, onToggle, variant, onClose, onEnter, handleTypeaheadKeys } = this.props; if (variant === SelectVariant.typeahead || variant === SelectVariant.typeaheadMulti) { if (event.key === KeyTypes.ArrowDown || event.key === KeyTypes.ArrowUp) { handleTypeaheadKeys((event.key === KeyTypes.ArrowDown && 'down') || (event.key === KeyTypes.ArrowUp && 'up')); event.preventDefault(); } else if (event.key === KeyTypes.Enter) { if (isOpen) { handleTypeaheadKeys('enter'); } else { onToggle(event, !isOpen); } } } if ( variant === SelectVariant.typeahead || variant === SelectVariant.typeaheadMulti || (event.key === KeyTypes.Tab && !isOpen) || (event.key !== KeyTypes.Enter && event.key !== KeyTypes.Space) ) { return; } event.preventDefault(); if ((event.key === KeyTypes.Tab || event.key === KeyTypes.Enter || event.key === KeyTypes.Space) && isOpen) { onToggle(event, !isOpen); onClose(); this.toggle.current.focus(); } else if ((event.key === KeyTypes.Enter || event.key === KeyTypes.Space) && !isOpen) { onToggle(event, !isOpen); onEnter(); } }; render() { /* eslint-disable @typescript-eslint/no-unused-vars */ const { className, children, isOpen, isActive, isPlain, isDisabled, hasPlaceholderStyle, variant, onToggle, onEnter, onClose, onBlur, onClickTypeaheadToggleButton, handleTypeaheadKeys, moveFocusToLastMenuItem, parentRef, menuRef, id, type, hasClearButton, 'aria-labelledby': ariaLabelledBy, 'aria-label': ariaLabel, hasFooter, footerRef, toggleIndicator, innerRef, ...props } = this.props; /* eslint-enable @typescript-eslint/no-unused-vars */ const isTypeahead = variant === SelectVariant.typeahead || variant === SelectVariant.typeaheadMulti || hasClearButton; const toggleProps: { id: string; 'aria-labelledby': string; 'aria-expanded': boolean; 'aria-haspopup': 'listbox' | null; } = { id, 'aria-labelledby': ariaLabelledBy, 'aria-expanded': isOpen, 'aria-haspopup': (variant !== SelectVariant.checkbox && 'listbox') || null }; return ( {!isTypeahead && ( )} {isTypeahead && (
} className={css( styles.selectToggle, hasPlaceholderStyle && styles.modifiers.placeholder, isDisabled && styles.modifiers.disabled, isPlain && styles.modifiers.plain, isTypeahead && styles.modifiers.typeahead, className )} onBlur={onBlur} // eslint-disable-next-line @typescript-eslint/no-unused-vars onClick={(event) => { if (!isDisabled) { onToggle(event, !isOpen); if (isOpen) { onClose(); } } }} onKeyDown={this.onKeyDown} > {children}
)}
); } } export const SelectToggle = React.forwardRef((props: SelectToggleProps, ref: React.Ref) => ( ));