@salesforce/design-system-react
Version:
Salesforce Lightning Design System for React
106 lines (93 loc) • 3.76 kB
JavaScript
/* Copyright (c) 2015-present, salesforce.com, inc. All rights reserved */
/* Licensed under BSD 3-Clause - see LICENSE.txt or git.io/sfdc-license */
// Implements the [Button Group design pattern](https://lightningdesignsystem.com/components/button-groups/) in React.
// Based on SLDS v2.1.1
import React from 'react';
import PropTypes from 'prop-types';
import classNames from 'classnames';
import assign from 'lodash.assign';
import { BUTTON_GROUP } from '../../utilities/constants';
var propTypes = {
/**
* Children are expected to be components. If last button triggers a dropdown menu, use Dropdown instead of Button. _Tested with snapshot testing._
*/
children: PropTypes.node.isRequired,
/**
* CSS classes added to `slds-button-group` or `slds-checkbox_button-group` tag
*/
className: PropTypes.oneOfType([PropTypes.array, PropTypes.object, PropTypes.string]),
/**
* **Text labels for internationalization**
* This object is merged with the default props object on every render.
* * `error`: Message to display when any of Checkboxes are in an error state. _Tested with snapshot testing._
* * `label`: This label appears above the button group. _Tested with snapshot testing._
*/
labels: PropTypes.shape({
error: PropTypes.string,
label: PropTypes.string
}),
/**
* Use checkbox variant for "Checkbox Button Group" styling and add Checkbox components as children _Tested with snapshot testing._
*/
variant: PropTypes.oneOf(['checkbox', 'list'])
};
var defaultProps = {
labels: {}
};
/**
* The ButtonGroup component wraps other components (ie. Button, MenuDropdown, PopoverTooltip, Checkboxes, etc).
*/
var ButtonGroup = function ButtonGroup() {
var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
// Merge objects of strings with their default object
var labels = assign({}, defaultProps.labels, props.labels);
var zeroIndexLength = React.Children.count(props.children) - 1;
var children = props.children;
if (zeroIndexLength > 0) {
children = React.Children.map(props.children, function (child, index) {
var newChild;
if (index === zeroIndexLength) {
newChild = React.cloneElement(child, {
triggerClassName: 'slds-button_last'
});
}
return newChild || child;
});
}
if (props.variant === 'checkbox') {
children = React.Children.map(props.children, function (child) {
return React.cloneElement(child, {
variant: 'button-group'
});
});
return React.createElement("fieldset", {
className: classNames('slds-form-element', {
'slds-has-error': labels.error
})
}, React.createElement("legend", {
className: "slds-form-element__legend slds-form-element__label"
}, props.labels.label), React.createElement("div", {
className: "slds-form-element__control"
}, React.createElement("div", {
className: classNames('slds-checkbox_button-group', props.className)
}, children), labels.error ? React.createElement("div", {
className: "slds-form-element__help"
}, labels.error) : null));
}
if (props.variant === 'list') {
return React.createElement("ul", {
className: classNames('slds-button-group-list', props.className)
}, React.Children.map(props.children, function (child) {
return React.createElement("li", null, child);
}));
} // default
return React.createElement("div", {
className: classNames('slds-button-group', props.className),
role: "group"
}, children);
};
ButtonGroup.displayName = BUTTON_GROUP;
ButtonGroup.propTypes = propTypes;
ButtonGroup.defaultProps = defaultProps;
export default ButtonGroup;
//# sourceMappingURL=index.js.map