@carbon/react 0.16.2 → 1.0.0-rc.0

package/es/components/RadioButton/RadioButton.js

@@ -0,0 +1,172 @@
+/**
+ * Copyright IBM Corp. 2016, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { inherits as _inherits, createSuper as _createSuper, classCallCheck as _classCallCheck, defineProperty as _defineProperty, assertThisInitialized as _assertThisInitialized, createClass as _createClass, objectWithoutProperties as _objectWithoutProperties, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import cx from 'classnames';
+import PropTypes from 'prop-types';
+import React__default from 'react';
+import { warning } from '../../internal/warning.js';
+import uniqueId from '../../tools/uniqueId.js';
+import '../Text/index.js';
+import { PrefixContext } from '../../internal/usePrefix.js';
+import { Text } from '../Text/Text.js';
+
+var _excluded = ["className", "labelText", "labelPosition", "innerRef", "hideLabel"];
+
+var RadioButton = /*#__PURE__*/function (_React$Component) {
+  _inherits(RadioButton, _React$Component);
+
+  var _super = _createSuper(RadioButton);
+
+  function RadioButton() {
+    var _this;
+
+    _classCallCheck(this, RadioButton);
+
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+
+    _this = _super.call.apply(_super, [this].concat(args));
+
+    _defineProperty(_assertThisInitialized(_this), "prefix", _this.context);
+
+    _defineProperty(_assertThisInitialized(_this), "uid", _this.props.id || uniqueId());
+
+    _defineProperty(_assertThisInitialized(_this), "handleChange", function (evt) {
+      _this.props.onChange(_this.props.value, _this.props.name, evt);
+    });
+
+    return _this;
+  }
+
+  _createClass(RadioButton, [{
+    key: "render",
+    value: function render() {
+      var prefix = this.prefix;
+
+      var _this$props = this.props,
+          className = _this$props.className,
+          labelText = _this$props.labelText,
+          labelPosition = _this$props.labelPosition,
+          ref = _this$props.innerRef,
+          hideLabel = _this$props.hideLabel,
+          other = _objectWithoutProperties(_this$props, _excluded);
+
+      if (process.env.NODE_ENV !== "production") {
+        process.env.NODE_ENV !== "production" ? warning(labelPosition !== 'top' && labelPosition !== 'bottom', '`top`/`bottom` values for `labelPosition` property in the `RadioButton` component is deprecated ' + 'and being removed in the next release of `carbon-components-react`.') : void 0;
+      }
+
+      var innerLabelClasses = cx(_defineProperty({}, "".concat(prefix, "--visually-hidden"), hideLabel));
+      var wrapperClasses = cx(className, "".concat(prefix, "--radio-button-wrapper"), _defineProperty({}, "".concat(prefix, "--radio-button-wrapper--label-").concat(labelPosition), labelPosition !== 'right'));
+      return /*#__PURE__*/React__default.createElement("div", {
+        className: wrapperClasses
+      }, /*#__PURE__*/React__default.createElement("input", _extends({}, other, {
+        type: "radio",
+        className: "".concat(prefix, "--radio-button"),
+        onChange: this.handleChange,
+        id: this.uid,
+        ref: ref
+      })), /*#__PURE__*/React__default.createElement("label", {
+        htmlFor: this.uid,
+        className: "".concat(prefix, "--radio-button__label")
+      }, /*#__PURE__*/React__default.createElement("span", {
+        className: "".concat(prefix, "--radio-button__appearance")
+      }), labelText && /*#__PURE__*/React__default.createElement(Text, {
+        className: innerLabelClasses
+      }, labelText)));
+    }
+  }]);
+
+  return RadioButton;
+}(React__default.Component);
+
+_defineProperty(RadioButton, "propTypes", {
+  /**
+   * Specify whether the <RadioButton> is currently checked
+   */
+  checked: PropTypes.bool,
+
+  /**
+   * Provide an optional className to be applied to the containing node
+   */
+  className: PropTypes.string,
+
+  /**
+   * Specify whether the <RadioButton> should be checked by default
+   */
+  defaultChecked: PropTypes.bool,
+
+  /**
+   * Specify whether the control is disabled
+   */
+  disabled: PropTypes.bool,
+
+  /**
+   * Specify whether the label should be hidden, or not
+   */
+  hideLabel: PropTypes.bool,
+
+  /**
+   * Provide a unique id for the underlying `<input>` node
+   */
+  id: PropTypes.string,
+
+  /**
+   * Provide where label text should be placed
+   * NOTE: `top`/`bottom` are deprecated
+   */
+  labelPosition: PropTypes.oneOf(['top', 'right', 'bottom', 'left']),
+
+  /**
+   * Provide label text to be read by screen readers when interacting with the
+   * control
+   */
+  labelText: PropTypes.node.isRequired,
+
+  /**
+   * Provide a name for the underlying `<input>` node
+   */
+  name: PropTypes.string,
+
+  /**
+   * Provide an optional `onChange` hook that is called each time the value of
+   * the underlying `<input>` changes
+   */
+  onChange: PropTypes.func,
+
+  /**
+   * Provide a handler that is invoked when a user clicks on the control
+   */
+  onClick: PropTypes.func,
+
+  /**
+   * Specify the value of the <RadioButton>
+   */
+  value: PropTypes.oneOfType([PropTypes.string, PropTypes.number]).isRequired
+});
+
+_defineProperty(RadioButton, "contextType", PrefixContext);
+
+_defineProperty(RadioButton, "defaultProps", {
+  labelText: '',
+  labelPosition: 'right',
+  onChange: function onChange() {},
+  value: ''
+});
+var RadioButtonClassic = (function () {
+  var forwardRef = function forwardRef(props, ref) {
+    return /*#__PURE__*/React__default.createElement(RadioButton, _extends({}, props, {
+      innerRef: ref
+    }));
+  };
+
+  forwardRef.displayName = 'RadioButton';
+  return /*#__PURE__*/React__default.forwardRef(forwardRef);
+})();
+
+export { RadioButton, RadioButtonClassic as default };

package/es/components/RadioButton/index.js

@@ -0,0 +1,15 @@
+/**
+ * Copyright IBM Corp. 2016, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import * as FeatureFlags from '@carbon/feature-flags';
+import RadioButtonNext from './next/RadioButton.js';
+import RadioButtonClassic from './RadioButton.js';
+
+var RadioButton = FeatureFlags.enabled('enable-v11-release') ? RadioButtonNext : RadioButtonClassic;
+var RadioButton$1 = RadioButton;
+
+export { RadioButton$1 as default };

package/es/components/RadioButton/next/RadioButton.js

@@ -0,0 +1,128 @@
+/**
+ * Copyright IBM Corp. 2016, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { objectWithoutProperties as _objectWithoutProperties, defineProperty as _defineProperty, extends as _extends } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import PropTypes from 'prop-types';
+import React__default from 'react';
+import cx from 'classnames';
+import { usePrefix } from '../../../internal/usePrefix.js';
+import { useId } from '../../../internal/useId.js';
+import '../../Text/index.js';
+import { Text } from '../../Text/Text.js';
+
+var _excluded = ["className", "disabled", "hideLabel", "id", "labelPosition", "labelText", "name", "onChange", "value"];
+var RadioButton = /*#__PURE__*/React__default.forwardRef(function RadioButton(_ref, ref) {
+  var className = _ref.className,
+      disabled = _ref.disabled,
+      hideLabel = _ref.hideLabel,
+      id = _ref.id,
+      _ref$labelPosition = _ref.labelPosition,
+      labelPosition = _ref$labelPosition === void 0 ? 'right' : _ref$labelPosition,
+      _ref$labelText = _ref.labelText,
+      labelText = _ref$labelText === void 0 ? '' : _ref$labelText,
+      name = _ref.name,
+      _ref$onChange = _ref.onChange,
+      onChange = _ref$onChange === void 0 ? function () {} : _ref$onChange,
+      _ref$value = _ref.value,
+      value = _ref$value === void 0 ? '' : _ref$value,
+      rest = _objectWithoutProperties(_ref, _excluded);
+
+  var prefix = usePrefix();
+  var uid = useId('radio-button');
+  var uniqueId = id || uid;
+
+  function handleOnChange(event) {
+    onChange(value, name, event);
+  }
+
+  var innerLabelClasses = cx(_defineProperty({}, "".concat(prefix, "--visually-hidden"), hideLabel));
+  var wrapperClasses = cx(className, "".concat(prefix, "--radio-button-wrapper"), _defineProperty({}, "".concat(prefix, "--radio-button-wrapper--label-").concat(labelPosition), labelPosition !== 'right'));
+  return /*#__PURE__*/React__default.createElement("div", {
+    className: wrapperClasses
+  }, /*#__PURE__*/React__default.createElement("input", _extends({}, rest, {
+    type: "radio",
+    className: "".concat(prefix, "--radio-button"),
+    onChange: handleOnChange,
+    id: uniqueId,
+    ref: ref,
+    disabled: disabled
+  })), /*#__PURE__*/React__default.createElement("label", {
+    htmlFor: uniqueId,
+    className: "".concat(prefix, "--radio-button__label")
+  }, /*#__PURE__*/React__default.createElement("span", {
+    className: "".concat(prefix, "--radio-button__appearance")
+  }), labelText && /*#__PURE__*/React__default.createElement(Text, {
+    className: innerLabelClasses
+  }, labelText)));
+});
+RadioButton.propTypes = {
+  /**
+   * Specify whether the `<RadioButton>` is currently checked
+   */
+  checked: PropTypes.bool,
+
+  /**
+   * Provide an optional className to be applied to the containing node
+   */
+  className: PropTypes.string,
+
+  /**
+   * Specify whether the `<RadioButton>` should be checked by default
+   */
+  defaultChecked: PropTypes.bool,
+
+  /**
+   * Specify whether the control is disabled
+   */
+  disabled: PropTypes.bool,
+
+  /**
+   * Specify whether the label should be hidden, or not
+   */
+  hideLabel: PropTypes.bool,
+
+  /**
+   * Provide a unique id for the underlying `<input>` node
+   */
+  id: PropTypes.string,
+
+  /**
+   * Provide where label text should be placed
+   * NOTE: `top`/`bottom` are deprecated
+   */
+  labelPosition: PropTypes.oneOf(['right', 'left']),
+
+  /**
+   * Provide label text to be read by screen readers when interacting with the
+   * control
+   */
+  labelText: PropTypes.node.isRequired,
+
+  /**
+   * Provide a name for the underlying `<input>` node
+   */
+  name: PropTypes.string,
+
+  /**
+   * Provide an optional `onChange` hook that is called each time the value of
+   * the underlying `<input>` changes
+   */
+  onChange: PropTypes.func,
+
+  /**
+   * Provide a handler that is invoked when a user clicks on the control
+   */
+  onClick: PropTypes.func,
+
+  /**
+   * Specify the value of the `<RadioButton>`
+   */
+  value: PropTypes.oneOfType([PropTypes.string, PropTypes.number]).isRequired
+};
+var RadioButtonNext = RadioButton;
+
+export { RadioButtonNext as default };

package/es/components/RadioButtonGroup/RadioButtonGroup.js

@@ -0,0 +1,190 @@
+/**
+ * Copyright IBM Corp. 2016, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { inherits as _inherits, createSuper as _createSuper, classCallCheck as _classCallCheck, defineProperty as _defineProperty, assertThisInitialized as _assertThisInitialized, createClass as _createClass } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import PropTypes from 'prop-types';
+import React__default from 'react';
+import cx from 'classnames';
+import { warning } from '../../internal/warning.js';
+import { Legend } from '../Text/index.js';
+import { FeatureFlagContext } from '../FeatureFlags/index.js';
+import { PrefixContext } from '../../internal/usePrefix.js';
+
+var RadioButtonGroup = /*#__PURE__*/function (_React$Component) {
+  _inherits(RadioButtonGroup, _React$Component);
+
+  var _super = _createSuper(RadioButtonGroup);
+
+  function RadioButtonGroup() {
+    var _this;
+
+    _classCallCheck(this, RadioButtonGroup);
+
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+
+    _this = _super.call.apply(_super, [this].concat(args));
+
+    _defineProperty(_assertThisInitialized(_this), "state", {
+      selected: typeof _this.props.valueSelected !== 'undefined' ? _this.props.valueSelected : _this.props.defaultSelected
+    });
+
+    _defineProperty(_assertThisInitialized(_this), "getRadioButtons", function () {
+      var children = React__default.Children.map(_this.props.children, function (radioButton) {
+        var value = radioButton.props.value;
+        /* istanbul ignore if */
+
+        if (typeof radioButton.props.checked !== 'undefined') {
+          process.env.NODE_ENV !== "production" ? warning(false, "Instead of using the checked property on the RadioButton, set\n            the defaultSelected property or valueSelected property on the RadioButtonGroup.") : void 0;
+        }
+
+        return /*#__PURE__*/React__default.cloneElement(radioButton, {
+          name: _this.props.name,
+          key: value,
+          value: value,
+          onChange: _this.handleChange,
+          checked: value === _this.state.selected
+        });
+      });
+      return children;
+    });
+
+    _defineProperty(_assertThisInitialized(_this), "handleChange", function (newSelection, value, evt) {
+      if (newSelection !== _this.state.selected) {
+        _this.setState({
+          selected: newSelection
+        });
+
+        _this.props.onChange(newSelection, _this.props.name, evt);
+      }
+    });
+
+    return _this;
+  }
+
+  _createClass(RadioButtonGroup, [{
+    key: "render",
+    value: function render() {
+      var _this2 = this;
+
+      var _this$props = this.props,
+          disabled = _this$props.disabled,
+          className = _this$props.className,
+          hideLegend = _this$props.hideLegend,
+          orientation = _this$props.orientation,
+          labelPosition = _this$props.labelPosition,
+          legendText = _this$props.legendText;
+      var scope = this.context;
+      var enabled;
+
+      if (scope.enabled) {
+        enabled = scope.enabled('enable-v11-release');
+      }
+
+      return /*#__PURE__*/React__default.createElement(PrefixContext.Consumer, null, function (prefix) {
+        var _classNames;
+
+        var wrapperClasses = cx("".concat(prefix, "--radio-button-group"), [enabled ? null : className], (_classNames = {}, _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--").concat(orientation), orientation === 'vertical'), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--label-").concat(labelPosition), labelPosition), _classNames));
+        var legendClasses = cx("".concat(prefix, "--label"), _defineProperty({}, "".concat(prefix, "--visually-hidden"), hideLegend));
+        return /*#__PURE__*/React__default.createElement("div", {
+          className: enabled ? cx("".concat(prefix, "--form-item"), className) : "".concat(prefix, "--form-item")
+        }, /*#__PURE__*/React__default.createElement("fieldset", {
+          className: wrapperClasses,
+          disabled: disabled
+        }, legendText && /*#__PURE__*/React__default.createElement(Legend, {
+          className: legendClasses
+        }, legendText), _this2.getRadioButtons()));
+      });
+    }
+  }], [{
+    key: "getDerivedStateFromProps",
+    value: function getDerivedStateFromProps(_ref, state) {
+      var valueSelected = _ref.valueSelected,
+          defaultSelected = _ref.defaultSelected;
+      var prevValueSelected = state.prevValueSelected;
+      return prevValueSelected === valueSelected ? null : {
+        selected: typeof valueSelected !== 'undefined' ? valueSelected : defaultSelected,
+        prevValueSelected: valueSelected
+      };
+    }
+  }]);
+
+  return RadioButtonGroup;
+}(React__default.Component);
+
+_defineProperty(RadioButtonGroup, "propTypes", {
+  /**
+   * Provide a collection of <RadioButton> components to render in the group
+   */
+  children: PropTypes.node,
+
+  /**
+   * Provide an optional className to be applied to the container node
+   */
+  className: PropTypes.string,
+
+  /**
+   * Specify the <RadioButton> to be selected by default
+   */
+  defaultSelected: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+
+  /**
+   * Specify whether the group is disabled
+   */
+  disabled: PropTypes.bool,
+
+  /**
+   * Specify whether the legend should be hidden, or not
+   */
+  hideLegend: PropTypes.bool,
+
+  /**
+   * Provide where label text should be placed
+   */
+  labelPosition: PropTypes.oneOf(['left', 'right']),
+
+  /**
+   * Provide a legend to the RadioButtonGroup input that you are
+   * exposing to the user
+   */
+  legendText: PropTypes.node,
+
+  /**
+   * Specify the name of the underlying `<input>` nodes
+   */
+  name: PropTypes.string.isRequired,
+
+  /**
+   * Provide an optional `onChange` hook that is called whenever the value of
+   * the group changes
+   */
+  onChange: PropTypes.func,
+
+  /**
+   * Provide where radio buttons should be placed
+   */
+  orientation: PropTypes.oneOf(['horizontal', 'vertical']),
+
+  /**
+   * Specify the value that is currently selected in the group
+   */
+  valueSelected: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
+});
+
+_defineProperty(RadioButtonGroup, "defaultProps", {
+  orientation: 'horizontal',
+  labelPosition: 'right',
+  hideLegend: false,
+  onChange:
+  /* istanbul ignore next */
+  function onChange() {}
+});
+
+_defineProperty(RadioButtonGroup, "contextType", FeatureFlagContext);
+
+export { RadioButtonGroup as default };

package/es/components/RadioButtonGroup/index.js

@@ -0,0 +1,15 @@
+/**
+ * Copyright IBM Corp. 2016, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import * as FeatureFlags from '@carbon/feature-flags';
+import RadioButtonGroupNext from './next/RadioButtonGroup.js';
+import RadioButtonGroup$2 from './RadioButtonGroup.js';
+
+var RadioButtonGroup = FeatureFlags.enabled('enable-v11-release') ? RadioButtonGroupNext : RadioButtonGroup$2;
+var RadioButtonGroup$1 = RadioButtonGroup;
+
+export { RadioButtonGroup$1 as default };

package/es/components/RadioButtonGroup/next/RadioButtonGroup.js

@@ -0,0 +1,141 @@
+/**
+ * Copyright IBM Corp. 2016, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { slicedToArray as _slicedToArray, defineProperty as _defineProperty } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import PropTypes from 'prop-types';
+import React__default, { useState } from 'react';
+import cx from 'classnames';
+import { Legend } from '../../Text/index.js';
+import { usePrefix } from '../../../internal/usePrefix.js';
+
+var RadioButtonGroup = /*#__PURE__*/React__default.forwardRef(function RadioButtonGroup(_ref, ref) {
+  var _classNames;
+
+  var children = _ref.children,
+      className = _ref.className,
+      defaultSelected = _ref.defaultSelected,
+      disabled = _ref.disabled,
+      _ref$labelPosition = _ref.labelPosition,
+      labelPosition = _ref$labelPosition === void 0 ? 'right' : _ref$labelPosition,
+      legendText = _ref.legendText,
+      name = _ref.name,
+      _ref$onChange = _ref.onChange,
+      onChange = _ref$onChange === void 0 ? function () {} : _ref$onChange,
+      _ref$orientation = _ref.orientation,
+      orientation = _ref$orientation === void 0 ? 'horizontal' : _ref$orientation,
+      valueSelected = _ref.valueSelected;
+  var prefix = usePrefix();
+
+  var _useState = useState(valueSelected !== null && valueSelected !== void 0 ? valueSelected : defaultSelected),
+      _useState2 = _slicedToArray(_useState, 2),
+      selected = _useState2[0],
+      setSelected = _useState2[1];
+
+  var _useState3 = useState(valueSelected),
+      _useState4 = _slicedToArray(_useState3, 2),
+      prevValueSelected = _useState4[0],
+      setPrevValueSelected = _useState4[1];
+  /**
+   * prop + state alignment - getDerivedStateFromProps
+   * only update if selected prop changes
+   */
+
+
+  if (valueSelected !== prevValueSelected) {
+    setSelected(valueSelected);
+    setPrevValueSelected(valueSelected);
+  }
+
+  function getRadioButtons() {
+    var mappedChildren = React__default.Children.map(children, function (radioButton) {
+      var value = radioButton.props.value;
+      return /*#__PURE__*/React__default.cloneElement(radioButton, {
+        name: name,
+        key: value,
+        value: value,
+        onChange: handleOnChange,
+        checked: value === selected
+      });
+    });
+    return mappedChildren;
+  }
+
+  function handleOnChange(newSelection, value, evt) {
+    if (newSelection !== selected) {
+      setSelected(newSelection);
+      onChange(newSelection, name, evt);
+    }
+  }
+
+  var fieldsetClasses = cx("".concat(prefix, "--radio-button-group"), (_classNames = {}, _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--").concat(orientation), orientation === 'vertical'), _defineProperty(_classNames, "".concat(prefix, "--radio-button-group--label-").concat(labelPosition), labelPosition), _classNames));
+  var wrapperClasses = cx("".concat(prefix, "--form-item"), className);
+  return /*#__PURE__*/React__default.createElement("div", {
+    className: wrapperClasses,
+    ref: ref
+  }, /*#__PURE__*/React__default.createElement("fieldset", {
+    className: fieldsetClasses,
+    disabled: disabled
+  }, legendText && /*#__PURE__*/React__default.createElement(Legend, {
+    className: "".concat(prefix, "--label")
+  }, legendText), getRadioButtons()));
+});
+RadioButtonGroup.propTypes = {
+  /**
+   * Provide a collection of `<RadioButton>` components to render in the group
+   */
+  children: PropTypes.node,
+
+  /**
+   * Provide an optional className to be applied to the container node
+   */
+  className: PropTypes.string,
+
+  /**
+   * Specify the `<RadioButton>` to be selected by default
+   */
+  defaultSelected: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+
+  /**
+   * Specify whether the group is disabled
+   */
+  disabled: PropTypes.bool,
+
+  /**
+   * Provide where label text should be placed
+   */
+  labelPosition: PropTypes.oneOf(['left', 'right']),
+
+  /**
+   * Provide a legend to the RadioButtonGroup input that you are
+   * exposing to the user
+   */
+  legendText: PropTypes.node,
+
+  /**
+   * Specify the name of the underlying `<input>` nodes
+   */
+  name: PropTypes.string.isRequired,
+
+  /**
+   * Provide an optional `onChange` hook that is called whenever the value of
+   * the group changes
+   */
+  onChange: PropTypes.func,
+
+  /**
+   * Provide where radio buttons should be placed
+   */
+  orientation: PropTypes.oneOf(['horizontal', 'vertical']),
+
+  /**
+   * Specify the value that is currently selected in the group
+   */
+  valueSelected: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
+};
+var RadioButtonGroupNext = RadioButtonGroup;
+
+export { RadioButtonGroupNext as default };