carbon-react 101.2.0 → 101.3.3

package/lib/__internal__/checkable-input/checkable-input.component.js

@@ -19,6 +19,8 @@ var _hiddenCheckableInput = _interopRequireDefault(require("./hidden-checkable-i
 
 var _guid = _interopRequireDefault(require("../utils/helpers/guid"));
 
+var _useInputAccessibility = _interopRequireDefault(require("../../hooks/__internal__/useInputAccessibility"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
@@ -26,6 +28,7 @@ function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return
 function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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; }
 
 const CheckableInput = ({
+  ariaLabelledBy: externalAriaLabelledBy,
   autoFocus,
   checked,
   children,
@@ -58,16 +61,28 @@ const CheckableInput = ({
   const {
     current: id
   } = (0, _react.useRef)(inputId || (0, _guid.default)());
-  const labelId = label ? `${id}-label` : undefined;
-  const helpId = [error, warning, info, labelHelp].filter(validation => typeof validation === "string").length ? `${id}-help` : undefined;
-  const fieldHelpId = fieldHelp ? `${id}-field-help` : undefined;
+  const {
+    labelId,
+    tooltipId,
+    fieldHelpId,
+    ariaDescribedBy,
+    ariaLabelledBy
+  } = (0, _useInputAccessibility.default)({
+    id,
+    error,
+    warning,
+    info,
+    label,
+    labelHelp,
+    fieldHelp
+  });
   const isRadio = type === "radio";
   const formFieldProps = {
     disabled,
     error,
     fieldHelp,
     fieldHelpInline,
-    helpId,
+    tooltipId,
     fieldHelpId,
     id,
     info,
@@ -87,16 +102,16 @@ const CheckableInput = ({
     useValidationIcon: validationOnLabel
   };
   const inputProps = {
+    "aria-describedby": ariaDescribedBy,
+    "aria-labelledby": externalAriaLabelledBy || ariaLabelledBy,
+    "aria-invalid": !!error,
     autoFocus,
     checked,
     disabled,
-    helpId,
-    fieldHelpId,
     id,
     inputRef,
     type,
     value,
-    labelId,
     name,
     onBlur,
     onChange,
@@ -202,7 +217,10 @@ CheckableInput.propTypes = {
   })]),
 
   /** When true, displays validation icon on label */
-  validationOnLabel: _propTypes.default.bool
+  validationOnLabel: _propTypes.default.bool,
+
+  /** The id of the element that labels the input */
+  ariaLabelledBy: _propTypes.default.string
 };
 CheckableInput.defaultProps = {
   reverse: false,

package/lib/__internal__/checkable-input/checkable-input.d.ts

@@ -33,6 +33,8 @@ export interface CommonCheckableInputProps
   reverse?: boolean;
   /** Size of the component */
   size?: "small" | "large";
+  /** The id of the element that labels the input */
+  ariaLabelledBy?: string;
 }
 
 export interface CheckableInputProps extends CommonCheckableInputProps {

package/lib/__internal__/checkable-input/hidden-checkable-input.component.js

@@ -22,9 +22,6 @@ function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj;
 function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 
 const HiddenCheckableInput = ({
-  helpId,
-  fieldHelpId,
-  labelId,
   name,
   checked,
   type,
@@ -32,7 +29,6 @@ const HiddenCheckableInput = ({
   inputRef,
   onChange,
   autoFocus,
-  ariaLabelledBy,
   ...props
 }) => {
   const {
@@ -72,13 +68,10 @@ const HiddenCheckableInput = ({
     if (onMouseLeaveGroup) onMouseLeaveGroup(ev);
   };
 
-  const ariaDescribedBy = [fieldHelpId, helpId].filter(Boolean).join(" ");
   return /*#__PURE__*/_react.default.createElement(_hiddenCheckableInput.default, _extends({
     autoFocus: autoFocus,
     "aria-checked": checked,
     checked: checked,
-    "aria-labelledby": ariaLabelledBy || labelId,
-    "aria-describedby": ariaDescribedBy,
     name: name,
     role: type,
     type: type,
@@ -100,12 +93,6 @@ HiddenCheckableInput.propTypes = {
   /** Checked state of the input */
   checked: _propTypes.default.bool,
 
-  /** Element id for aria-describedby */
-  helpId: _propTypes.default.string,
-
-  /** Element id for aria-describedby */
-  fieldHelpId: _propTypes.default.string,
-
   /** Input name */
   name: _propTypes.default.string,
 
@@ -124,9 +111,6 @@ HiddenCheckableInput.propTypes = {
   /** OnMouseEnter event handler */
   onMouseEnter: _propTypes.default.func,
 
-  /** Element id for aria-labelledby */
-  labelId: _propTypes.default.string,
-
   /** HTML type attribute of the input */
   type: _propTypes.default.string.isRequired,
 
@@ -136,10 +120,7 @@ HiddenCheckableInput.propTypes = {
   /** A callback to retrieve the input reference */
   inputRef: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.shape({
     current: _propTypes.default.instanceOf(Element)
-  })]),
-
-  /** The id of the element that labels the input */
-  ariaLabelledBy: _propTypes.default.string
+  })])
 };
 
 var _default = /*#__PURE__*/_react.default.memo(HiddenCheckableInput);

package/lib/__internal__/checkable-input/hidden-checkable-input.d.ts

@@ -31,14 +31,6 @@ export interface HiddenCheckableInputProps
   extends CommonHiddenCheckableInputProps {
   /** HTML type attribute of the input */
   type: string;
-  /** Element id for aria-describedby */
-  helpId?: string;
-  /** Element id for aria-describedby */
-  fieldHelpId?: string;
-  /** Element id for aria-labelledby */
-  labelId?: string;
-  /** The id of the element that labels the input */
-  ariaLabelledBy?: string;
 }
 
 declare function HiddenCheckableInput(

package/lib/__internal__/form-field/form-field.component.js

@@ -43,7 +43,7 @@ const FormField = ({
   error,
   warning,
   info,
-  helpId,
+  tooltipId,
   fieldHelpId,
   helpTabIndex,
   label,
@@ -93,7 +93,7 @@ const FormField = ({
     warning: warning,
     info: info,
     help: labelHelp,
-    helpId: helpId,
+    tooltipId: tooltipId,
     helpTabIndex: helpTabIndex,
     htmlFor: id,
     helpIcon: labelHelpIcon,
@@ -128,7 +128,7 @@ FormField.propTypes = {
   error: errorPropType,
   warning: errorPropType,
   info: errorPropType,
-  helpId: _propTypes.default.string,
+  tooltipId: _propTypes.default.string,
   fieldHelpId: _propTypes.default.string,
   helpTabIndex: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
   id: _propTypes.default.string.isRequired,

package/lib/__internal__/form-field/form-field.d.ts

@@ -9,8 +9,8 @@ export interface CommonFormFieldPropTypes
   disabled?: boolean;
   /** Help content to be displayed under an input */
   fieldHelp?: React.ReactNode;
-  /** The unique id of the Help component */
-  helpId?: string;
+  /** The unique id of the Help component tooltip, used for accessibility */
+  tooltipId?: string;
   /** The unique id of the FieldHelp component */
   fieldHelpId?: string;
   /** Overrides the default tabindex of the Help component */

package/lib/__internal__/input-icon-toggle/input-icon-toggle.component.js

@@ -40,7 +40,8 @@ const InputIconToggle = ({
   info,
   useValidationIcon,
   align,
-  iconTabIndex
+  iconTabIndex,
+  tooltipId
 }) => {
   if (useValidationIcon && !disabled && shouldDisplayValidationIcon({
     error,
@@ -59,6 +60,7 @@ const InputIconToggle = ({
       onBlur: onBlur,
       isPartOfInput: true,
       tabIndex: iconTabIndex,
+      tooltipId: tooltipId,
       tooltipPosition: align === "right" ? "left" : "right"
     }));
   }
@@ -72,7 +74,8 @@ const InputIconToggle = ({
       onMouseDown: onMouseDown,
       tabIndex: iconTabIndex
     }, /*#__PURE__*/_react.default.createElement(_icon.default, {
-      type: type
+      type: type,
+      tooltipId: tooltipId
     }));
   }
 
@@ -93,7 +96,8 @@ InputIconToggle.propTypes = {
   size: _propTypes.default.oneOf(["small", "medium", "large"]),
   align: _propTypes.default.oneOf(["left", "right"]),
   useValidationIcon: _propTypes.default.bool,
-  iconTabIndex: _propTypes.default.number
+  iconTabIndex: _propTypes.default.number,
+  tooltipId: _propTypes.default.string
 };
 var _default = InputIconToggle;
 exports.default = _default;

package/lib/__internal__/input-icon-toggle/input-icon-toggle.d.ts

@@ -15,6 +15,7 @@ export interface InputIconToggleProps {
   align?: "left" | "right";
   useValidationIcon?: boolean;
   iconTabIndex?: number;
+  tooltipId?: string;
 }
 declare function InputIconToggle(props: InputIconToggleProps): JSX.Element;
 

package/lib/__internal__/label/label.component.js

@@ -51,7 +51,7 @@ const Label = ({
   width,
   optional,
   labelId,
-  helpId,
+  tooltipId,
   children,
   error,
   warning,
@@ -104,7 +104,7 @@ const Label = ({
         inline
       });
       return /*#__PURE__*/_react.default.createElement(_iconWrapper.default, null, /*#__PURE__*/_react.default.createElement(_validationIcon.default, {
-        iconId: helpId,
+        tooltipId: tooltipId,
         error: error,
         warning: warning,
         info: info,
@@ -114,7 +114,7 @@ const Label = ({
     }
 
     return help && /*#__PURE__*/_react.default.createElement(_iconWrapper.default, wrapperProps, /*#__PURE__*/_react.default.createElement(_help.default, {
-      helpId: helpId,
+      tooltipId: tooltipId,
       tabIndex: helpTabIndex,
       type: helpIcon,
       isFocused: isFocused
@@ -158,8 +158,8 @@ Label.propTypes = {
   /** The unique id of the label element */
   labelId: _propTypes.default.string,
 
-  /** The unique id of the Help component */
-  helpId: _propTypes.default.string,
+  /** The unique id of the Help component tooltip, used for accessibility */
+  tooltipId: _propTypes.default.string,
 
   /** Children elements */
   children: _propTypes.default.node,

package/lib/__internal__/label/label.d.ts

@@ -16,8 +16,8 @@ export interface LabelPropTypes extends ValidationPropTypes {
   optional?: boolean;
   /** The unique id of the label element */
   labelId?: string;
-  /** The unique id of the Help component */
-  helpId?: string;
+  /** The unique id of the Help component tooltip, used for accessibility */
+  tooltipId?: string;
   /** Children elements */
   children?: React.ReactNode;
   /** A message that the Help component will display */

package/lib/__internal__/validations/validation-icon.component.js

@@ -48,6 +48,7 @@ const ValidationIcon = ({
   onFocus,
   onBlur,
   iconId,
+  tooltipId,
   isPartOfInput,
   tabIndex,
   onClick,
@@ -95,6 +96,7 @@ const ValidationIcon = ({
     key: `${validationType}-icon`,
     type: validationType,
     tabIndex: tabIndex,
+    tooltipId: tooltipId,
     tooltipMessage: validationMessage,
     tooltipPosition: tooltipPosition,
     tooltipVisible: hasFocus || hasMouseOver || groupHasFocus || groupHasMouseOver || triggeredByIcon,
@@ -130,6 +132,9 @@ ValidationIcon.propTypes = { ...marginPropTypes,
     `The \`${propName}\` prop supplied to \`${componentName}\` must be an array containing some or all of ["top", "bottom", "left", "right"].`);
   },
 
+  /** Id passed to the tooltip container, used for accessibility purposes. */
+  tooltipId: _propTypes.default.string,
+
   /** An onClick handler */
   onClick: _propTypes.default.func,
 

package/lib/__internal__/validations/validation-icon.d.ts

@@ -15,6 +15,8 @@ export interface ValidationIconProps extends ValidationPropTypes {
    * (see https://popper.js.org/docs/v2/modifiers/flip/#fallbackplacements)
    */
   tooltipFlipOverrides?: ["top" | "bottom" | "left" | "right"];
+  /** Id passed to the tooltip container, used for accessibility purposes */
+  tooltipId?: string;
   /** An onClick handler */
   onClick?: (ev: React.MouseEvent<HTMLElement>) => void;
   /** An onBlur handler */

package/lib/components/flat-table/flat-table.component.js

@@ -39,6 +39,7 @@ const FlatTable = ({
   hasMaxHeight = false,
   ariaDescribedby,
   minHeight,
+  overflowX,
   ...rest
 }) => {
   const addDefaultHeight = !height && (hasStickyHead || hasStickyFooter);
@@ -57,16 +58,18 @@ const FlatTable = ({
   }) => /*#__PURE__*/_react.default.createElement(_flatTable.StyledFlatTableWrapper, _extends({
     isInSidebar: isInSidebar,
     hasStickyHead: hasStickyHead,
-    colorTheme: colorTheme
-  }, rest, {
+    colorTheme: colorTheme,
     minHeight: minHeight,
     overflowY: !isInSidebar && (hasStickyHead || hasStickyFooter) ? "auto" : undefined,
     height: addDefaultHeight && !hasMaxHeight ? "99%" : height,
     maxHeight: hasMaxHeight ? "100%" : undefined,
     display: "flex",
     flexDirection: "column",
-    justifyContent: hasStickyFooter || height ? "space-between" : undefined
-  }), /*#__PURE__*/_react.default.createElement(_flatTable.StyledFlatTable, _extends({
+    justifyContent: hasStickyFooter || height ? "space-between" : undefined,
+    tabIndex: "0",
+    role: "region",
+    overflowX: overflowX
+  }, rest), /*#__PURE__*/_react.default.createElement(_flatTable.StyledFlatTable, _extends({
     "data-component": "flat-table"
   }, tableStylingProps), caption ? /*#__PURE__*/_react.default.createElement("caption", null, caption) : null, /*#__PURE__*/_react.default.createElement(FlatTableThemeContext.Provider, {
     value: {
@@ -114,7 +117,10 @@ FlatTable.propTypes = { ...marginPropTypes,
   size: _propTypes.default.oneOf(["compact", "small", "medium", "large", "extraLarge"]),
 
   /** Applies max-height of 100% to FlatTable if true */
-  hasMaxHeight: _propTypes.default.bool
+  hasMaxHeight: _propTypes.default.bool,
+
+  /** Set the overflow X of the table wrapper. Any valid CSS string */
+  overflowX: _propTypes.default.string
 };
 FlatTable.defaultProps = {
   colorTheme: "dark",

package/lib/components/flat-table/flat-table.style.js

@@ -107,6 +107,18 @@ const StyledFlatTableWrapper = (0, _styledComponents.default)(_box.default)`
 }) => (0, _styledComponents.css)`
       box-sizing: border-box;
 
+      :focus {
+        outline: 2px solid ${theme.colors.focus};
+
+        :not(:focus-visible) {
+          outline: none;
+        }
+
+        :focus-visible {
+          outline: 2px solid ${theme.colors.focus};
+        }
+      }
+
       ${isInSidebar ? "min-width: fit-content" : `box-shadow: inset 0px 0px 0px 1px ${theme.table.secondary}`};
     `}
 

package/lib/components/help/help.component.js

@@ -45,6 +45,7 @@ const Help = ({
   tooltipPosition,
   isFocused,
   type,
+  tooltipId,
   tooltipBgColor,
   tooltipFontColor,
   tooltipFlipOverrides,
@@ -107,6 +108,7 @@ const Help = ({
     tooltipFontColor: tooltipFontColor,
     tooltipFlipOverrides: tooltipFlipOverrides,
     focusable: false,
+    tooltipId: tooltipId,
     "aria-hidden": "true"
   }, href && {
     role: "tooltip",
@@ -122,7 +124,7 @@ Help.propTypes = { ...marginPropTypes,
   /** Message to display in tooltip */
   children: _propTypes.default.node,
 
-  /** The unique id of the component (used with aria-describedby for accessibility) */
+  /** The unique id of the component */
   helpId: _propTypes.default.string,
 
   /** Overrides the default tabindex of the component */
@@ -166,6 +168,9 @@ Help.propTypes = { ...marginPropTypes,
     `The \`${propName}\` prop supplied to \`${componentName}\` must be an array containing some or all of ["top", "bottom", "left", "right"].`);
   },
 
+  /** Id passed to the tooltip container, used for accessibility purposes. */
+  tooltipId: _propTypes.default.string,
+
   /** Aria label */
   ariaLabel: _propTypes.default.string
 };

package/lib/components/help/help.d.ts

@@ -28,6 +28,8 @@ export interface HelpProps extends MarginProps {
   tooltipFlipOverrides?: ["top" | "bottom" | "left" | "right"];
   /** Position of tooltip relative to target */
   tooltipPosition?: "top" | "bottom" | "left" | "right";
+  /** Id passed to the tooltip container, used for accessibility purposes */
+  tooltipId?: string;
   /** Help Icon type */
   type?: IconType;
   /** Aria label */

package/lib/components/icon/icon.component.js

@@ -48,6 +48,7 @@ const Icon = /*#__PURE__*/_react.default.forwardRef(({
   tooltipBgColor,
   tooltipFontColor,
   tooltipFlipOverrides,
+  tooltipId,
   tabIndex,
   isPartOfInput,
   inputSize,
@@ -122,6 +123,7 @@ const Icon = /*#__PURE__*/_react.default.forwardRef(({
       message: tooltipMessage,
       position: tooltipPositionFromContext || tooltipPosition,
       type: type,
+      id: tooltipId,
       isVisible: visible,
       isPartOfInput: isPartOfInput,
       inputSize: inputSize,
@@ -186,6 +188,9 @@ Icon.propTypes = { ...marginPropTypes,
   /** Override font color of the Tooltip, provide any color from palette or any valid css color value. */
   tooltipFontColor: _propTypes.default.string,
 
+  /** Id passed to the tooltip container, used for accessibility purposes. */
+  tooltipId: _propTypes.default.string,
+
   /** Overrides the default flip behaviour of the Tooltip, must be an array containing some or all of ["top", "bottom", "left", "right"].
    *
    *  See the Popper [documentation](https://popper.js.org/docs/v2/modifiers/flip/#fallbackplacements) for more information

package/lib/components/icon/icon.d.ts

@@ -233,6 +233,8 @@ export interface IconProps extends MarginProps {
   tooltipFontColor?: string;
   /** Overrides the default flip behaviour of the Tooltip */
   tooltipFlipOverrides?: TooltipPositions[];
+  /** Id passed to the tooltip container, used for accessibility purposes */
+  tooltipId?: string;
 }
 
 declare function Icon(

package/lib/components/search/search.component.js

@@ -54,6 +54,7 @@ const Search = ({
   variant = "default",
   "aria-label": ariaLabel = "search",
   inputRef,
+  tabIndex,
   ...rest
 }) => {
   const isControlled = value !== undefined;
@@ -173,7 +174,8 @@ const Search = ({
     onBlur: onBlur,
     onChange: onChange,
     onKeyDown: onKeyDown,
-    inputRef: assignInput
+    inputRef: assignInput,
+    tabIndex: tabIndex
   }), searchButton && /*#__PURE__*/_react.default.createElement(_search.StyledSearchButton, null, Boolean(isFocused || (!isControlled ? searchValue.length : value.length)) && /*#__PURE__*/_react.default.createElement(_button.default, _extends({
     tabIndex: iconTabIndex,
     size: "medium",
@@ -249,7 +251,10 @@ Search.propTypes = {
    */
   inputRef: _propTypes.default.shape({
     current: _propTypes.default.instanceOf(Element)
-  })
+  }),
+
+  /** Input tabindex */
+  tabIndex: _propTypes.default.number
 };
 var _default = Search;
 exports.default = _default;

package/lib/components/search/search.d.ts

@@ -40,6 +40,8 @@ export interface SearchProps extends MarginProps {
   variant?: string;
   /** A callback to retrieve the input reference */
   inputRef?: React.RefObject<HTMLInputElement>;
+  /** Input tabindex */
+  tabIndex?: number;
 }
 
 declare function Search(props: SearchProps): JSX.Element;

package/lib/components/tabs/__internal__/tab-title/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./tab-title";

package/lib/components/tabs/__internal__/tab-title/tab-title.component.js

@@ -52,6 +52,7 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
   isInSidebar,
   href,
   onKeyDown,
+  align,
   ...tabTitleProps
 }, ref) => {
   const keys = (0, _react.useRef)([]);
@@ -74,6 +75,8 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
   };
 
   const handleClick = ev => {
+    var _ref$current;
+
     ev.preventDefault();
     const customEvent = { ...ev,
       target: { ...ev.target,
@@ -86,8 +89,10 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
     if (href) {
       onClick(customEvent);
       return window.open(href, "_blank");
-    }
+    } // safari does not focus buttons by default
 
+
+    (_ref$current = ref.current) === null || _ref$current === void 0 ? void 0 : _ref$current.focus();
     return onClick(customEvent);
   };
 
@@ -131,18 +136,17 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
     error: error,
     warning: warning,
     info: info,
-    size: size,
     noRightBorder: noRightBorder,
     alternateStyling: alternateStyling || isInSidebar,
     borders: borders,
     isInSidebar: isInSidebar
-  }, tabTitleProps, (0, _tags.default)("tab-header", tabTitleProps), {
-    onKeyDown: handleKeyDown
-  }), /*#__PURE__*/_react.default.createElement(_tabTitle.StyledTitleContent, _extends({}, isHref && {
+  }, tabTitleProps, isHref && {
     href,
     target: "_blank",
     as: "a"
-  }, {
+  }, (0, _tags.default)("tab-header", tabTitleProps), {
+    onKeyDown: handleKeyDown
+  }), /*#__PURE__*/_react.default.createElement(_tabTitle.StyledTitleContent, {
     error: error,
     warning: warning,
     info: info,
@@ -155,23 +159,29 @@ const TabTitle = /*#__PURE__*/_react.default.forwardRef(({
     hasSiblings: !!siblings,
     isTabSelected: isTabSelected,
     hasCustomLayout: !!customLayout,
-    alternateStyling: hasAlternateStyling
-  }), renderContent(), isHref && /*#__PURE__*/_react.default.createElement(_icon.default, {
+    alternateStyling: hasAlternateStyling,
+    align: align,
+    hasHref: !!href
+  }, renderContent(), isHref && /*#__PURE__*/_react.default.createElement(_icon.default, {
     type: "link"
-  }), /*#__PURE__*/_react.default.createElement(_tabTitle.StyledLayoutWrapper, {
+  }), hasFailedValidation && /*#__PURE__*/_react.default.createElement(_tabTitle.StyledLayoutWrapper, {
+    position: position,
     hasCustomSibling: !!customLayout
   }, error && /*#__PURE__*/_react.default.createElement(_validationIcon.default, {
     onClick: handleClick,
     tooltipPosition: "top",
-    error: errorMessage
+    error: errorMessage,
+    tabIndex: null
   }), !error && warning && /*#__PURE__*/_react.default.createElement(_validationIcon.default, {
     onClick: handleClick,
     tooltipPosition: "top",
-    warning: warningMessage
+    warning: warningMessage,
+    tabIndex: null
   }), !warning && !error && info && /*#__PURE__*/_react.default.createElement(_validationIcon.default, {
     onClick: handleClick,
     tooltipPosition: "top",
-    info: infoMessage
+    info: infoMessage,
+    tabIndex: null
   }))), !(hasFailedValidation || hasAlternateStyling) && isTabSelected && /*#__PURE__*/_react.default.createElement(_tabTitle.StyledSelectedIndicator, {
     "data-element": "tab-selected-indicator",
     position: position,
@@ -204,7 +214,8 @@ TabTitle.propTypes = {
   noRightBorder: _propTypes.default.bool,
   customLayout: _propTypes.default.node,
   isInSidebar: _propTypes.default.bool,
-  href: _propTypes.default.string
+  href: _propTypes.default.string,
+  align: _propTypes.default.oneOf(["left", "right"])
 };
 var _default = TabTitle;
 exports.default = _default;

package/lib/components/tabs/__internal__/tab-title/tab-title.d.ts

@@ -0,0 +1,39 @@
+import * as React from "react";
+
+export interface TabTitleProps {
+  title: string;
+  id?: string;
+  dataTabId?: string;
+  className?: string;
+  children?: React.ReactNode;
+  isTabSelected?: boolean;
+  position?: "top" | "left";
+  errorMessage?: string;
+  warningMessage?: string;
+  infoMessage?: string;
+  errors?: boolean;
+  warning?: boolean;
+  info?: boolean;
+  borders?: boolean;
+  noLeftBorder?: boolean;
+  noRightBorder?: boolean;
+  alternateStyling?: boolean;
+  isInSidebar?: boolean;
+  siblings?: React.ReactNode[];
+  titlePosition?: "before" | "after";
+  href?: string;
+  tabIndex?: string;
+  size?: "default" | "large";
+  align?: "left" | "right";
+  customLayout?: React.ReactNode;
+  onClick?: (
+    ev: React.MouseEvent<HTMLButtonElement | HTMLAnchorElement>
+  ) => void;
+  onKeyDown?: (
+    ev: React.KeyboardEvent<HTMLButtonElement | HTMLAnchorElement>
+  ) => void;
+}
+
+declare function TabTitle(props: TabTitleProps): JSX.Element;
+
+export default TabTitle;

package/lib/components/tabs/__internal__/tab-title/tab-title.style.js

@@ -21,8 +21,9 @@ function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return
 
 function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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; }
 
-const StyledTitleContent = _styledComponents.default.div`
+const StyledTitleContent = _styledComponents.default.span`
   outline: none;
+  display: inline-block;
 
   ${({
   theme,
@@ -32,17 +33,22 @@ const StyledTitleContent = _styledComponents.default.div`
   noLeftBorder,
   noRightBorder,
   isTabSelected,
-  hasSiblings,
-  href,
+  hasHref,
   error,
-  warning,
-  info,
-  alternateStyling
+  alternateStyling,
+  align
 }) => (0, _styledComponents.css)`
     line-height: 20px;
     margin: 0;
+    text-align: ${align};
+
+    ${position === "left" && (0, _styledComponents.css)`
+      display: flex;
+      width: 100%;
+      justify-content: ${align === "right" ? "flex-end" : "flex-start"};
+    `}
 
-    ${href && (0, _styledComponents.css)`
+    ${hasHref && (0, _styledComponents.css)`
       color: ${theme.text.color};
       display: block;
       text-decoration: none;
@@ -81,10 +87,8 @@ const StyledTitleContent = _styledComponents.default.div`
 
     ${size === "large" && position === "top" && (0, _styledComponents.css)`
       padding: 10px 24px;
+      ${borders && `padding-bottom: 9px;`}
       font-size: 16px;
-      ${isTabSelected && !hasSiblings && !(error || warning || info) && (0, _styledComponents.css)`
-        padding-bottom: 6px;
-      `}
     `}
 
     ${size === "large" && position === "left" && (0, _styledComponents.css)`
@@ -95,11 +99,12 @@ const StyledTitleContent = _styledComponents.default.div`
 
     ${size === "default" && (0, _styledComponents.css)`
       padding: 10px 16px;
-      ${isTabSelected && !(error || warning || info) && position === "top" && (0, _styledComponents.css)`
-        padding-bottom: 8px;
-      `}
 
-      ${position === "left" && !isTabSelected && !alternateStyling && error && `margin-right: -2px;`}
+      ${borders && `padding-bottom: 9px;`}
+
+      ${position === "left" && !isTabSelected && !alternateStyling && error && `
+        margin-right: -2px;
+      `}
     `}
   `}
 
@@ -131,7 +136,7 @@ const StyledTitleContent = _styledComponents.default.div`
         padding-right: ${size === "large" ? "26px;" : "18px;"};
       `}
       
-    &:hover {
+      &:hover {
         outline: 1px solid;
         outline-offset: -1px;
 
@@ -174,10 +179,10 @@ const StyledTitleContent = _styledComponents.default.div`
 
       ${position === "left" && (0, _styledComponents.css)`
         border-right-color: transparent;
-        padding-right: ${size === "large" ? "26px;" : "18px;"};
+        padding-right: ${size === "large" ? "26px" : "18px"};
       `}
     
-    &:hover {
+      &:hover {
         outline: 2px solid ${theme.colors.error};
         outline-offset: -2px;
         ${position === "top" && (0, _styledComponents.css)`
@@ -190,7 +195,7 @@ const StyledTitleContent = _styledComponents.default.div`
 
         ${position === "left" && (0, _styledComponents.css)`
           border-right-color: transparent;
-          padding-right: ${size === "large" ? "26px;" : "18px;"};
+          padding-right: ${size === "large" ? "26px" : "18px"};
         `}
       }
     `}
@@ -206,23 +211,11 @@ const StyledTitleContent = _styledComponents.default.div`
   position
 }) => hasSiblings && !hasCustomLayout && position === "top" && (0, _styledComponents.css)`
       height: 20px;
+      padding-top: 10px;
+      padding-bottom: 10px;
 
-      ${size === "default" && (0, _styledComponents.css)`
-        padding-top: 10px;
-        padding-bottom: 10px;
-
-        ${!(error || warning || info) && isTabSelected && (0, _styledComponents.css)`
-          padding-bottom: 8px;
-        `}
-      `}
-
-      ${size === "large" && (0, _styledComponents.css)`
-        padding-top: 10px;
-        padding-bottom: 10px;
-
-        ${!(error || warning || info) && isTabSelected && (0, _styledComponents.css)`
-          padding-bottom: 6px;
-        `}
+      ${size === "large" && !(error || warning || info) && isTabSelected && (0, _styledComponents.css)`
+        padding-bottom: 6px;
       `}
     `}
 
@@ -238,13 +231,13 @@ const StyledTitleContent = _styledComponents.default.div`
       display: flex;
 
       ${position === "left" && (0, _styledComponents.css)`
-        padding: ${size === "large" ? "2px;" : "0px;"}
-          ${isTabSelected && (0, _styledComponents.css)`
-            padding-right: 0px;
-          `}
-          ${(error || warning || info) && (0, _styledComponents.css)`
-            padding-right: ${size === "large" ? "26px" : "18px"};
-          `};
+        padding: ${size === "large" ? "2px" : "0px"};
+        ${isTabSelected && (0, _styledComponents.css)`
+          padding-right: 0px;
+        `}
+        ${(error || warning || info) && (0, _styledComponents.css)`
+          padding-right: ${size === "large" ? "26px" : "18px"};
+        `}
       `}
 
       ${position === "top" && (0, _styledComponents.css)`
@@ -253,49 +246,63 @@ const StyledTitleContent = _styledComponents.default.div`
             padding-bottom: 0px;
           `}
           ${(error || warning || info) && (0, _styledComponents.css)`
-        padding-bottom: ${size === "large" ? "4px;" : "2px;"}
-        padding-right: ${size === "large" ? "18px;" : "14px;"}
-
-        &:hover {
           padding-bottom: ${size === "large" ? "4px;" : "2px;"}
-        }
-      `};
+          padding-right: ${size === "large" ? "18px;" : "14px;"}
+
+          &:hover {
+            padding-bottom: ${size === "large" ? "4px;" : "2px;"}
+          }
+        `};
       `}
     `}
 `;
 exports.StyledTitleContent = StyledTitleContent;
-const StyledTabTitle = _styledComponents.default.li`
+const StyledTabTitle = _styledComponents.default.button`
   background-color: transparent;
   display: inline-block;
   font-weight: bold;
-  height: 100%;
   position: relative;
+  border: none;
+  cursor: pointer;
+  font-size: 14px;
+  padding: 0px;
+  text-decoration: none;
+  outline-offset: 0px;
+  margin: 0;
+
+  a:visited {
+    color: inherit;
+  }
 
   ${({
   position,
   borders,
   noRightBorder,
   noLeftBorder
-}) => `
-      ${position === "top" && (0, _styledComponents.css)`
-          ${borders && !(noRightBorder || noLeftBorder) && (0, _styledComponents.css)`
-            &:not(:first-of-type) {
-              margin-left: -1px;
-            }
-          `}
-        `}
-      ${position === "left" && (0, _styledComponents.css)`
-          ${borders && (0, _styledComponents.css)`
-            &:not(:first-of-type) {
-              margin-top: -1px;
-            }
-          `}
-        `}
-    `}
+}) => (0, _styledComponents.css)`
+    ${position === "top" && (0, _styledComponents.css)`
+      height: 40px;
 
-  &:first-child {
-    margin-left: 0;
-  }
+      ${borders && !(noRightBorder || noLeftBorder) && (0, _styledComponents.css)`
+        &:nth-of-type(n + 1) {
+          margin-left: -1px;
+        }
+        &:first-child {
+          margin-left: 0;
+        }
+      `}
+    `}
+    ${position === "left" && (0, _styledComponents.css)`
+      ${borders && (0, _styledComponents.css)`
+        &:nth-of-type(n + 1) {
+          margin-top: -1px;
+        }
+        &:first-child {
+          margin-top: 0;
+        }
+      `}
+    `}
+  `}
 
   ${({
   isTabSelected,
@@ -319,27 +326,12 @@ const StyledTabTitle = _styledComponents.default.li`
   error,
   warning,
   info,
-  size,
-  isInSidebar,
-  position
+  isInSidebar
 }) => isTabSelected && (0, _styledComponents.css)`
     ${!isInSidebar && "z-index: 1;"}
     color: ${theme.text.color};
     background-color: ${theme.colors.white};
 
-    ${alternateStyling && (0, _styledComponents.css)`
-        border-bottom: 2px solid ${theme.tab.background};
-      `}
-
-    ${!alternateStyling && (0, _styledComponents.css)`
-        padding-bottom: 2px;
-      `}
-
-    ${size === "large" && (0, _styledComponents.css)`
-        ${position === "top" && `
-          padding-bottom: ${alternateStyling ? "3px" : "4px"};
-          `}
-      `}
     ${(error || warning || info) && (0, _styledComponents.css)`
         padding-bottom: 0px;
       `}
@@ -364,7 +356,6 @@ const StyledTabTitle = _styledComponents.default.li`
   
   ${({
   position,
-  size,
   borders,
   theme,
   alternateStyling,
@@ -387,7 +378,7 @@ const StyledTabTitle = _styledComponents.default.li`
         }
       `}
 
-      display: block;
+      display: flex;
       height: auto;
       margin-left: 0px;
 
@@ -422,12 +413,6 @@ const StyledTabTitle = _styledComponents.default.li`
     
           background-color: ${theme.colors.white};
 
-          ${size === "large" && (0, _styledComponents.css)`
-            & ${StyledTitleContent} {
-              padding-right: 22px;
-            }
-          `}
-
           &:hover {
             ${alternateStyling && ` border-right-color: ${theme.tab.background};`}
             background-color: ${theme.colors.white};
@@ -473,7 +458,8 @@ const StyledLayoutWrapper = _styledComponents.default.div`
   ${({
   hasCustomLayout,
   titlePosition,
-  hasCustomSibling
+  hasCustomSibling,
+  position
 }) => !hasCustomLayout && (0, _styledComponents.css)`
       display: inline-flex;
 
@@ -500,7 +486,7 @@ const StyledLayoutWrapper = _styledComponents.default.div`
         ${_icon.default} {
           height: 16px;
           left: -2px;
-          top: 3px;
+          top: ${position === "left" ? "1px" : "3px"};
         }
       }
     `}

package/lib/components/tabs/__internal__/tabs-header/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./tab-header";

package/lib/components/tabs/__internal__/tabs-header/tab-header.d.ts

@@ -0,0 +1,16 @@
+import * as React from "react";
+
+export interface TabHeaderProps {
+  role?: string;
+  position?: "top" | "left";
+  extendedLine?: boolean;
+  noRightBorder?: boolean;
+  alternateStyling?: boolean;
+  isInSidebar?: boolean;
+  children: React.ReactNode;
+  align?: "left" | "right";
+}
+
+declare function TabHeader(props: TabHeaderProps): JSX.Element;
+
+export default TabHeader;

package/lib/components/tabs/__internal__/tabs-header/tabs-header.style.js

@@ -50,7 +50,7 @@ const StyledTabsHeaderWrapper = _styledComponents.default.div`
     `}
 `;
 exports.StyledTabsHeaderWrapper = StyledTabsHeaderWrapper;
-const StyledTabsHeaderList = _styledComponents.default.ul`
+const StyledTabsHeaderList = _styledComponents.default.div`
   display: flex;
   box-shadow: inset 0px ${computeLineWidth} 0px 0px
     ${({

package/lib/components/tabs/tabs.component.js

@@ -249,6 +249,7 @@ const Tabs = ({
         noRightBorder: ["no right side", "no sides"].includes(borders),
         customLayout: customLayout,
         isInSidebar: isInSidebar,
+        align: align,
         onFocus: () => {
           if (!hasTabStop(tabId)) {
             setTabStopId(tabId);

package/lib/components/textarea/textarea.component.js

@@ -33,6 +33,8 @@ var _i18nContext = _interopRequireDefault(require("../../__internal__/i18n-conte
 
 var _tooltipProvider = require("../../__internal__/tooltip-provider");
 
+var _useInputAccessibility = _interopRequireDefault(require("../../hooks/__internal__/useInputAccessibility"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function () { return cache; }; return cache; }
@@ -101,6 +103,21 @@ const Textarea = ({
     }
   };
 
+  const {
+    labelId,
+    tooltipId,
+    fieldHelpId,
+    ariaDescribedBy,
+    ariaLabelledBy
+  } = (0, _useInputAccessibility.default)({
+    id,
+    error,
+    warning,
+    info,
+    label,
+    labelHelp,
+    fieldHelp
+  });
   (0, _react.useEffect)(() => {
     if (expandable) {
       expandTextarea();
@@ -146,10 +163,12 @@ const Textarea = ({
     "data-element": dataElement
   }, (0, _utils.filterStyledSystemMarginProps)(props)), /*#__PURE__*/_react.default.createElement(_formField.default, {
     fieldHelp: fieldHelp,
+    fieldHelpId: fieldHelpId,
     error: error,
     warning: warning,
     info: info,
     label: label,
+    labelId: labelId,
     disabled: disabled,
     id: id,
     labelInline: labelInline,
@@ -157,6 +176,7 @@ const Textarea = ({
     labelWidth: labelWidth,
     labelHelp: labelHelp,
     labelSpacing: labelSpacing,
+    tooltipId: tooltipId,
     isRequired: props.required,
     useValidationIcon: validationOnLabel,
     adaptiveLabelBreakpoint: adaptiveLabelBreakpoint
@@ -169,9 +189,11 @@ const Textarea = ({
     warning: warning,
     info: info
   }, /*#__PURE__*/_react.default.createElement(_input2.default, _extends({
+    "aria-invalid": !!error,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-describedby": ariaDescribedBy,
     autoFocus: autoFocus,
     name: name,
-    "aria-invalid": !!error,
     ref: inputRef,
     maxLength: enforceCharacterLimit && characterLimit ? characterLimit : undefined,
     onChange: onChange,

package/lib/components/textbox/textbox.component.js

@@ -29,6 +29,8 @@ var _tooltipProvider = require("../../__internal__/tooltip-provider");
 
 var _useCharacterCount = _interopRequireDefault(require("../../hooks/__internal__/useCharacterCount"));
 
+var _useInputAccessibility = _interopRequireDefault(require("../../hooks/__internal__/useInputAccessibility/useInputAccessibility"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
@@ -42,7 +44,7 @@ const Textbox = ({
   disabled,
   inputIcon,
   leftChildren,
-  labelId,
+  labelId: externalLabelId,
   label,
   labelAlign,
   labelHelp,
@@ -90,12 +92,29 @@ const Textbox = ({
   ...props
 }) => {
   const [maxLength, characterCount] = (0, _useCharacterCount.default)(value, characterLimit, warnOverLimit, enforceCharacterLimit);
+  const {
+    labelId: internalLabelId,
+    tooltipId,
+    fieldHelpId,
+    ariaDescribedBy
+  } = (0, _useInputAccessibility.default)({
+    id,
+    error,
+    warning,
+    info,
+    label,
+    labelHelp,
+    fieldHelp
+  });
+  const labelId = externalLabelId || internalLabelId;
   return /*#__PURE__*/_react.default.createElement(_tooltipProvider.TooltipProvider, {
     helpAriaLabel: helpAriaLabel,
     tooltipPosition: tooltipPosition
   }, /*#__PURE__*/_react.default.createElement(_inputBehaviour.InputBehaviour, null, /*#__PURE__*/_react.default.createElement(_formField.default, _extends({
+    tooltipId: tooltipId,
     disabled: disabled,
     fieldHelp: fieldHelp,
+    fieldHelpId: fieldHelpId,
     error: error,
     warning: warning,
     info: info,
@@ -132,6 +151,8 @@ const Textbox = ({
   }, {
     align: align,
     "aria-invalid": !!error,
+    "aria-labelledby": labelId,
+    "aria-describedby": ariaDescribedBy,
     autoFocus: autoFocus,
     deferTimeout: deferTimeout,
     disabled: disabled,
@@ -160,7 +181,8 @@ const Textbox = ({
     readOnly: readOnly,
     size: size,
     useValidationIcon: !validationOnLabel,
-    warning: warning
+    warning: warning,
+    tooltipId: tooltipId
   }))), characterCount));
 };
 

package/lib/hooks/__internal__/useInputAccessibility/index.d.ts

@@ -0,0 +1,24 @@
+interface InputAccessibilityProperties {
+  labelId?: string;
+  tooltipId?: string;
+  fieldHelpId?: string;
+  ariaDescribedBy?: string;
+  ariaLabelledBy?: string;
+}
+
+export default function useInputAccessibility(
+  /** Input id -  */
+  id: string,
+  /** Error validation message */
+  error?: string,
+  /** Warning validation message */
+  warning?: string,
+  /** Info validation message */
+  info?: string,
+  /** Label */
+  label?: string,
+  /** labelHelp message */
+  labelHelp?: string,
+  /** fieldHelp message */
+  fieldHelp?: string
+): void;

package/lib/hooks/__internal__/useInputAccessibility/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _useInputAccessibility.default;
+  }
+});
+
+var _useInputAccessibility = _interopRequireDefault(require("./useInputAccessibility"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/lib/hooks/__internal__/useInputAccessibility/useInputAccessibility.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = useInputAccessibility;
+
+function useInputAccessibility({
+  id,
+  error,
+  warning,
+  info,
+  label,
+  labelHelp,
+  fieldHelp
+}) {
+  const labelId = label ? `${id}-label` : undefined;
+  const tooltipId = [error, warning, info, labelHelp].filter(validation => typeof validation === "string").length ? `${id}-tooltip` : undefined;
+  const fieldHelpId = fieldHelp ? `${id}-field-help` : undefined;
+  const ariaDescribedBy = [fieldHelpId, tooltipId].filter(Boolean).join(" ");
+  const ariaLabelledBy = labelId;
+  return {
+    labelId,
+    tooltipId,
+    fieldHelpId,
+    ariaDescribedBy,
+    ariaLabelledBy
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carbon-react",
-  "version": "101.2.0",
+  "version": "101.3.3",
   "description": "A library of reusable React components for easily building user interfaces.",
   "engineStrict": true,
   "engines": {