@patternfly/react-core 5.0.0-alpha.6 → 5.0.0-alpha.61

package/src/components/Card/examples/Card.md

@@ -2,21 +2,28 @@
 id: Card
 section: components
 cssPrefix: pf-c-card
-propComponents: ['Card', 'CardActions', 'CardHeader', 'CardHeaderMain', 'CardTitle', 'CardBody', 'CardFooter', 'CardExpandableContent']
+propComponents:
+  ['Card', 'CardHeader', 'CardHeaderActionsObject', 'CardTitle', 'CardBody', 'CardFooter', 'CardExpandableContent']
 ouia: true
 ---
 
+import {
+Dropdown as DropdownDeprecated,
+DropdownItem as DropdownItemDeprecated,
+DropdownSeparator,
+KebabToggle
+} from '@patternfly/react-core/deprecated';
 import pfLogo from './pfLogo.svg';
 import pfLogoSmall from './pf-logo-small.svg';
 
-
-## Examples 
+## Examples
 
 ### Basic cards
 
 Basic cards typically have a `<CardTitle>`, `<CardBody>` and `<CardFooter>`. You may omit these components as needed, but it is recommended to at least include a `<CardBody>` to provide details about the card item.
 
 ```ts file='./CardBasic.tsx'
+
 ```
 
 ### Modifiers
@@ -26,29 +33,30 @@ You can further modify the styling of the card's content by using the properties
 Most modifiers can be used in combination with each other, except for `isCompact` and `isLarge`, since they are contradictory.
 
 ```ts file='./CardWithModifiers.tsx'
-```
 
-| Modifier | Description |
-| --- | --- |
-| isCompact | Modifies the card to include compact styling. Should not be used with isLarge. |
-| isFlat | Modifies the card to include flat styling. |
-| isRounded | Modifies the card to include rounded border styling. |
-| isLarge | Modifies the card to be large. Should not be used with isCompact. |
-| isFullHeight | Modifies the card so that it fills the total available height of its container. |
-| isPlain | Modifies the card to include plain styling, which removes the border and background. | 
+```
 
+| Modifier     | Description                                                                          |
+| ------------ | ------------------------------------------------------------------------------------ |
+| isCompact    | Modifies the card to include compact styling. Should not be used with isLarge.       |
+| isFlat       | Modifies the card to include flat styling.                                           |
+| isRounded    | Modifies the card to include rounded border styling.                                 |
+| isLarge      | Modifies the card to be large. Should not be used with isCompact.                    |
+| isFullHeight | Modifies the card so that it fills the total available height of its container.      |
+| isPlain      | Modifies the card to include plain styling, which removes the border and background. |
 
 ### Header images and actions
 
-You can include header images within `<CardHeaderMain>` and header actions within `<CardActions>`. The following example includes an image using the [Brand](/components/brand) component, and also includes a kebab dropdown and a checkbox in `<CardActions>`.
+You can include header actions with the `actions` property of `<CardHeader>` . The following example includes an image using the [Brand](/components/brand) component, and also includes a kebab dropdown and a checkbox in `<CardHeader>` actions.
 
-`<CardActions>` includes the `hasNoOffset` property, which is `false` by default. When `hasNoOffset` is `false`, a negative margin is applied to help align default-sized card titles with `<CardActions>`. 
+The `actions` property for `<CardHeader>` includes the `hasNoOffset` property, which is `false` by default. When `hasNoOffset` is `false`, a negative margin is applied to help align default-sized card titles with card actions.
 
-You may use `hasNoOffset` to remove this negative margin, which better aligns `<CardActions>` in implementations that use large card titles or tall header images, for example. 
+You may use `hasNoOffset` to remove this negative margin, which better aligns card actions in implementations that use large card titles or tall header images, for example.
 
 Select the "actions hasNoOffset" checkbox in the example below to illustrate this behavior.
 
 ```ts file='./CardWithImageAndActions.tsx'
+
 ```
 
 ### Title inline with images and actions
@@ -56,15 +64,17 @@ Select the "actions hasNoOffset" checkbox in the example below to illustrate thi
 Moving `<CardTitle>` within the `<CardHeader>` will style it inline with any images or actions.
 
 ```ts file='./CardHeaderInCardHead.tsx'
+
 ```
 
 ### Card header without title
 
-`<CardActions>` can be placed in the card header even without a `<CardTitle>`.
+Card actions can be placed in the card header even without a `<CardTitle>`.
 
-Images can also be placed in the card header within `<CardHeaderMain>` without a `<CardTitle>`.
+Images can also be placed in the card header without a `<CardTitle>`.
 
 ```ts file='./CardOnlyActionsInCardHead.tsx'
+
 ```
 
 ### With HTML heading element
@@ -72,6 +82,7 @@ Images can also be placed in the card header within `<CardHeaderMain>` without a
 You may use the `component` property to place the card's title within an HTML heading element.
 
 ```ts file='./CardWithHeadingElement.tsx'
+
 ```
 
 ### With multiple body sections
@@ -79,15 +90,17 @@ You may use the `component` property to place the card's title within an HTML he
 You may use multiple body sections to visually separate blocks of content.
 
 ```ts file='./CardWithMultipleBodySections.tsx'
+
 ```
 
 ### With a primary body section that fills
 
 `<CardBody>` sections will fill the available height of the card when `isFilled` equals `{true}`, which is the default value. Set `isFilled` to `{false}` to disable this behavior for one or more body sections. The remaining available height of the card will be split between any `<CardBody>` section that does not set `isFilled` to `{false}`.
 
-A common use case of this is to set all but one body section to `isFilled={false}` so that a primary body section fills the available space of the card as seen in the example below. This example has 3 `<CardBody>` sections, two of which set `isFilled` to `{false}`. The third `<CardBody>` fills the remaining height of the card. 
+A common use case of this is to set all but one body section to `isFilled={false}` so that a primary body section fills the available space of the card as seen in the example below. This example has 3 `<CardBody>` sections, two of which set `isFilled` to `{false}`. The third `<CardBody>` fills the remaining height of the card.
 
 ```ts file='./CardWithBodySectionFills.tsx'
+
 ```
 
 ### Selectable cards
@@ -95,6 +108,7 @@ A common use case of this is to set all but one body section to `isFilled={false
 Selectable cards can only be selected one at a time, and are intended for use with [primary-detail layout](/demos/primary-detail).
 
 ```ts file='./CardSelectable.tsx'
+
 ```
 
 ### Legacy selectable cards
@@ -102,6 +116,7 @@ Selectable cards can only be selected one at a time, and are intended for use wi
 The following example shows a legacy implementation of selectable cards. This example uses the `isSelectable` property instead of `isSelectableRaised`, which is the current recommendation for implementation. `isSelectable` applies selectable styling, but does not apply raised styling on hover and selection as `isSelectableRaised` does.
 
 ```ts file='./CardLegacySelectable.tsx'
+
 ```
 
 ### Selectable card accessibility features
@@ -114,20 +129,22 @@ By default, this input will have an aria-label that corresponds to the `<CardTit
 
 The first card passes an onChange callback to `onSelectableInputChange` to enable the selection/deselection of the associated card via checkbox input.
 
-The second card does not set `hasSelectableInput` to true, so neither the input nor the selection state is communicated to users of assistive technologies. 
+The second card does not set `hasSelectableInput` to true, so neither the input nor the selection state is communicated to users of assistive technologies.
 
 We recommend navigating this example using a screen reader to best understand both cards.
 
 ```ts file='./CardSelectableA11yHighlight.tsx'
+
 ```
 
 ### Expandable cards
 
-A card can be made expandable using the `isExpanded` property. In the collapsed state, only the card header is shown, and the user can click the caret to view the rest of the card content. 
+A card can be made expandable using the `isExpanded` property. In the collapsed state, only the card header is shown, and the user can click the caret to view the rest of the card content.
 
 Place any content that you want to be hidden within the `<CardExpandableContent>` component.
 
 ```ts file='./CardExpandable.tsx'
+
 ```
 
 ### Expandable with icon
@@ -135,4 +152,5 @@ Place any content that you want to be hidden within the `<CardExpandableContent>
 An image can be placed in the card header to show users an icon beside the expansion caret.
 
 ```ts file='./CardExpandableWithIcon.tsx'
+
 ```

package/src/components/Card/examples/CardBasic.tsx

@@ -3,7 +3,7 @@ import { Card, CardTitle, CardBody, CardFooter } from '@patternfly/react-core';
 
 export const CardBasic: React.FunctionComponent = () => (
   <Card>
-    <CardTitle>Header</CardTitle>
+    <CardTitle>Title</CardTitle>
     <CardBody>Body</CardBody>
     <CardFooter>Footer</CardFooter>
   </Card>

package/src/components/Card/examples/CardExpandable.tsx

@@ -2,17 +2,18 @@ import React from 'react';
 import {
   Card,
   CardHeader,
-  CardActions,
   CardTitle,
   CardBody,
   CardFooter,
   CardExpandableContent,
-  Checkbox,
-  Dropdown,
-  DropdownItem,
+  Checkbox
+} from '@patternfly/react-core';
+import {
+  Dropdown as DropdownDeprecated,
+  DropdownItem as DropdownItemDeprecated,
   DropdownSeparator,
   KebabToggle
-} from '@patternfly/react-core';
+} from '@patternfly/react-core/deprecated';
 
 export const CardExpandable: React.FunctionComponent = () => {
   const [isOpen, setIsOpen] = React.useState<boolean>(false);
@@ -39,23 +40,43 @@ export const CardExpandable: React.FunctionComponent = () => {
   };
 
   const dropdownItems = [
-    <DropdownItem key="link">Link</DropdownItem>,
-    <DropdownItem key="action" component="button">
+    <DropdownItemDeprecated key="link">Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="action" component="button">
       Action
-    </DropdownItem>,
-    <DropdownItem key="disabled link" isDisabled>
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled link" isDisabled>
       Disabled Link
-    </DropdownItem>,
-    <DropdownItem key="disabled action" isDisabled component="button">
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled action" isDisabled component="button">
       Disabled Action
-    </DropdownItem>,
+    </DropdownItemDeprecated>,
     <DropdownSeparator key="separator" />,
-    <DropdownItem key="separated link">Separated Link</DropdownItem>,
-    <DropdownItem key="separated action" component="button">
+    <DropdownItemDeprecated key="separated link">Separated Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="separated action" component="button">
       Separated Action
-    </DropdownItem>
+    </DropdownItemDeprecated>
   ];
 
+  const headerActions = (
+    <>
+      <DropdownDeprecated
+        onSelect={onSelect}
+        toggle={<KebabToggle onToggle={(_event: any, isOpen: boolean) => setIsOpen(isOpen)} />}
+        isOpen={isOpen}
+        isPlain
+        dropdownItems={dropdownItems}
+        position={'right'}
+      />
+      <Checkbox
+        isChecked={isChecked}
+        onChange={(_event, checked) => onClick(checked)}
+        aria-label="card checkbox example"
+        id="check-4"
+        name="check4"
+      />
+    </>
+  );
+
   return (
     <React.Fragment>
       <div style={{ marginBottom: '12px' }}>
@@ -69,6 +90,7 @@ export const CardExpandable: React.FunctionComponent = () => {
       </div>
       <Card id="expandable-card" isExpanded={isExpanded}>
         <CardHeader
+          actions={{ actions: headerActions }}
           onExpand={onExpand}
           isToggleRightAligned={isToggleRightAligned}
           toggleButtonProps={{
@@ -78,24 +100,7 @@ export const CardExpandable: React.FunctionComponent = () => {
             'aria-expanded': isExpanded
           }}
         >
-          <CardActions>
-            <Dropdown
-              onSelect={onSelect}
-              toggle={<KebabToggle onToggle={setIsOpen} />}
-              isOpen={isOpen}
-              isPlain
-              dropdownItems={dropdownItems}
-              position={'right'}
-            />
-            <Checkbox
-              isChecked={isChecked}
-              onChange={onClick}
-              aria-label="card checkbox example"
-              id="check-4"
-              name="check4"
-            />
-          </CardActions>
-          <CardTitle id="expandable-card-title">Header</CardTitle>
+          <CardTitle id="expandable-card-title">Title</CardTitle>
         </CardHeader>
         <CardExpandableContent>
           <CardBody>Body</CardBody>

package/src/components/Card/examples/CardExpandableWithIcon.tsx

@@ -1,17 +1,11 @@
 import React from 'react';
+import { Card, CardHeader, CardBody, CardFooter, CardExpandableContent, Checkbox } from '@patternfly/react-core';
 import {
-  Card,
-  CardHeader,
-  CardActions,
-  CardBody,
-  CardFooter,
-  CardExpandableContent,
-  Checkbox,
-  Dropdown,
-  DropdownItem,
+  Dropdown as DropdownDeprecated,
+  DropdownItem as DropdownItemDeprecated,
   DropdownSeparator,
   KebabToggle
-} from '@patternfly/react-core';
+} from '@patternfly/react-core/deprecated';
 import pfLogoSmall from './pf-logo-small.svg';
 
 export const CardExpandableWithIcon: React.FunctionComponent = () => {
@@ -34,26 +28,47 @@ export const CardExpandableWithIcon: React.FunctionComponent = () => {
   };
 
   const dropdownItems = [
-    <DropdownItem key="link">Link</DropdownItem>,
-    <DropdownItem key="action" component="button">
+    <DropdownItemDeprecated key="link">Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="action" component="button">
       Action
-    </DropdownItem>,
-    <DropdownItem key="disabled link" isDisabled>
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled link" isDisabled>
       Disabled Link
-    </DropdownItem>,
-    <DropdownItem key="disabled action" isDisabled component="button">
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled action" isDisabled component="button">
       Disabled Action
-    </DropdownItem>,
+    </DropdownItemDeprecated>,
     <DropdownSeparator key="separator" />,
-    <DropdownItem key="separated link">Separated Link</DropdownItem>,
-    <DropdownItem key="separated action" component="button">
+    <DropdownItemDeprecated key="separated link">Separated Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="separated action" component="button">
       Separated Action
-    </DropdownItem>
+    </DropdownItemDeprecated>
   ];
 
+  const headerActions = (
+    <>
+      <DropdownDeprecated
+        onSelect={onSelect}
+        toggle={<KebabToggle onToggle={(_event: any, isOpen: boolean) => setIsOpen(isOpen)} />}
+        isOpen={isOpen}
+        isPlain
+        dropdownItems={dropdownItems}
+        position={'right'}
+      />
+      <Checkbox
+        isChecked={isChecked}
+        onChange={(_event, checked) => onClick(checked)}
+        aria-label="card checkbox example"
+        id="check-5"
+        name="check5"
+      />
+    </>
+  );
+
   return (
     <Card id="expandable-card-icon" isExpanded={isExpanded}>
       <CardHeader
+        actions={{ actions: headerActions }}
         onExpand={onExpand}
         toggleButtonProps={{
           id: 'toggle-button2',
@@ -62,23 +77,6 @@ export const CardExpandableWithIcon: React.FunctionComponent = () => {
         }}
       >
         <img src={pfLogoSmall} alt="PatternFly logo" width="27px" />
-        <CardActions>
-          <Dropdown
-            onSelect={onSelect}
-            toggle={<KebabToggle onToggle={setIsOpen} />}
-            isOpen={isOpen}
-            isPlain
-            dropdownItems={dropdownItems}
-            position={'right'}
-          />
-          <Checkbox
-            isChecked={isChecked}
-            onChange={onClick}
-            aria-label="card checkbox example"
-            id="check-5"
-            name="check5"
-          />
-        </CardActions>
       </CardHeader>
       <CardExpandableContent>
         <CardBody>Body</CardBody>

package/src/components/Card/examples/CardHeaderInCardHead.tsx

@@ -1,17 +1,11 @@
 import React from 'react';
+import { Card, CardHeader, CardTitle, CardBody, CardFooter, Checkbox } from '@patternfly/react-core';
 import {
-  Card,
-  CardHeader,
-  CardActions,
-  CardTitle,
-  CardBody,
-  CardFooter,
-  Checkbox,
-  Dropdown,
-  DropdownItem,
+  Dropdown as DropdownDeprecated,
+  DropdownItem as DropdownItemDeprecated,
   DropdownSeparator,
   KebabToggle
-} from '@patternfly/react-core';
+} from '@patternfly/react-core/deprecated';
 
 export const CardTitleInHeader: React.FunctionComponent = () => {
   const [isOpen, setIsOpen] = React.useState<boolean>(false);
@@ -25,43 +19,46 @@ export const CardTitleInHeader: React.FunctionComponent = () => {
   };
 
   const dropdownItems = [
-    <DropdownItem key="link">Link</DropdownItem>,
-    <DropdownItem key="action" component="button">
+    <DropdownItemDeprecated key="link">Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="action" component="button">
       Action
-    </DropdownItem>,
-    <DropdownItem key="disabled link" isDisabled>
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled link" isDisabled>
       Disabled Link
-    </DropdownItem>,
-    <DropdownItem key="disabled action" isDisabled component="button">
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled action" isDisabled component="button">
       Disabled Action
-    </DropdownItem>,
+    </DropdownItemDeprecated>,
     <DropdownSeparator key="separator" />,
-    <DropdownItem key="separated link">Separated Link</DropdownItem>,
-    <DropdownItem key="separated action" component="button">
+    <DropdownItemDeprecated key="separated link">Separated Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="separated action" component="button">
       Separated Action
-    </DropdownItem>
+    </DropdownItemDeprecated>
   ];
 
+  const headerActions = (
+    <>
+      <DropdownDeprecated
+        onSelect={onSelect}
+        toggle={<KebabToggle onToggle={(_event: any, isOpen: boolean) => setIsOpen(isOpen)} />}
+        isOpen={isOpen}
+        isPlain
+        dropdownItems={dropdownItems}
+        position={'right'}
+      />
+      <Checkbox
+        isChecked={isChecked}
+        onChange={(_event, checked) => onClick(checked)}
+        aria-label="card checkbox example"
+        id="check-2"
+        name="check2"
+      />
+    </>
+  );
+
   return (
     <Card>
-      <CardHeader>
-        <CardActions>
-          <Dropdown
-            onSelect={onSelect}
-            toggle={<KebabToggle onToggle={setIsOpen} />}
-            isOpen={isOpen}
-            isPlain
-            dropdownItems={dropdownItems}
-            position={'right'}
-          />
-          <Checkbox
-            isChecked={isChecked}
-            onChange={onClick}
-            aria-label="card checkbox example"
-            id="check-2"
-            name="check2"
-          />
-        </CardActions>
+      <CardHeader actions={{ actions: headerActions }}>
         <CardTitle>
           This is a really really really really really really really really really really long header
         </CardTitle>

package/src/components/Card/examples/CardLegacySelectable.tsx

@@ -1,15 +1,11 @@
 import React from 'react';
+import { Card, CardHeader, CardTitle, CardBody } from '@patternfly/react-core';
 import {
-  Card,
-  CardHeader,
-  CardActions,
-  CardTitle,
-  CardBody,
-  Dropdown,
-  DropdownItem,
+  Dropdown as DropdownDeprecated,
+  DropdownItem as DropdownItemDeprecated,
   DropdownSeparator,
   KebabToggle
-} from '@patternfly/react-core';
+} from '@patternfly/react-core/deprecated';
 
 export const CardLegacySelectable: React.FunctionComponent = () => {
   const [selected, setSelected] = React.useState<string>('');
@@ -21,49 +17,62 @@ export const CardLegacySelectable: React.FunctionComponent = () => {
     }
     if (['Enter', ' '].includes(event.key)) {
       event.preventDefault();
-      const newSelected = event.currentTarget.id === selected ? null : event.currentTarget.id;
+      const newSelected = event.currentTarget.id === selected ? '' : event.currentTarget.id;
       setSelected(newSelected);
     }
   };
 
   const onClick = (event: React.MouseEvent) => {
-    const newSelected = event.currentTarget.id === selected ? null : event.currentTarget.id;
+    const newSelected = event.currentTarget.id === selected ? '' : event.currentTarget.id;
     setSelected(newSelected);
   };
 
-  const onChange = (labelledById: string, _event: React.FormEvent<HTMLInputElement>) => {
-    const newSelected = labelledById === selected ? null : labelledById;
+  const onChange = (_event: React.FormEvent<HTMLInputElement>, labelledById: string) => {
+    const newSelected = labelledById === selected ? '' : labelledById;
     setSelected(newSelected);
   };
 
-  const onToggle = (isOpen: boolean, event: any) => {
+  const onToggle = (event: any, isOpen: boolean) => {
     event.stopPropagation();
     setIsKebabOpen(isOpen);
   };
 
-  const onSelect = (event: React.SyntheticEvent<HTMLDivElement>) => {
-    event.stopPropagation();
+  const onSelect = (event: React.SyntheticEvent<HTMLDivElement> | undefined) => {
+    event?.stopPropagation();
     setIsKebabOpen(!isKebabOpen);
   };
 
   const dropdownItems = [
-    <DropdownItem key="link">Link</DropdownItem>,
-    <DropdownItem key="action" component="button">
+    <DropdownItemDeprecated key="link">Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="action" component="button">
       Action
-    </DropdownItem>,
-    <DropdownItem key="disabled link" isDisabled>
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled link" isDisabled>
       Disabled Link
-    </DropdownItem>,
-    <DropdownItem key="disabled action" isDisabled component="button">
+    </DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="disabled action" isDisabled component="button">
       Disabled Action
-    </DropdownItem>,
+    </DropdownItemDeprecated>,
     <DropdownSeparator key="separator" />,
-    <DropdownItem key="separated link">Separated Link</DropdownItem>,
-    <DropdownItem key="separated action" component="button">
+    <DropdownItemDeprecated key="separated link">Separated Link</DropdownItemDeprecated>,
+    <DropdownItemDeprecated key="separated action" component="button">
       Separated Action
-    </DropdownItem>
+    </DropdownItemDeprecated>
   ];
 
+  const headerActions = (
+    <>
+      <DropdownDeprecated
+        onSelect={onSelect}
+        toggle={<KebabToggle onToggle={onToggle} />}
+        isOpen={isKebabOpen}
+        isPlain
+        dropdownItems={dropdownItems}
+        position={'right'}
+      />
+    </>
+  );
+
   return (
     <>
       <Card
@@ -75,18 +84,7 @@ export const CardLegacySelectable: React.FunctionComponent = () => {
         isSelected={selected === 'legacy-first-card'}
         hasSelectableInput
       >
-        <CardHeader>
-          <CardActions>
-            <Dropdown
-              onSelect={onSelect}
-              toggle={<KebabToggle onToggle={onToggle} />}
-              isOpen={isKebabOpen}
-              isPlain
-              dropdownItems={dropdownItems}
-              position={'right'}
-            />
-          </CardActions>
-        </CardHeader>
+        <CardHeader actions={{ actions: headerActions }} />
         <CardTitle>First legacy selectable card</CardTitle>
         <CardBody>This is a selectable card. Click me to select me. Click again to deselect me.</CardBody>
       </Card>