@atlaskit/datetime-picker 15.12.1 → 15.13.0

package/dist/cjs/components/date-time-picker.js

@@ -1,16 +1,386 @@
 "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 _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
-var _ffComponent = require("../internal/ff-component");
-var _dateTimePickerClass = _interopRequireDefault(require("./date-time-picker-class"));
-var _dateTimePickerFc = _interopRequireDefault(require("./date-time-picker-fc"));
-var DateTimePicker = (0, _ffComponent.componentWithCondition)(function () {
-  return (0, _platformFeatureFlags.fg)('dst-date-time-picker-use-functional-component');
-}, _dateTimePickerFc.default, _dateTimePickerClass.default);
-// eslint-disable-next-line @repo/internal/react/require-jsdoc
+exports.timePickerDefaultAriaLabel = exports.default = exports.datePickerDefaultAriaLabel = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _react = _interopRequireWildcard(require("react"));
+var _dateFns = require("date-fns");
+var _analyticsNext = require("@atlaskit/analytics-next");
+var _new = require("@atlaskit/button/new");
+var _crossCircleSelectClear = _interopRequireDefault(require("@atlaskit/icon/utility/migration/cross-circle--select-clear"));
+var _primitives = require("@atlaskit/primitives");
+var _select = require("@atlaskit/select");
+var _internal = require("../internal");
+var _dateTimePickerContainer = require("../internal/date-time-picker-container");
+var _parseTokens = require("../internal/parse-tokens");
+var _datePicker = _interopRequireDefault(require("./date-picker"));
+var _timePicker = _interopRequireDefault(require("./time-picker"));
+var _excluded = ["selectProps"],
+  _excluded2 = ["selectProps"];
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var packageName = "@atlaskit/datetime-picker";
+var packageVersion = "15.13.0";
+var analyticsAttributes = {
+  componentName: 'dateTimePicker',
+  packageName: packageName,
+  packageVersion: packageVersion
+};
+
+// Make DatePicker 50% the width of DateTimePicker
+// If rendering an icon container, shrink the TimePicker
+var datePickerContainerStyles = (0, _primitives.xcss)({
+  flexBasis: '50%',
+  flexGrow: 1,
+  flexShrink: 0
+});
+var timePickerContainerStyles = (0, _primitives.xcss)({
+  flexBasis: '50%',
+  flexGrow: 1
+});
+var iconContainerStyles = (0, _primitives.xcss)({
+  display: 'flex',
+  alignItems: 'center',
+  flexBasis: 'inherit'
+});
+
+// react-select overrides (via @atlaskit/select).
+var styles = {
+  control: function control(style) {
+    return _objectSpread(_objectSpread({}, style), {}, {
+      backgroundColor: 'transparent',
+      border: 2,
+      borderRadius: 0,
+      paddingLeft: 0,
+      ':hover': {
+        backgroundColor: 'transparent',
+        cursor: 'inherit'
+      }
+    });
+  }
+};
+var datePickerDefaultAriaLabel = exports.datePickerDefaultAriaLabel = 'Date';
+var timePickerDefaultAriaLabel = exports.timePickerDefaultAriaLabel = 'Time';
+
+/**
+ * __Date time picker__
+ *
+ * A date time picker allows the user to select an associated date and time.
+ *
+ * - [Examples](https://atlassian.design/components/datetime-picker/examples)
+ * - [Code](https://atlassian.design/components/datetime-picker/code)
+ * - [Usage](https://atlassian.design/components/datetime-picker/usage)
+ */
+var DateTimePicker = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
+  var ariaDescribedBy = _ref['aria-describedby'],
+    _ref$appearance = _ref.appearance,
+    appearance = _ref$appearance === void 0 ? 'default' : _ref$appearance,
+    _ref$autoFocus = _ref.autoFocus,
+    autoFocus = _ref$autoFocus === void 0 ? false : _ref$autoFocus,
+    _ref$clearControlLabe = _ref.clearControlLabel,
+    clearControlLabel = _ref$clearControlLabe === void 0 ? 'clear' : _ref$clearControlLabe,
+    _ref$datePickerProps = _ref.datePickerProps,
+    datePickerPropsWithSelectProps = _ref$datePickerProps === void 0 ? {} : _ref$datePickerProps,
+    _ref$defaultValue = _ref.defaultValue,
+    defaultValue = _ref$defaultValue === void 0 ? '' : _ref$defaultValue,
+    _ref$id = _ref.id,
+    id = _ref$id === void 0 ? '' : _ref$id,
+    _ref$innerProps = _ref.innerProps,
+    innerProps = _ref$innerProps === void 0 ? {} : _ref$innerProps,
+    _ref$isDisabled = _ref.isDisabled,
+    isDisabled = _ref$isDisabled === void 0 ? false : _ref$isDisabled,
+    _ref$isInvalid = _ref.isInvalid,
+    isInvalid = _ref$isInvalid === void 0 ? false : _ref$isInvalid,
+    _ref$isRequired = _ref.isRequired,
+    isRequired = _ref$isRequired === void 0 ? false : _ref$isRequired,
+    _ref$name = _ref.name,
+    name = _ref$name === void 0 ? '' : _ref$name,
+    _ref$onBlur = _ref.onBlur,
+    onBlur = _ref$onBlur === void 0 ? function (_event) {} : _ref$onBlur,
+    _ref$onChange = _ref.onChange,
+    onChangeProp = _ref$onChange === void 0 ? function (_value) {} : _ref$onChange,
+    _ref$onFocus = _ref.onFocus,
+    onFocus = _ref$onFocus === void 0 ? function (_event) {} : _ref$onFocus,
+    providedParseValue = _ref.parseValue,
+    _ref$spacing = _ref.spacing,
+    spacing = _ref$spacing === void 0 ? 'default' : _ref$spacing,
+    _ref$locale = _ref.locale,
+    locale = _ref$locale === void 0 ? 'en-US' : _ref$locale,
+    testId = _ref.testId,
+    _ref$timePickerProps = _ref.timePickerProps,
+    timePickerPropsWithSelectProps = _ref$timePickerProps === void 0 ? {} : _ref$timePickerProps,
+    providedValue = _ref.value;
+  var _useState = (0, _react.useState)((datePickerPropsWithSelectProps === null || datePickerPropsWithSelectProps === void 0 ? void 0 : datePickerPropsWithSelectProps.defaultValue) || ''),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    dateValue = _useState2[0],
+    setDateValue = _useState2[1];
+  var _useState3 = (0, _react.useState)(false),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    isFocused = _useState4[0],
+    setIsFocused = _useState4[1];
+  var _useState5 = (0, _react.useState)((timePickerPropsWithSelectProps === null || timePickerPropsWithSelectProps === void 0 ? void 0 : timePickerPropsWithSelectProps.defaultValue) || ''),
+    _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+    timeValue = _useState6[0],
+    setTimeValue = _useState6[1];
+  var _useState7 = (0, _react.useState)(defaultValue || ''),
+    _useState8 = (0, _slicedToArray2.default)(_useState7, 2),
+    value = _useState8[0],
+    setValue = _useState8[1];
+  var _useState9 = (0, _react.useState)(''),
+    _useState10 = (0, _slicedToArray2.default)(_useState9, 2),
+    zoneValue = _useState10[0],
+    setZoneValue = _useState10[1];
+  (0, _react.useEffect)(function () {
+    if (providedValue) {
+      setValue(providedValue);
+    }
+  }, [providedValue]);
+  var parseValue = (0, _react.useCallback)(function (value, providedDateValue, providedTimeValue, providedZoneValue) {
+    if (providedParseValue) {
+      var parsedFromFn = providedParseValue(value, providedDateValue, providedTimeValue, providedZoneValue);
+      // This handles cases found in Jira where the parse function actually does
+      // nothing and returns undefined. The previous `getSafeState` function
+      // just spread the values over the state, but if it returned `undefined`,
+      // it would just rely on the previous state values. Considering this is
+      // what is input to this function anyway, this is a safe way to handle
+      // this, colocate the behavior, and not rely on `getSafeState`.
+      return parsedFromFn || {
+        dateValue: providedDateValue,
+        timeValue: providedTimeValue,
+        zoneValue: providedZoneValue
+      };
+    }
+    var parsed = (0, _dateFns.parseISO)(value);
+    return (0, _dateFns.isValid)(parsed) ? {
+      dateValue: (0, _dateFns.format)(parsed, (0, _parseTokens.convertTokens)('YYYY-MM-DD')),
+      timeValue: (0, _dateFns.format)(parsed, (0, _parseTokens.convertTokens)('HH:mm')),
+      zoneValue: (0, _dateFns.format)(parsed, (0, _parseTokens.convertTokens)('ZZ'))
+    } : {
+      dateValue: dateValue,
+      timeValue: timeValue,
+      zoneValue: zoneValue
+    };
+  }, [providedParseValue, dateValue, timeValue, zoneValue]);
+  (0, _react.useEffect)(function () {
+    var parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    setDateValue(parsedValues.dateValue);
+    setTimeValue(parsedValues.timeValue);
+    setZoneValue(parsedValues.zoneValue);
+  }, [value, dateValue, timeValue, zoneValue, parseValue]);
+  var onDateBlur = function onDateBlur(event) {
+    setIsFocused(false);
+    onBlur(event);
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onBlur) {
+      datePickerPropsWithSelectProps.onBlur(event);
+    }
+  };
+  var onTimeBlur = function onTimeBlur(event) {
+    setIsFocused(false);
+    onBlur(event);
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onBlur) {
+      timePickerPropsWithSelectProps.onBlur(event);
+    }
+  };
+  var onDateFocus = function onDateFocus(event) {
+    setIsFocused(false);
+    onFocus(event);
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onFocus) {
+      datePickerPropsWithSelectProps.onFocus(event);
+    }
+  };
+  var onTimeFocus = function onTimeFocus(event) {
+    setIsFocused(false);
+    onFocus(event);
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onFocus) {
+      timePickerPropsWithSelectProps.onFocus(event);
+    }
+  };
+  var onDateChange = function onDateChange(dateValue) {
+    var parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    onValueChange({
+      providedDateValue: dateValue,
+      providedTimeValue: parsedValues.timeValue,
+      providedZoneValue: parsedValues.zoneValue
+    });
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onChange) {
+      datePickerPropsWithSelectProps.onChange(dateValue);
+    }
+  };
+  var onTimeChange = function onTimeChange(timeValue) {
+    var parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    onValueChange({
+      providedDateValue: parsedValues.dateValue,
+      providedTimeValue: timeValue,
+      providedZoneValue: parsedValues.zoneValue
+    });
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onChange) {
+      timePickerPropsWithSelectProps.onChange(timeValue);
+    }
+  };
+  var onClear = function onClear() {
+    var parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    onValueChange({
+      providedDateValue: '',
+      providedTimeValue: '',
+      providedZoneValue: parsedValues.zoneValue
+    });
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onChange) {
+      datePickerPropsWithSelectProps.onChange('');
+    }
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onChange) {
+      timePickerPropsWithSelectProps.onChange('');
+    }
+  };
+  var onChangePropWithAnalytics = (0, _analyticsNext.usePlatformLeafEventHandler)(_objectSpread({
+    fn: onChangeProp,
+    action: 'selectedDate',
+    actionSubject: 'datePicker'
+  }, analyticsAttributes));
+  var onValueChange = function onValueChange(_ref2) {
+    var providedDateValue = _ref2.providedDateValue,
+      providedTimeValue = _ref2.providedTimeValue,
+      providedZoneValue = _ref2.providedZoneValue;
+    setDateValue(providedDateValue);
+    setTimeValue(providedTimeValue);
+    setZoneValue(providedZoneValue);
+    if (providedDateValue && providedTimeValue) {
+      var _value2 = (0, _internal.formatDateTimeZoneIntoIso)(providedDateValue, providedTimeValue, providedZoneValue);
+      var _parseValue = parseValue(_value2, providedDateValue, providedTimeValue, providedZoneValue),
+        parsedZone = _parseValue.zoneValue;
+      var valueWithValidZone = (0, _internal.formatDateTimeZoneIntoIso)(providedDateValue, providedTimeValue, parsedZone);
+      setValue(valueWithValidZone);
+      onChangePropWithAnalytics(valueWithValidZone);
+      // If the date or time value was cleared when there is an existing datetime value, then clear the value.
+    } else if (value) {
+      setValue('');
+      onChangePropWithAnalytics('');
+    }
+  };
+  var datePickerSelectProps = datePickerPropsWithSelectProps.selectProps,
+    datePickerProps = (0, _objectWithoutProperties2.default)(datePickerPropsWithSelectProps, _excluded);
+  var datePickerAriaDescribedBy = datePickerProps['aria-describedby'] || ariaDescribedBy;
+  var datePickerLabel = datePickerProps.label || datePickerDefaultAriaLabel;
+  var mergedDatePickerSelectProps = _objectSpread(_objectSpread({}, datePickerSelectProps), {}, {
+    styles: (0, _select.mergeStyles)(styles, datePickerSelectProps === null || datePickerSelectProps === void 0 ? void 0 : datePickerSelectProps.styles)
+  });
+  var timePickerSelectProps = timePickerPropsWithSelectProps.selectProps,
+    timePickerProps = (0, _objectWithoutProperties2.default)(timePickerPropsWithSelectProps, _excluded2);
+  var timePickerAriaDescribedBy = timePickerProps['aria-describedby'] || ariaDescribedBy;
+  var timePickerLabel = timePickerProps.label || timePickerDefaultAriaLabel;
+  var mergedTimePickerSelectProps = _objectSpread(_objectSpread({}, timePickerSelectProps), {}, {
+    styles: (0, _select.mergeStyles)(styles, timePickerSelectProps === null || timePickerSelectProps === void 0 ? void 0 : timePickerSelectProps.styles)
+  });
+
+  // Render DateTimePicker's IconContainer when a value has been filled
+  // Don't use Date or TimePicker's because they can't be customised
+  var isClearable = Boolean(dateValue || timeValue);
+  return /*#__PURE__*/_react.default.createElement(_dateTimePickerContainer.DateTimePickerContainer, {
+    appearance: appearance,
+    isDisabled: isDisabled,
+    isFocused: isFocused,
+    isInvalid: isInvalid,
+    testId: testId,
+    innerProps: innerProps
+  }, /*#__PURE__*/_react.default.createElement("input", {
+    name: name,
+    type: "hidden",
+    value: value,
+    "data-testid": testId && "".concat(testId, "--input")
+  }), /*#__PURE__*/_react.default.createElement(_primitives.Box, {
+    xcss: datePickerContainerStyles
+  }, /*#__PURE__*/_react.default.createElement(_datePicker.default, {
+    appearance: appearance,
+    "aria-describedby": datePickerAriaDescribedBy,
+    autoFocus: datePickerProps.autoFocus || autoFocus,
+    dateFormat: datePickerProps.dateFormat,
+    defaultIsOpen: datePickerProps.defaultIsOpen,
+    defaultValue: datePickerProps.defaultValue,
+    disabled: datePickerProps.disabled,
+    disabledDateFilter: datePickerProps.disabledDateFilter,
+    formatDisplayLabel: datePickerProps.formatDisplayLabel,
+    hideIcon: datePickerProps.hideIcon || true,
+    icon: datePickerProps.icon,
+    id: datePickerProps.id || id,
+    innerProps: datePickerProps.innerProps,
+    inputLabel: datePickerProps.inputLabel,
+    inputLabelId: datePickerProps.inputLabelId,
+    isDisabled: datePickerProps.isDisabled || isDisabled,
+    isInvalid: datePickerProps.isInvalid || isInvalid,
+    isOpen: datePickerProps.isOpen,
+    isRequired: datePickerProps.isRequired || isRequired,
+    label: datePickerLabel,
+    locale: datePickerProps.locale || locale,
+    maxDate: datePickerProps.maxDate,
+    minDate: datePickerProps.minDate,
+    name: datePickerProps.name,
+    nextMonthLabel: datePickerProps.nextMonthLabel,
+    onBlur: onDateBlur,
+    onChange: onDateChange,
+    onFocus: onDateFocus,
+    openCalendarLabel: datePickerProps.openCalendarLabel,
+    parseInputValue: datePickerProps.parseInputValue,
+    placeholder: datePickerProps.placeholder,
+    previousMonthLabel: datePickerProps.previousMonthLabel,
+    selectProps: mergedDatePickerSelectProps,
+    shouldShowCalendarButton: datePickerProps.shouldShowCalendarButton,
+    spacing: datePickerProps.spacing || spacing,
+    testId: testId && "".concat(testId, "--datepicker") || datePickerProps.testId,
+    value: dateValue,
+    weekStartDay: datePickerProps.weekStartDay
+  })), /*#__PURE__*/_react.default.createElement(_primitives.Box, {
+    xcss: timePickerContainerStyles
+  }, /*#__PURE__*/_react.default.createElement(_timePicker.default, {
+    appearance: timePickerProps.appearance || appearance,
+    "aria-describedby": timePickerAriaDescribedBy,
+    autoFocus: timePickerProps.autoFocus,
+    defaultIsOpen: timePickerProps.defaultIsOpen,
+    defaultValue: timePickerProps.defaultValue,
+    formatDisplayLabel: timePickerProps.formatDisplayLabel,
+    hideIcon: timePickerProps.hideIcon || true,
+    id: timePickerProps.id,
+    innerProps: timePickerProps.innerProps,
+    isDisabled: timePickerProps.isDisabled || isDisabled,
+    isInvalid: timePickerProps.isInvalid || isInvalid,
+    isOpen: timePickerProps.isOpen,
+    isRequired: timePickerProps.isRequired || isRequired,
+    label: timePickerLabel,
+    locale: timePickerProps.locale || locale,
+    name: timePickerProps.name,
+    onBlur: onTimeBlur,
+    onChange: onTimeChange,
+    onFocus: onTimeFocus,
+    parseInputValue: timePickerProps.parseInputValue,
+    placeholder: timePickerProps.placeholder,
+    selectProps: mergedTimePickerSelectProps,
+    spacing: timePickerProps.spacing || spacing,
+    testId: timePickerProps.testId || testId && "".concat(testId, "--timepicker"),
+    timeFormat: timePickerProps.timeFormat,
+    timeIsEditable: timePickerProps.timeIsEditable,
+    times: timePickerProps.times,
+    value: timeValue
+  })), isClearable && !isDisabled ? /*#__PURE__*/_react.default.createElement(_primitives.Inline, {
+    xcss: iconContainerStyles
+  }, /*#__PURE__*/_react.default.createElement(_new.IconButton, {
+    appearance: "subtle",
+    label: clearControlLabel,
+    icon: function icon(iconProps) {
+      return /*#__PURE__*/_react.default.createElement(_crossCircleSelectClear.default, (0, _extends2.default)({}, iconProps, {
+        color: "var(--ds-text-subtlest, #626F86)",
+        LEGACY_size: "small"
+      }));
+    },
+    onClick: onClear,
+    testId: testId && "".concat(testId, "--icon--container"),
+    tabIndex: -1
+  })) : null);
+});
 var _default = exports.default = DateTimePicker;

package/dist/cjs/components/time-picker.js

@@ -27,7 +27,7 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var packageName = "@atlaskit/datetime-picker";
-var packageVersion = "15.12.1";
+var packageVersion = "15.13.0";
 var menuStyles = {
   /* Need to remove default absolute positioning as that causes issues with position fixed */
   position: 'static',
@@ -316,7 +316,7 @@ var TimePicker = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     onKeyDown: onSelectKeyDown
   }), /*#__PURE__*/_react.default.createElement(SelectComponent, (0, _extends2.default)({
     "aria-describedby": ariaDescribedBy,
-    "aria-label": label || undefined,
+    label: label || undefined,
     appearance: appearance,
     autoFocus: autoFocus,
     clearControlLabel: clearControlLabel,