@patternfly/react-core 4.217.3 → 4.219.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patternfly/react-core",
-  "version": "4.217.3",
+  "version": "4.219.0",
   "description": "This library provides a set of common React components for use with the PatternFly reference implementation.",
   "main": "dist/js/index.js",
   "module": "dist/esm/index.js",
@@ -34,9 +34,9 @@
     "generate": "node scripts/copyStyles.js"
   },
   "dependencies": {
-    "@patternfly/react-icons": "^4.68.3",
-    "@patternfly/react-styles": "^4.67.3",
-    "@patternfly/react-tokens": "^4.69.3",
+    "@patternfly/react-icons": "^4.70.0",
+    "@patternfly/react-styles": "^4.69.0",
+    "@patternfly/react-tokens": "^4.71.0",
     "focus-trap": "6.2.2",
     "react-dropzone": "9.0.0",
     "tippy.js": "5.1.2",
@@ -60,5 +60,5 @@
     "react": "^16.8.0 || ^17.0.0",
     "react-dom": "^16.8.0 || ^17.0.0"
   },
-  "gitHead": "cb169f61276aee6fc695408537310c10cfb5f1f0"
+  "gitHead": "35dea6aaa7ed4c6f49ae0d3ee6644dda3efb2889"
 }

package/src/components/FileUpload/FileUploadField.tsx

@@ -78,6 +78,10 @@ export interface FileUploadFieldProps extends Omit<React.HTMLProps<HTMLDivElemen
   containerRef?: React.Ref<HTMLDivElement>;
   /** Text area text changed */
   onTextChange?: (text: string) => void;
+  /** Callback for when focus is lost on the text area field */
+  onTextAreaBlur?: (event?: any) => void;
+  /** Placeholder string to display in the empty text area field */
+  textAreaPlaceholder?: string;
 }
 
 export const FileUploadField: React.FunctionComponent<FileUploadFieldProps> = ({
@@ -90,6 +94,8 @@ export const FileUploadField: React.FunctionComponent<FileUploadFieldProps> = ({
   onClearButtonClick = () => {},
   onTextAreaClick,
   onTextChange,
+  onTextAreaBlur,
+  textAreaPlaceholder = '',
   className = '',
   isDisabled = false,
   isReadOnly = false,
@@ -169,6 +175,8 @@ export const FileUploadField: React.FunctionComponent<FileUploadFieldProps> = ({
             value={value as string}
             onChange={onTextAreaChange}
             onClick={onTextAreaClick}
+            onBlur={onTextAreaBlur}
+            placeholder={textAreaPlaceholder}
           />
         )}
         {isLoading && (

package/src/components/FileUpload/__tests__/__snapshots__/FileUpload.test.tsx.snap

@@ -59,6 +59,7 @@ exports[`simple fileupload 1`] = `
         class="pf-c-form-control pf-m-resize-vertical"
         id="simple-text-file"
         name="simple-text-file"
+        placeholder=""
       />
     </div>
     <input

package/src/components/FileUpload/__tests__/__snapshots__/FileUploadField.test.tsx.snap

@@ -58,6 +58,7 @@ exports[`simple fileuploadfield 1`] = `
         class="pf-c-form-control pf-m-resize-vertical"
         id="custom-file-upload"
         name="custom-file-upload"
+        placeholder=""
       />
     </div>
     <p>

package/src/components/FileUpload/examples/FileUpload.md

@@ -268,7 +268,8 @@ class CustomFileUpload extends React.Component {
       isLoading: false,
       isDragActive: false,
       hideDefaultPreview: false,
-      children: false
+      children: false,
+      hasPlaceholderText: false
     };
     this.handleTextAreaChange = value => {
       this.setState({ value });
@@ -283,11 +284,12 @@ class CustomFileUpload extends React.Component {
       isLoading,
       isDragActive,
       hideDefaultPreview,
-      children
+      children,
+      hasPlaceholderText
     } = this.state;
     return (
       <div>
-        {['filename', 'isClearButtonDisabled', 'isDragActive', 'isLoading', 'hideDefaultPreview', 'children'].map(
+        {['filename', 'isClearButtonDisabled', 'isDragActive', 'isLoading', 'hideDefaultPreview', 'children', 'hasPlaceholderText'].map(
           stateKey => (
             <Checkbox
               key={stateKey}
@@ -321,6 +323,7 @@ class CustomFileUpload extends React.Component {
           isDragActive={isDragActive}
           hideDefaultPreview={hideDefaultPreview}
           browseButtonText="Upload"
+          textAreaPlaceholder={hasPlaceholderText ? "File preview" : ''}
         >
           {children && (
             <div className="pf-u-m-md">(A custom preview of the uploaded file can be passed as children)</div>

package/src/components/Switch/Switch.tsx

@@ -12,12 +12,18 @@ export interface SwitchProps
   id?: string;
   /** Additional classes added to the switch */
   className?: string;
-  /** Text value for the label when on */
+  /** Text value for the visible label when on */
   label?: React.ReactNode;
-  /** Text value for the label when off */
+  /** Text value for the visible label when off */
   labelOff?: React.ReactNode;
-  /** Flag to show if the switch is checked. */
+  /** Flag to show if the switch is checked when it is controlled by React state.
+   * To make the switch uncontrolled instead use the defaultChecked prop, but do not use both.
+   */
   isChecked?: boolean;
+  /** Flag to set the default checked value of the switch when it is uncontrolled by React state.
+   * To make the switch controlled instead use the isChecked prop, but do not use both.
+   */
+  defaultChecked?: boolean;
   /** Flag to show if the switch has a check icon. */
   hasCheckIcon?: boolean;
   /** Flag to show if the switch is disabled. */
@@ -63,6 +69,7 @@ export class Switch extends React.Component<SwitchProps & OUIAProps, { ouiaState
       label,
       labelOff,
       isChecked,
+      defaultChecked,
       hasCheckIcon,
       isDisabled,
       onChange,
@@ -84,7 +91,8 @@ export class Switch extends React.Component<SwitchProps & OUIAProps, { ouiaState
           className={css(styles.switchInput)}
           type="checkbox"
           onChange={event => onChange(event.target.checked, event)}
-          checked={isChecked}
+          {...([true, false].includes(defaultChecked) && { defaultChecked })}
+          {...(![true, false].includes(defaultChecked) && { checked: isChecked })}
           disabled={isDisabled}
           aria-labelledby={isAriaLabelledBy ? `${this.id}-on` : null}
           {...props}

package/src/components/Switch/examples/Switch.md

@@ -171,24 +171,8 @@ import React from 'react';
 import { Switch } from '@patternfly/react-core';
 
 <React.Fragment>
-  <Switch
-    id="uncontrolled-switch-on"
-    aria-label="Message when on"
-    label="Message when on"
-    labelOff="Message when off"
-    isChecked
-  />
-  <br />
-  <Switch
-    id="uncontrolled-switch-off"
-    aria-label="Message when on"
-    label="Message when on"
-    labelOff="Message when off"
-    isChecked={false}
-  />
-  <br />
-  <Switch id="uncontrolled-no-label-switch-on" aria-label="Message when on" isChecked />
+  <Switch id="uncontrolled-switch-on" label="Message when on" labelOff="Message when off" defaultChecked={false} />
   <br />
-  <Switch id="uncontrolled-no-label-switch-off" aria-label="Message when on" isChecked={false} />
+  <Switch id="uncontrolled-no-label-switch-on" aria-label="Message when on" defaultChecked={true} />
 </React.Fragment>;
 ```

package/src/components/Tooltip/Tooltip.tsx

@@ -63,7 +63,10 @@ export interface TooltipProps extends Omit<React.HTMLProps<HTMLDivElement>, 'con
   enableFlip?: boolean;
   /** Delay in ms before the tooltip appears */
   entryDelay?: number;
-  /** Delay in ms before the tooltip disappears */
+  /** Delay in ms before the tooltip disappears, Avoid passing in a value of "0", as users should
+   * be given ample time to move their mouse from the trigger to the tooltip content without the content
+   * being hidden.
+   */
   exitDelay?: number;
   /**
    * The desired position to flip the tooltip to if the initial position is not possible.
@@ -149,7 +152,7 @@ export const Tooltip: React.FunctionComponent<TooltipProps> = ({
   enableFlip = true,
   className = '',
   entryDelay = 300,
-  exitDelay = 0,
+  exitDelay = 300,
   appendTo = () => document.body,
   zIndex = 9999,
   maxWidth = tooltipMaxWidth.value,
@@ -318,6 +321,8 @@ export const Tooltip: React.FunctionComponent<TooltipProps> = ({
       placement={position}
       onMouseEnter={triggerOnMouseenter && show}
       onMouseLeave={triggerOnMouseenter && hide}
+      onPopperMouseEnter={triggerOnMouseenter && show}
+      onPopperMouseLeave={triggerOnMouseenter && hide}
       onFocus={triggerOnFocus && show}
       onBlur={triggerOnFocus && hide}
       onDocumentClick={triggerOnClick && onDocumentClick}

package/src/helpers/Popper/Popper.tsx

@@ -95,6 +95,10 @@ export interface PopperProps {
   onTriggerEnter?: (event?: KeyboardEvent) => void;
   /** Callback function when popper is clicked */
   onPopperClick?: (event?: MouseEvent) => void;
+  /** Callback function when mouse enters popper content */
+  onPopperMouseEnter?: (event?: MouseEvent) => void;
+  /** Callback function when mouse leaves popper content */
+  onPopperMouseLeave?: (event?: MouseEvent) => void;
   /** Callback function when document is clicked */
   onDocumentClick?: (event?: MouseEvent, triggerElement?: HTMLElement, popperElement?: HTMLElement) => void;
   /** Callback function when keydown event occurs on document */
@@ -140,6 +144,8 @@ export const Popper: React.FunctionComponent<PopperProps> = ({
   onTriggerClick,
   onTriggerEnter,
   onPopperClick,
+  onPopperMouseEnter,
+  onPopperMouseLeave,
   onDocumentKeyDown,
   enableFlip = true,
   flipBehavior = 'flip',
@@ -186,6 +192,8 @@ export const Popper: React.FunctionComponent<PopperProps> = ({
     addEventListener(onTriggerClick, refOrTrigger, 'click');
     addEventListener(onTriggerEnter, refOrTrigger, 'keydown');
     addEventListener(onPopperClick, popperElement, 'click');
+    addEventListener(onPopperMouseEnter, popperElement, 'mouseenter');
+    addEventListener(onPopperMouseLeave, popperElement, 'mouseleave');
     onDocumentClick && addEventListener(onDocumentClickCallback, document, 'click');
     addEventListener(onDocumentKeyDown, document, 'keydown');
 
@@ -203,6 +211,8 @@ export const Popper: React.FunctionComponent<PopperProps> = ({
       removeEventListener(onTriggerClick, refOrTrigger, 'click');
       removeEventListener(onTriggerEnter, refOrTrigger, 'keydown');
       removeEventListener(onPopperClick, popperElement, 'click');
+      removeEventListener(onPopperMouseEnter, popperElement, 'mouseenter');
+      removeEventListener(onPopperMouseLeave, popperElement, 'mouseleave');
       onDocumentClick && removeEventListener(onDocumentClickCallback, document, 'click');
       removeEventListener(onDocumentKeyDown, document, 'keydown');
       observer.disconnect();
@@ -217,6 +227,8 @@ export const Popper: React.FunctionComponent<PopperProps> = ({
     onTriggerClick,
     onTriggerEnter,
     onPopperClick,
+    onPopperMouseEnter,
+    onPopperMouseLeave,
     onDocumentClick,
     onDocumentKeyDown,
     refElement