feat(TextArea): add warning state

packages/react/__tests__/__snapshots__/PublicAPI-test.js.snap

@@ -7833,6 +7833,8 @@ Map {
       "onClick": [Function],
       "placeholder": "",
       "rows": 4,
+      "warn": false,
+      "warnText": "",
     },
     "propTypes": Object {
       "className": Object {
@@ -7911,6 +7913,12 @@ Map {
         ],
         "type": "oneOfType",
       },
+      "warn": Object {
+        "type": "bool",
+      },
+      "warnText": Object {
+        "type": "node",
+      },
     },
     "render": [Function],
   },
@@ -9971,6 +9979,12 @@ Map {
         ],
         "type": "oneOfType",
       },
+      "warn": Object {
+        "type": "bool",
+      },
+      "warnText": Object {
+        "type": "node",
+      },
     },
   },
   "unstable__FluidTextAreaSkeleton" => Object {

packages/react/src/components/FluidTextArea/FluidTextArea.js

@@ -123,6 +123,16 @@ FluidTextArea.propTypes = {
    * Provide the current value of the `<textarea>`
    */
   value: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+
+  /**
+   * Specify whether the control is currently in warning state
+   */
+  warn: PropTypes.bool,
+
+  /**
+   * Provide the text that is displayed when the control is in warning state
+   */
+  warnText: PropTypes.node,
 };
 
 export default FluidTextArea;

packages/react/src/components/FluidTextArea/FluidTextArea.stories.js

@@ -175,4 +175,16 @@ Playground.argTypes = {
     },
     defaultValue: '500',
   },
+  warn: {
+    control: {
+      type: 'boolean',
+    },
+    defaultValue: false,
+  },
+  warnText: {
+    control: {
+      type: 'text',
+    },
+    defaultValue: 'This is a warning message.',
+  },
 };

packages/react/src/components/TextArea/TextArea.stories.js

@@ -140,6 +140,18 @@ Playground.argTypes = {
     },
     defaultValue: 4,
   },
+  warn: {
+    control: {
+      type: 'boolean',
+    },
+    defaultValue: false,
+  },
+  warnText: {
+    control: {
+      type: 'text',
+    },
+    defaultValue: 'This is a warning message.',
+  },
 };
 
 Playground.args = {

packages/react/src/components/TextArea/TextArea.tsx

@@ -9,7 +9,7 @@ import PropTypes, { ReactNodeLike } from 'prop-types';
 import React, { useState, useContext, useRef } from 'react';
 import classNames from 'classnames';
 import deprecate from '../../prop-types/deprecate';
-import { WarningFilled } from '@carbon/icons-react';
+import { WarningFilled, WarningAltFilled } from '@carbon/icons-react';
 import { useFeatureFlag } from '../FeatureFlags';
 import { usePrefix } from '../../internal/usePrefix';
 import { FormContext } from '../FluidForm';
@@ -123,6 +123,16 @@ export interface TextAreaProps
    * Provide the current value of the `<textarea>`
    */
   value?: string | number;
+
+  /**
+   * Specify whether the control is currently in warning state
+   */
+  warn?: boolean;
+
+  /**
+   * Provide the text that is displayed when the control is in warning state
+   */
+  warnText?: ReactNodeLike;
 }
 
 const TextArea = React.forwardRef((props: TextAreaProps, forwardRef) => {
@@ -140,6 +150,8 @@ const TextArea = React.forwardRef((props: TextAreaProps, forwardRef) => {
     placeholder,
     enableCounter,
     maxCount,
+    warn = false,
+    warnText,
     ...other
   } = props;
   const prefix = usePrefix();
@@ -214,12 +226,24 @@ const TextArea = React.forwardRef((props: TextAreaProps, forwardRef) => {
     </div>
   ) : null;
 
+  const warning = warn ? (
+    <div role="alert" className={`${prefix}--form-requirement`}>
+      {warnText}
+      {isFluid && (
+        <WarningAltFilled
+          className={`${prefix}--text-area__invalid-icon ${prefix}--text-area__invalid-icon--warning`}
+        />
+      )}
+    </div>
+  ) : null;
+
   const textareaClasses = classNames(
     `${prefix}--text-area`,
     [enabled ? null : className],
     {
       [`${prefix}--text-area--light`]: light,
       [`${prefix}--text-area--invalid`]: invalid,
+      [`${prefix}--text-area--warn`]: warn,
     }
   );
 
@@ -265,19 +289,28 @@ const TextArea = React.forwardRef((props: TextAreaProps, forwardRef) => {
       <div
         className={classNames(`${prefix}--text-area__wrapper`, {
           [`${prefix}--text-area__wrapper--readonly`]: other.readOnly,
+          [`${prefix}--text-area__wrapper--warn`]: warn,
         })}
         data-invalid={invalid || null}>
         {invalid && !isFluid && (
           <WarningFilled className={`${prefix}--text-area__invalid-icon`} />
         )}
+        {warn && !invalid && !isFluid && (
+          <WarningAltFilled
+            className={`${prefix}--text-area__invalid-icon ${prefix}--text-area__invalid-icon--warning`}
+          />
+        )}
         {input}
         <span className={`${prefix}--text-area__counter-alert`} role="alert">
           {ariaAnnouncement}
         </span>
         {isFluid && <hr className={`${prefix}--text-area__divider`} />}
         {isFluid && invalid ? error : null}
+        {isFluid && warn && !invalid ? warning : null}
       </div>
-      {invalid && !isFluid ? error : helper}
+      {!invalid && !warn && !isFluid ? helper : null}
+      {invalid && !isFluid ? error : null}
+      {warn && !invalid && !isFluid ? warning : null}
     </div>
   );
 });
@@ -387,6 +420,16 @@ TextArea.propTypes = {
    * Provide the current value of the `<textarea>`
    */
   value: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+
+  /**
+   * Specify whether the control is currently in warning state
+   */
+  warn: PropTypes.bool,
+
+  /**
+   * Provide the text that is displayed when the control is in warning state
+   */
+  warnText: PropTypes.node,
 };
 
 TextArea.defaultProps = {
@@ -400,6 +443,8 @@ TextArea.defaultProps = {
   helperText: '',
   enableCounter: false,
   maxCount: undefined,
+  warn: false,
+  warnText: '',
 };
 
 export default TextArea;

packages/styles/scss/components/fluid-text-area/_fluid-text-area.scss

@@ -92,34 +92,55 @@
   }
 
   .#{$prefix}--text-area--fluid
-    .#{$prefix}--text-area--invalid
-    + .#{$prefix}--text-area__divider {
+    .#{$prefix}--text-area__wrapper[data-invalid]
+    .#{$prefix}--text-area__divider,
+  .#{$prefix}--text-area--fluid
+    .#{$prefix}--text-area__wrapper--warn
+    .#{$prefix}--text-area__divider {
     display: block;
     border-style: solid;
     border-color: $border-subtle;
     border-bottom: none;
     margin: 0 1rem;
   }
 
-  // invalid error message container
+  // invalid & warning error message container
   .#{$prefix}--text-area--fluid
-    .#{$prefix}--text-area--invalid
-    + .#{$prefix}--text-area__divider
-    + .#{$prefix}--form-requirement {
+    .#{$prefix}--text-area__wrapper[data-invalid]
+    .#{$prefix}--form-requirement.#{$prefix}--form-requirement,
+  .#{$prefix}--text-area--fluid
+    .#{$prefix}--text-area__wrapper--warn
+    .#{$prefix}--form-requirement.#{$prefix}--form-requirement {
     position: relative;
     display: block;
     overflow: visible;
     max-height: 12.5rem;
     padding: 0.5rem 2.5rem 0.5rem 1rem;
     margin: 0;
     background: $field;
+  }
+
+  .#{$prefix}--text-area--fluid
+    .#{$prefix}--text-area__wrapper--warn
+    .#{$prefix}--form-requirement.#{$prefix}--form-requirement {
+    border-bottom: 1px solid $border-strong;
+    color: $text-primary;
+  }
+
+  .#{$prefix}--text-area--fluid
+    .#{$prefix}--text-area__wrapper[data-invalid]
+    .#{$prefix}--form-requirement.#{$prefix}--form-requirement {
     color: $text-error;
   }
 
+  .#{$prefix}--text-area--fluid .#{$prefix}--text-area--warn {
+    border-bottom: none;
+  }
+
   .#{$prefix}--modal
     .#{$prefix}--text-area--fluid
-    .#{$prefix}--text-area--invalid
-    + .#{$prefix}--text-area__divider
+    .#{$prefix}--text-area__wrapper[data-invalid]
+    .#{$prefix}--text-area__divider
     + .#{$prefix}--form-requirement {
     background: $field-02;
   }

packages/styles/scss/components/form/_form.scss

@@ -142,6 +142,7 @@ $input-label-weight: 400 !default;
   .#{$prefix}--text-input__field-wrapper--warning,
   .#{$prefix}--text-input__field-wrapper--warning > .#{$prefix}--text-input,
   .#{$prefix}--text-area__wrapper[data-invalid],
+  .#{$prefix}--text-area__wrapper--warn,
   .#{$prefix}--select-input__wrapper[data-invalid],
   .#{$prefix}--select--warning .#{$prefix}--select-input__wrapper,
   .#{$prefix}--time-picker[data-invalid],

packages/styles/scss/components/text-area/_text-area.scss

@@ -6,6 +6,7 @@
 //
 
 @use '../form';
+@use '../../colors' as *;
 @use '../../config' as *;
 @use '../../motion' as *;
 @use '../../spacing' as *;
@@ -71,6 +72,15 @@
     fill: $support-error;
   }
 
+  .#{$prefix}--text-area__invalid-icon--warning {
+    fill: $support-warning;
+  }
+
+  .#{$prefix}--text-area__invalid-icon--warning path[fill] {
+    fill: $black-100;
+    opacity: 1;
+  }
+
   .#{$prefix}--text-area__counter-alert {
     position: absolute;
     overflow: hidden;