@carbon/ibm-products 2.0.0-rc.2 → 2.0.0-rc.20

package/lib/components/Datagrid/Datagrid/addons/Filtering/FilterFlyout.js

@@ -0,0 +1,505 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+
+var _icons = require("@carbon/react/icons");
+
+var _react = require("@carbon/react");
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _react2 = _interopRequireWildcard(require("react"));
+
+var _hooks = require("../../../../../global/js/hooks");
+
+var _settings = require("../../../../../settings");
+
+var _ActionSet = require("../../../../ActionSet");
+
+var _constants = require("./constants");
+
+var _hooks2 = require("./hooks");
+
+var _utils = require("./utils");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+var blockClass = "".concat(_settings.pkg.prefix, "--datagrid");
+var componentClass = "".concat(blockClass, "-filter-flyout");
+
+var FilterFlyout = function FilterFlyout(_ref) {
+  var _cx2;
+
+  var _ref$updateMethod = _ref.updateMethod,
+      updateMethod = _ref$updateMethod === void 0 ? _constants.BATCH : _ref$updateMethod,
+      _ref$flyoutIconDescri = _ref.flyoutIconDescription,
+      flyoutIconDescription = _ref$flyoutIconDescri === void 0 ? 'Open filters' : _ref$flyoutIconDescri,
+      _ref$filters = _ref.filters,
+      filters = _ref$filters === void 0 ? [] : _ref$filters,
+      _ref$title = _ref.title,
+      title = _ref$title === void 0 ? 'Filter' : _ref$title,
+      _ref$primaryActionLab = _ref.primaryActionLabel,
+      primaryActionLabel = _ref$primaryActionLab === void 0 ? 'Apply' : _ref$primaryActionLab,
+      _ref$onFlyoutOpen = _ref.onFlyoutOpen,
+      onFlyoutOpen = _ref$onFlyoutOpen === void 0 ? function () {} : _ref$onFlyoutOpen,
+      _ref$onFlyoutClose = _ref.onFlyoutClose,
+      onFlyoutClose = _ref$onFlyoutClose === void 0 ? function () {} : _ref$onFlyoutClose,
+      _ref$onApply = _ref.onApply,
+      onApply = _ref$onApply === void 0 ? function () {} : _ref$onApply,
+      _ref$onCancel = _ref.onCancel,
+      onCancel = _ref$onCancel === void 0 ? function () {} : _ref$onCancel,
+      _ref$secondaryActionL = _ref.secondaryActionLabel,
+      secondaryActionLabel = _ref$secondaryActionL === void 0 ? 'Cancel' : _ref$secondaryActionL,
+      setAllFilters = _ref.setAllFilters,
+      _ref$data = _ref.data,
+      data = _ref$data === void 0 ? [] : _ref$data;
+
+  /** State */
+  var _useState = (0, _react2.useState)(false),
+      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+      open = _useState2[0],
+      setOpen = _useState2[1];
+
+  var _useInitialStateFromF = (0, _hooks2.useInitialStateFromFilters)(filters, _constants.FLYOUT),
+      _useInitialStateFromF2 = (0, _slicedToArray2.default)(_useInitialStateFromF, 2),
+      filtersState = _useInitialStateFromF2[0],
+      setFiltersState = _useInitialStateFromF2[1];
+
+  var _useState3 = (0, _react2.useState)([]),
+      _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+      filtersObjectArray = _useState4[0],
+      setFiltersObjectArray = _useState4[1];
+  /** Refs */
+
+
+  var filterFlyoutRef = (0, _react2.useRef)(null); // When using batch actions we have to store the filters to then apply them later
+
+  var prevFiltersRef = (0, _react2.useRef)(JSON.stringify(filtersState));
+  var prevFiltersObjectArrayRef = (0, _react2.useRef)(JSON.stringify(filtersObjectArray));
+  /** State from hooks */
+
+  var _useShouldDisableButt = (0, _hooks2.useShouldDisableButtons)({
+    initialValue: true,
+    filtersState: filtersState,
+    prevFiltersRef: prevFiltersRef
+  }),
+      _useShouldDisableButt2 = (0, _slicedToArray2.default)(_useShouldDisableButt, 2),
+      shouldDisableButtons = _useShouldDisableButt2[0],
+      setShouldDisableButtons = _useShouldDisableButt2[1];
+  /** Memos */
+
+
+  var showActionSet = updateMethod === _constants.BATCH;
+  var carbonPrefix = (0, _react.usePrefix)();
+  /** Methods */
+
+  var openFlyout = function openFlyout() {
+    setOpen(true);
+    onFlyoutOpen();
+  };
+
+  var closeFlyout = function closeFlyout() {
+    setOpen(false);
+    onFlyoutClose();
+  };
+
+  var apply = function apply() {
+    setAllFilters(filtersObjectArray);
+    closeFlyout(); // From the user
+
+    onApply(); // When the user clicks apply, the action set buttons should be disabled again
+
+    setShouldDisableButtons(true); // updates the ref so next time the flyout opens we have records of the previous filters
+
+    prevFiltersRef.current = JSON.stringify(filtersState);
+    prevFiltersObjectArrayRef.current = JSON.stringify(filtersObjectArray);
+  };
+
+  var cancel = function cancel() {
+    // Reverting to previous filters only applies when using batch actions
+    if (updateMethod === _constants.BATCH) {
+      revertToPreviousFilters();
+      onCancel();
+    }
+
+    closeFlyout();
+  };
+
+  var reset = function reset() {
+    // Get the initial values for the filters
+    var initialFiltersState = (0, _utils.getInitialStateFromFilters)(filters, _constants.FLYOUT);
+    var initialFiltersObjectArray = []; // Set the state to the initial values
+
+    setFiltersState(initialFiltersState);
+    setFiltersObjectArray(initialFiltersObjectArray);
+    setAllFilters([]); // Update their respective refs so everything is in sync
+
+    prevFiltersRef.current = JSON.stringify(initialFiltersState);
+    prevFiltersObjectArrayRef.current = JSON.stringify(initialFiltersObjectArray);
+  }; // If the user decides to cancel or click outside the flyout, it reverts back to the filters that were
+  // there when they opened the flyout
+
+
+  var revertToPreviousFilters = function revertToPreviousFilters() {
+    setFiltersState(JSON.parse(prevFiltersRef.current));
+    setFiltersObjectArray(JSON.parse(prevFiltersObjectArrayRef.current));
+  };
+
+  var applyFilters = (0, _react2.useCallback)(function (_ref2) {
+    var column = _ref2.column,
+        value = _ref2.value,
+        type = _ref2.type;
+
+    // If no end date is selected return because we need the end date to do computations
+    if (type === _constants.DATE && !value[1]) {
+      return;
+    }
+
+    var filtersObjectArrayCopy = (0, _toConsumableArray2.default)(filtersObjectArray); // check if the filter already exists in the array
+
+    var filter = filtersObjectArrayCopy.find(function (item) {
+      return item.id === column;
+    }); // if filter exists in array then update the filter's new value
+
+    if (filter) {
+      filter.value = value;
+    } else {
+      filtersObjectArrayCopy.push({
+        id: column,
+        value: value,
+        type: type
+      });
+    }
+
+    if (type === _constants.CHECKBOX) {
+      /**
+      When all checkboxes of a group are all unselected the value still exists in the filtersObjectArray
+      This checks if all the checkboxes are selected = false and removes it from the array
+      */
+      var index = filtersObjectArrayCopy.findIndex(function (filter) {
+        return filter.id === column;
+      }); // If all the selected state is false remove from array
+
+      var shouldRemoveFromArray = filtersObjectArrayCopy[index].value.every(function (val) {
+        return val.selected === false;
+      });
+
+      if (shouldRemoveFromArray) {
+        filtersObjectArrayCopy.splice(index, 1);
+      }
+    } else if (type === _constants.DROPDOWN || type === _constants.RADIO) {
+      if (value === 'Any') {
+        /**
+        Checks to see if the selected value is 'Any', that means the user wants
+        to reset specific filter
+        */
+        var _index = filtersObjectArrayCopy.findIndex(function (filter) {
+          return filter.id === column;
+        }); // Remove it from the filters array
+
+
+        filtersObjectArrayCopy.splice(_index, 1);
+      }
+    }
+
+    setFiltersObjectArray(filtersObjectArrayCopy); // Automatically apply the filters if the updateMethod is instant
+
+    if (updateMethod === _constants.INSTANT) {
+      setAllFilters(filtersObjectArrayCopy);
+    }
+  }, [setAllFilters, updateMethod, filtersObjectArray]);
+  /** Effects */
+
+  (0, _hooks.useClickOutside)(filterFlyoutRef, function (target) {
+    var hasClickedOnDatePicker = target.closest('.flatpickr-calendar');
+    var hasClickedOnDropdown = target.className === "".concat(carbonPrefix, "--list-box__menu-item__option");
+
+    if (!open || hasClickedOnDatePicker || hasClickedOnDropdown) {
+      return;
+    }
+
+    cancel();
+  });
+  (0, _hooks2.useSubscribeToEventEmitter)(_constants.CLEAR_FILTERS, reset);
+  /** Render the individual filter component */
+
+  var renderFilter = function renderFilter(_ref3) {
+    var type = _ref3.type,
+        column = _ref3.column,
+        components = _ref3.props;
+
+    if (type === _constants.DATE) {
+      return /*#__PURE__*/_react2.default.createElement(_react.DatePicker, (0, _extends2.default)({}, components.DatePicker, {
+        onChange: function onChange(value) {
+          var _components$DatePicke, _components$DatePicke2;
+
+          setFiltersState(_objectSpread(_objectSpread({}, filtersState), {}, (0, _defineProperty2.default)({}, column, {
+            value: value,
+            type: type
+          })));
+          applyFilters({
+            column: column,
+            value: value,
+            type: type
+          });
+          (_components$DatePicke = (_components$DatePicke2 = components.DatePicker).onChange) === null || _components$DatePicke === void 0 ? void 0 : _components$DatePicke.call(_components$DatePicke2, value);
+        },
+        value: filtersState[column].value,
+        datePickerType: "range"
+      }), /*#__PURE__*/_react2.default.createElement(_react.DatePickerInput, (0, _extends2.default)({
+        placeholder: "mm/dd/yyyy",
+        labelText: "Start date"
+      }, components.DatePickerInput.start)), /*#__PURE__*/_react2.default.createElement(_react.DatePickerInput, (0, _extends2.default)({
+        placeholder: "mm/dd/yyyy",
+        labelText: "End date"
+      }, components.DatePickerInput.end)));
+    } else if (type === _constants.NUMBER) {
+      return /*#__PURE__*/_react2.default.createElement(_react.NumberInput, (0, _extends2.default)({
+        step: 1,
+        allowEmpty: true,
+        hideSteppers: true
+      }, components.NumberInput, {
+        onChange: function onChange(event) {
+          var _components$NumberInp, _components$NumberInp2;
+
+          setFiltersState(_objectSpread(_objectSpread({}, filtersState), {}, (0, _defineProperty2.default)({}, column, {
+            value: event.target.value,
+            type: type
+          })));
+          applyFilters({
+            column: column,
+            value: event.target.value,
+            type: type
+          });
+          (_components$NumberInp = (_components$NumberInp2 = components.NumberInput).onChange) === null || _components$NumberInp === void 0 ? void 0 : _components$NumberInp.call(_components$NumberInp2, event);
+        },
+        value: filtersState[column].value
+      }));
+    } else if (type === _constants.CHECKBOX) {
+      return /*#__PURE__*/_react2.default.createElement(_react.FormGroup, components.FormGroup, filtersState[column].value.map(function (option) {
+        return /*#__PURE__*/_react2.default.createElement(_react.Checkbox, (0, _extends2.default)({
+          key: option.labelText
+        }, option, {
+          onChange: function onChange(_, _ref4) {
+            var _option$onChange;
+
+            var isSelected = _ref4.checked;
+            var checkboxCopy = filtersState[column].value;
+            var foundCheckbox = checkboxCopy.find(function (checkbox) {
+              return checkbox.value === option.value;
+            });
+            foundCheckbox.selected = isSelected;
+            setFiltersState(_objectSpread(_objectSpread({}, filtersState), {}, (0, _defineProperty2.default)({}, column, {
+              value: checkboxCopy,
+              type: type
+            })));
+            applyFilters({
+              column: column,
+              value: (0, _toConsumableArray2.default)(filtersState[column].value),
+              type: type
+            });
+            (_option$onChange = option.onChange) === null || _option$onChange === void 0 ? void 0 : _option$onChange.call(option, isSelected);
+          },
+          checked: option.selected
+        }));
+      }));
+    } else if (type === _constants.RADIO) {
+      var _filtersState$column, _filtersState$column2;
+
+      return /*#__PURE__*/_react2.default.createElement(_react.FormGroup, components.FormGroup, /*#__PURE__*/_react2.default.createElement(_react.RadioButtonGroup, (0, _extends2.default)({}, components.RadioButtonGroup, {
+        valueSelected: ((_filtersState$column = filtersState[column]) === null || _filtersState$column === void 0 ? void 0 : _filtersState$column.value) === '' ? 'Any' : (_filtersState$column2 = filtersState[column]) === null || _filtersState$column2 === void 0 ? void 0 : _filtersState$column2.value,
+        onChange: function onChange(selected) {
+          var _components$RadioButt, _components$RadioButt2;
+
+          setFiltersState(_objectSpread(_objectSpread({}, filtersState), {}, (0, _defineProperty2.default)({}, column, {
+            value: selected,
+            type: type
+          })));
+          applyFilters({
+            column: column,
+            value: selected,
+            type: type
+          });
+          (_components$RadioButt = (_components$RadioButt2 = components.RadioButtonGroup).onChange) === null || _components$RadioButt === void 0 ? void 0 : _components$RadioButt.call(_components$RadioButt2, selected);
+        }
+      }), /*#__PURE__*/_react2.default.createElement(_react.RadioButton, {
+        id: "any",
+        labelText: "Any",
+        value: "Any"
+      }), components.RadioButton.map(function (radio) {
+        var _ref5, _radio$id;
+
+        return /*#__PURE__*/_react2.default.createElement(_react.RadioButton, (0, _extends2.default)({
+          key: (_ref5 = (_radio$id = radio.id) !== null && _radio$id !== void 0 ? _radio$id : radio.labelText) !== null && _ref5 !== void 0 ? _ref5 : radio.value
+        }, radio));
+      })));
+    } else if (type === _constants.DROPDOWN) {
+      var _filtersState$column3, _filtersState$column4;
+
+      return /*#__PURE__*/_react2.default.createElement(_react.Dropdown, (0, _extends2.default)({}, components.Dropdown, {
+        selectedItem: ((_filtersState$column3 = filtersState[column]) === null || _filtersState$column3 === void 0 ? void 0 : _filtersState$column3.value) === '' ? 'Any' : (_filtersState$column4 = filtersState[column]) === null || _filtersState$column4 === void 0 ? void 0 : _filtersState$column4.value,
+        items: ['Any'].concat((0, _toConsumableArray2.default)(components.Dropdown.items)),
+        onChange: function onChange(_ref6) {
+          var _components$Dropdown$, _components$Dropdown;
+
+          var selectedItem = _ref6.selectedItem;
+          setFiltersState(_objectSpread(_objectSpread({}, filtersState), {}, (0, _defineProperty2.default)({}, column, {
+            value: selectedItem,
+            type: type
+          })));
+          applyFilters({
+            column: column,
+            value: selectedItem,
+            type: type
+          });
+          (_components$Dropdown$ = (_components$Dropdown = components.Dropdown).onChange) === null || _components$Dropdown$ === void 0 ? void 0 : _components$Dropdown$.call(_components$Dropdown, selectedItem);
+        }
+      }));
+    }
+  };
+  /** Renders all filters */
+
+
+  var renderFilters = function renderFilters() {
+    return filters.map(renderFilter);
+  };
+
+  var renderActionSet = function renderActionSet() {
+    return showActionSet && /*#__PURE__*/_react2.default.createElement(_ActionSet.ActionSet, {
+      actions: [{
+        key: 1,
+        kind: 'primary',
+        label: primaryActionLabel,
+        onClick: apply,
+        isExpressive: false,
+        disabled: shouldDisableButtons
+      }, {
+        key: 3,
+        kind: 'secondary',
+        label: secondaryActionLabel,
+        onClick: cancel,
+        isExpressive: false,
+        disabled: shouldDisableButtons
+      }],
+      size: "md",
+      buttonSize: "md"
+    });
+  };
+
+  return /*#__PURE__*/_react2.default.createElement("div", {
+    className: "".concat(componentClass, "__container")
+  }, /*#__PURE__*/_react2.default.createElement(_react.Button, {
+    kind: "ghost",
+    hasIconOnly: true,
+    tooltipPosition: "bottom",
+    renderIcon: function renderIcon() {
+      return /*#__PURE__*/_react2.default.createElement(_icons.Filter, {
+        size: 16
+      });
+    },
+    iconDescription: flyoutIconDescription,
+    onClick: open ? closeFlyout : openFlyout,
+    className: (0, _classnames.default)("".concat(componentClass, "__trigger"), (0, _defineProperty2.default)({}, "".concat(componentClass, "__trigger--open"), open)),
+    disabled: data.length === 0
+  }), /*#__PURE__*/_react2.default.createElement("div", {
+    ref: filterFlyoutRef,
+    className: (0, _classnames.default)(componentClass, (_cx2 = {}, (0, _defineProperty2.default)(_cx2, "".concat(componentClass, "--open"), open), (0, _defineProperty2.default)(_cx2, "".concat(componentClass, "--batch"), showActionSet), (0, _defineProperty2.default)(_cx2, "".concat(componentClass, "--instant"), !showActionSet), _cx2))
+  }, /*#__PURE__*/_react2.default.createElement("div", {
+    className: "".concat(componentClass, "__inner-container")
+  }, /*#__PURE__*/_react2.default.createElement("span", {
+    className: "".concat(componentClass, "__title")
+  }, title), /*#__PURE__*/_react2.default.createElement("div", {
+    className: "".concat(componentClass, "__filters")
+  }, renderFilters())), renderActionSet()));
+};
+
+FilterFlyout.propTypes = {
+  /**
+   * All data rows in the table
+   */
+  data: _propTypes.default.array.isRequired,
+
+  /**
+   * Array of filters to render
+   */
+  filters: _propTypes.default.arrayOf(_propTypes.default.shape({
+    type: _propTypes.default.string.isRequired,
+    column: _propTypes.default.string.isRequired,
+    props: _propTypes.default.object.isRequired
+  })).isRequired,
+
+  /**
+   * Icon description for the filter flyout button
+   */
+  flyoutIconDescription: _propTypes.default.string,
+
+  /**
+   * Callback when the apply button is clicked
+   */
+  onApply: _propTypes.default.func,
+
+  /**
+   * Callback when the cancel button is clicked
+   */
+  onCancel: _propTypes.default.func,
+
+  /**
+   * Callback when the flyout closes
+   */
+  onFlyoutClose: _propTypes.default.func,
+
+  /**
+   * Callback when the flyout opens
+   */
+  onFlyoutOpen: _propTypes.default.func,
+
+  /**
+   * Label text of the primary action in the flyout
+   */
+  primaryActionLabel: _propTypes.default.string,
+
+  /**
+   * Label text of the secondary action in the flyout
+   */
+  secondaryActionLabel: _propTypes.default.string,
+
+  /**
+   * Function that sets all the filters, this comes from the datagridState
+   */
+  setAllFilters: _propTypes.default.func.isRequired,
+
+  /**
+   * Title of the filter flyout
+   */
+  title: _propTypes.default.string,
+
+  /**
+   * The update method used to apply the filters
+   */
+  updateMethod: _propTypes.default.oneOf([_constants.BATCH, _constants.INSTANT]).isRequired
+};
+var _default = FilterFlyout;
+exports.default = _default;