@wordpress/components
Version:
UI components for WordPress.
132 lines (121 loc) • 3.77 kB
JavaScript
import _extends from "@babel/runtime/helpers/esm/extends";
import { createElement, Fragment } from "@wordpress/element";
/**
* External dependencies
*/
import classnames from 'classnames';
import { isArray, uniqueId } from 'lodash';
/**
* WordPress dependencies
*/
import deprecated from '@wordpress/deprecated';
import { forwardRef } from '@wordpress/element';
/**
* Internal dependencies
*/
import Tooltip from '../tooltip';
import Icon from '../icon';
import VisuallyHidden from '../visually-hidden';
const disabledEventsOnDisabledButton = ['onMouseDown', 'onClick'];
export function Button(props, ref) {
const {
href,
target,
isPrimary,
isSmall,
isTertiary,
isPressed,
isBusy,
isDefault,
isSecondary,
isLink,
isDestructive,
className,
disabled,
icon,
iconPosition = 'left',
iconSize,
showTooltip,
tooltipPosition,
shortcut,
label,
children,
text,
__experimentalIsFocusable: isFocusable,
describedBy,
...additionalProps
} = props;
if (isDefault) {
deprecated('Button isDefault prop', {
since: '5.4',
alternative: 'isSecondary'
});
}
const classes = classnames('components-button', className, {
'is-secondary': isDefault || isSecondary,
'is-primary': isPrimary,
'is-small': isSmall,
'is-tertiary': isTertiary,
'is-pressed': isPressed,
'is-busy': isBusy,
'is-link': isLink,
'is-destructive': isDestructive,
'has-text': !!icon && !!children,
'has-icon': !!icon
});
const trulyDisabled = disabled && !isFocusable;
const Tag = href !== undefined && !trulyDisabled ? 'a' : 'button';
const tagProps = Tag === 'a' ? {
href,
target
} : {
type: 'button',
disabled: trulyDisabled,
'aria-pressed': isPressed
};
if (disabled && isFocusable) {
// In this case, the button will be disabled, but still focusable and
// perceivable by screen reader users.
tagProps['aria-disabled'] = true;
for (const disabledEvent of disabledEventsOnDisabledButton) {
additionalProps[disabledEvent] = event => {
event.stopPropagation();
event.preventDefault();
};
}
} // Should show the tooltip if...
const shouldShowTooltip = !trulyDisabled && ( // an explicit tooltip is passed or...
showTooltip && label || // there's a shortcut or...
shortcut || // there's a label and...
!!label && ( // the children are empty and...
!children || isArray(children) && !children.length) && // the tooltip is not explicitly disabled.
false !== showTooltip);
const descriptionId = describedBy ? uniqueId() : null;
const describedById = additionalProps['aria-describedby'] || descriptionId;
const element = createElement(Tag, _extends({}, tagProps, additionalProps, {
className: classes,
"aria-label": additionalProps['aria-label'] || label,
"aria-describedby": describedById,
ref: ref
}), icon && iconPosition === 'left' && createElement(Icon, {
icon: icon,
size: iconSize
}), text && createElement(Fragment, null, text), icon && iconPosition === 'right' && createElement(Icon, {
icon: icon,
size: iconSize
}), children);
if (!shouldShowTooltip) {
return createElement(Fragment, null, element, describedBy && createElement(VisuallyHidden, null, createElement("span", {
id: descriptionId
}, describedBy)));
}
return createElement(Fragment, null, createElement(Tooltip, {
text: describedBy ? describedBy : label,
shortcut: shortcut,
position: tooltipPosition
}, element), describedBy && createElement(VisuallyHidden, null, createElement("span", {
id: descriptionId
}, describedBy)));
}
export default forwardRef(Button);
//# sourceMappingURL=index.js.map