Files
RoboCommander/node_modules/react-bootstrap/es/Dropdown.js
2026-04-05 16:14:49 -04:00

361 lines
11 KiB
JavaScript

import _extends from "@babel/runtime-corejs2/helpers/esm/extends";
import _objectWithoutPropertiesLoose from "@babel/runtime-corejs2/helpers/esm/objectWithoutPropertiesLoose";
import _inheritsLoose from "@babel/runtime-corejs2/helpers/esm/inheritsLoose";
import _assertThisInitialized from "@babel/runtime-corejs2/helpers/esm/assertThisInitialized";
import classNames from 'classnames';
import activeElement from 'dom-helpers/activeElement';
import contains from 'dom-helpers/query/contains';
import keycode from 'keycode';
import React, { cloneElement } from 'react';
import PropTypes from 'prop-types';
import ReactDOM from 'react-dom';
import all from 'prop-types-extra/lib/all';
import elementType from 'prop-types-extra/lib/elementType';
import isRequiredForA11y from 'prop-types-extra/lib/isRequiredForA11y';
import uncontrollable from 'uncontrollable';
import warning from 'warning';
import ButtonGroup from './ButtonGroup';
import DropdownMenu from './DropdownMenu';
import DropdownToggle from './DropdownToggle';
import { bsClass as setBsClass, prefix } from './utils/bootstrapUtils';
import createChainedFunction from './utils/createChainedFunction';
import { exclusiveRoles, requiredRoles } from './utils/PropTypes';
import ValidComponentChildren from './utils/ValidComponentChildren';
var TOGGLE_ROLE = DropdownToggle.defaultProps.bsRole;
var MENU_ROLE = DropdownMenu.defaultProps.bsRole;
var propTypes = {
/**
* The menu will open above the dropdown button, instead of below it.
*/
dropup: PropTypes.bool,
/**
* An html id attribute, necessary for assistive technologies, such as screen readers.
* @type {string|number}
* @required
*/
id: isRequiredForA11y(PropTypes.oneOfType([PropTypes.string, PropTypes.number])),
componentClass: elementType,
/**
* The children of a Dropdown may be a `<Dropdown.Toggle>` or a `<Dropdown.Menu>`.
* @type {node}
*/
children: all(requiredRoles(TOGGLE_ROLE, MENU_ROLE), exclusiveRoles(MENU_ROLE)),
/**
* Whether or not component is disabled.
*/
disabled: PropTypes.bool,
/**
* Align the menu to the right side of the Dropdown toggle
*/
pullRight: PropTypes.bool,
/**
* Whether or not the Dropdown is visible.
*
* @controllable onToggle
*/
open: PropTypes.bool,
defaultOpen: PropTypes.bool,
/**
* A callback fired when the Dropdown wishes to change visibility. Called with the requested
* `open` value, the DOM event, and the source that fired it: `'click'`,`'keydown'`,`'rootClose'`, or `'select'`.
*
* ```js
* function(Boolean isOpen, Object event, { String source }) {}
* ```
* @controllable open
*/
onToggle: PropTypes.func,
/**
* A callback fired when a menu item is selected.
*
* ```js
* (eventKey: any, event: Object) => any
* ```
*/
onSelect: PropTypes.func,
/**
* If `'menuitem'`, causes the dropdown to behave like a menu item rather than
* a menu button.
*/
role: PropTypes.string,
/**
* Which event when fired outside the component will cause it to be closed
*
* *Note: For custom dropdown components, you will have to pass the
* `rootCloseEvent` to `<RootCloseWrapper>` in your custom dropdown menu
* component ([similarly to how it is implemented in `<Dropdown.Menu>`](https://github.com/react-bootstrap/react-bootstrap/blob/v0.31.5/src/DropdownMenu.js#L115-L119)).*
*/
rootCloseEvent: PropTypes.oneOf(['click', 'mousedown']),
/**
* @private
*/
onMouseEnter: PropTypes.func,
/**
* @private
*/
onMouseLeave: PropTypes.func
};
var defaultProps = {
componentClass: ButtonGroup
};
var Dropdown =
/*#__PURE__*/
function (_React$Component) {
_inheritsLoose(Dropdown, _React$Component);
function Dropdown(props, context) {
var _this;
_this = _React$Component.call(this, props, context) || this;
_this.handleClick = _this.handleClick.bind(_assertThisInitialized(_assertThisInitialized(_this)));
_this.handleKeyDown = _this.handleKeyDown.bind(_assertThisInitialized(_assertThisInitialized(_this)));
_this.handleClose = _this.handleClose.bind(_assertThisInitialized(_assertThisInitialized(_this)));
_this._focusInDropdown = false;
_this.lastOpenEventType = null;
return _this;
}
var _proto = Dropdown.prototype;
_proto.componentDidMount = function componentDidMount() {
this.focusNextOnOpen();
};
_proto.componentWillUpdate = function componentWillUpdate(nextProps) {
if (!nextProps.open && this.props.open) {
this._focusInDropdown = contains(ReactDOM.findDOMNode(this.menu), activeElement(document));
}
};
_proto.componentDidUpdate = function componentDidUpdate(prevProps) {
var open = this.props.open;
var prevOpen = prevProps.open;
if (open && !prevOpen) {
this.focusNextOnOpen();
}
if (!open && prevOpen) {
// if focus hasn't already moved from the menu let's return it
// to the toggle
if (this._focusInDropdown) {
this._focusInDropdown = false;
this.focus();
}
}
};
_proto.focus = function focus() {
var toggle = ReactDOM.findDOMNode(this.toggle);
if (toggle && toggle.focus) {
toggle.focus();
}
};
_proto.focusNextOnOpen = function focusNextOnOpen() {
var menu = this.menu;
if (!menu || !menu.focusNext) {
return;
}
if (this.lastOpenEventType === 'keydown' || this.props.role === 'menuitem') {
menu.focusNext();
}
};
_proto.handleClick = function handleClick(event) {
if (this.props.disabled) {
return;
}
this.toggleOpen(event, {
source: 'click'
});
};
_proto.handleClose = function handleClose(event, eventDetails) {
if (!this.props.open) {
return;
}
this.toggleOpen(event, eventDetails);
};
_proto.handleKeyDown = function handleKeyDown(event) {
if (this.props.disabled) {
return;
}
switch (event.keyCode) {
case keycode.codes.down:
if (!this.props.open) {
this.toggleOpen(event, {
source: 'keydown'
});
} else if (this.menu.focusNext) {
this.menu.focusNext();
}
event.preventDefault();
break;
case keycode.codes.esc:
case keycode.codes.tab:
this.handleClose(event, {
source: 'keydown'
});
break;
default:
}
};
_proto.toggleOpen = function toggleOpen(event, eventDetails) {
var open = !this.props.open;
if (open) {
this.lastOpenEventType = eventDetails.source;
}
if (this.props.onToggle) {
this.props.onToggle(open, event, eventDetails);
}
};
_proto.renderMenu = function renderMenu(child, _ref) {
var _this2 = this;
var id = _ref.id,
onSelect = _ref.onSelect,
rootCloseEvent = _ref.rootCloseEvent,
props = _objectWithoutPropertiesLoose(_ref, ["id", "onSelect", "rootCloseEvent"]);
var ref = function ref(c) {
_this2.menu = c;
};
if (typeof child.ref === 'string') {
process.env.NODE_ENV !== "production" ? warning(false, 'String refs are not supported on `<Dropdown.Menu>` components. ' + 'To apply a ref to the component use the callback signature:\n\n ' + 'https://facebook.github.io/react/docs/more-about-refs.html#the-ref-callback-attribute') : void 0;
} else {
ref = createChainedFunction(child.ref, ref);
}
return cloneElement(child, _extends({}, props, {
ref: ref,
labelledBy: id,
bsClass: prefix(props, 'menu'),
onClose: createChainedFunction(child.props.onClose, this.handleClose),
onSelect: createChainedFunction(child.props.onSelect, onSelect, function (key, event) {
return _this2.handleClose(event, {
source: 'select'
});
}),
rootCloseEvent: rootCloseEvent
}));
};
_proto.renderToggle = function renderToggle(child, props) {
var _this3 = this;
var ref = function ref(c) {
_this3.toggle = c;
};
if (typeof child.ref === 'string') {
process.env.NODE_ENV !== "production" ? warning(false, 'String refs are not supported on `<Dropdown.Toggle>` components. ' + 'To apply a ref to the component use the callback signature:\n\n ' + 'https://facebook.github.io/react/docs/more-about-refs.html#the-ref-callback-attribute') : void 0;
} else {
ref = createChainedFunction(child.ref, ref);
}
return cloneElement(child, _extends({}, props, {
ref: ref,
bsClass: prefix(props, 'toggle'),
onClick: createChainedFunction(child.props.onClick, this.handleClick),
onKeyDown: createChainedFunction(child.props.onKeyDown, this.handleKeyDown)
}));
};
_proto.render = function render() {
var _classes,
_this4 = this;
var _this$props = this.props,
Component = _this$props.componentClass,
id = _this$props.id,
dropup = _this$props.dropup,
disabled = _this$props.disabled,
pullRight = _this$props.pullRight,
open = _this$props.open,
onSelect = _this$props.onSelect,
role = _this$props.role,
bsClass = _this$props.bsClass,
className = _this$props.className,
rootCloseEvent = _this$props.rootCloseEvent,
children = _this$props.children,
props = _objectWithoutPropertiesLoose(_this$props, ["componentClass", "id", "dropup", "disabled", "pullRight", "open", "onSelect", "role", "bsClass", "className", "rootCloseEvent", "children"]);
delete props.onToggle;
var classes = (_classes = {}, _classes[bsClass] = true, _classes.open = open, _classes.disabled = disabled, _classes);
if (dropup) {
classes[bsClass] = false;
classes.dropup = true;
} // This intentionally forwards bsSize and bsStyle (if set) to the
// underlying component, to allow it to render size and style variants.
return React.createElement(Component, _extends({}, props, {
className: classNames(className, classes)
}), ValidComponentChildren.map(children, function (child) {
switch (child.props.bsRole) {
case TOGGLE_ROLE:
return _this4.renderToggle(child, {
id: id,
disabled: disabled,
open: open,
role: role,
bsClass: bsClass
});
case MENU_ROLE:
return _this4.renderMenu(child, {
id: id,
open: open,
pullRight: pullRight,
bsClass: bsClass,
onSelect: onSelect,
rootCloseEvent: rootCloseEvent
});
default:
return child;
}
}));
};
return Dropdown;
}(React.Component);
Dropdown.propTypes = propTypes;
Dropdown.defaultProps = defaultProps;
setBsClass('dropdown', Dropdown);
var UncontrolledDropdown = uncontrollable(Dropdown, {
open: 'onToggle'
});
UncontrolledDropdown.Toggle = DropdownToggle;
UncontrolledDropdown.Menu = DropdownMenu;
export default UncontrolledDropdown;