@patternfly/react-core 5.2.0-prerelease.2 → 5.2.0-prerelease.20

package/src/demos/PasswordStrength.md

@@ -7,6 +7,7 @@ import HelpIcon from '@patternfly/react-icons/dist/esm/icons/help-icon';
 import ExclamationCircleIcon from '@patternfly/react-icons/dist/esm/icons/exclamation-circle-icon';
 import ExclamationTriangleIcon from '@patternfly/react-icons/dist/esm/icons/exclamation-triangle-icon';
 import CheckCircleIcon from '@patternfly/react-icons/dist/esm/icons/check-circle-icon';
+import formStyles from '@patternfly/react-styles/css/components/Form/form';
 
 ## Demos
 

package/src/demos/PrimaryDetail.md

@@ -23,7 +23,7 @@ import swaggerIcon from './assets/camel-swagger-java_200x150.png';
 import azureIcon from './assets/FuseConnector_Icons_AzureServices.png';
 import restIcon from './assets/FuseConnector_Icons_REST.png';
 import EllipsisVIcon from '@patternfly/react-icons/dist/esm/icons/ellipsis-v-icon';
-import { data } from '@patternfly/react-core/src/demos/Card/examples/CardData.jsx';
+import { data } from '@patternfly/react-core/src/demos/CardView/examples/CardViewData.jsx';
 
 ## Demos
 
@@ -89,7 +89,7 @@ import azureIcon from './assets/FuseConnector_Icons_AzureServices.png';
 import restIcon from './assets/FuseConnector_Icons_REST.png';
 import EllipsisVIcon from '@patternfly/react-icons/dist/esm/icons/ellipsis-v-icon';
 import { DashboardWrapper } from '@patternfly/react-core/src/demos/DashboardWrapper';
-import { data } from '@patternfly/react-core/src/demos/Card/examples/CardData.jsx';
+import { data } from '@patternfly/react-core/src/demos/CardView/examples/CardViewData.jsx';
 
 class PrimaryDetailCardView extends React.Component {
   constructor(props) {

package/src/demos/ProgressDemo.md

@@ -14,7 +14,7 @@ import { Progress, Button, Stack, StackItem } from '@patternfly/react-core';
 ProgressStepperDemo = () => {
   const [currentValue, setCurrentValue] = React.useState(0);
 
-  const onProgressUpdate = nextValue => {
+  const onProgressUpdate = (nextValue) => {
     setCurrentValue(nextValue);
   };
 
@@ -52,7 +52,7 @@ import { Progress, Button, Stack, StackItem } from '@patternfly/react-core';
 ProgressStepperDemo = () => {
   const [currentValue, setCurrentValue] = React.useState(0);
 
-  const onProgressUpdate = nextValue => {
+  const onProgressUpdate = (nextValue) => {
     if (nextValue > currentValue) {
       setCurrentValue(nextValue);
     }

package/src/demos/RTL/RTL.md

@@ -0,0 +1,31 @@
+---
+id: Right-to-left
+section: patterns
+---
+
+import translationsEn from "./examples/translations.en.json";
+import translationsHe from "./examples/translations.he.json";
+import AlignRightIcon from '@patternfly/react-icons/dist/esm/icons/align-right-icon';
+import ToolsIcon from '@patternfly/react-icons/dist/esm/icons/tools-icon';
+import ClockIcon from '@patternfly/react-icons/dist/esm/icons/clock-icon';
+import WalkingIcon from '@patternfly/react-icons/dist/esm/icons/walking-icon';
+import pfLogo from '@patternfly/react-core/src/demos/assets/pf-logo.svg';
+import BarsIcon from '@patternfly/react-icons/dist/esm/icons/bars-icon';
+import CogIcon from '@patternfly/react-icons/dist/esm/icons/cog-icon';
+import QuestionCircleIcon from '@patternfly/react-icons/dist/esm/icons/question-circle-icon';
+import HelpIcon from '@patternfly/react-icons/dist/esm/icons/help-icon';
+import EllipsisVIcon from '@patternfly/react-icons/dist/esm/icons/ellipsis-v-icon';
+import HandPaperIcon from '@patternfly/react-icons/dist/esm/icons/hand-paper-icon';
+import imgAvatar from '@patternfly/react-core/src/components/assets/avatarImg.svg';
+
+import './examples/PaginatedTable.css';
+
+## Demos
+
+This demonstrates how the UI adapts to the writing mode of the page.
+
+### Paginated table
+
+```js file="./examples/PaginatedTable.jsx" isFullscreen
+
+```

package/src/demos/RTL/examples/PaginatedTable.css

@@ -0,0 +1,7 @@
+.brand-language {
+  font-weight: var(--pf-v5-global--FontWeight--bold);
+  font-family: var(--pf-v5-global--FontFamily--heading);
+  font-size: var(--pf-v5-global--FontSize--xl);
+  align-self: center;
+  margin-inline-start: var(--pf-v5-global--spacer--md);
+}

package/src/demos/RTL/examples/PaginatedTable.jsx

@@ -0,0 +1,507 @@
+import * as React from 'react';
+
+import {
+  Avatar,
+  Brand,
+  Breadcrumb,
+  BreadcrumbItem,
+  Button,
+  ButtonVariant,
+  Card,
+  Divider,
+  Dropdown,
+  DropdownGroup,
+  DropdownItem,
+  DropdownList,
+  Icon,
+  Label,
+  Masthead,
+  MastheadBrand,
+  MastheadContent,
+  MastheadMain,
+  MastheadToggle,
+  MenuToggle,
+  Nav,
+  NavItem,
+  NavList,
+  Page,
+  PageBreadcrumb,
+  PageSection,
+  PageSidebar,
+  PageSidebarBody,
+  PageToggleButton,
+  Pagination,
+  PaginationVariant,
+  Text,
+  TextContent,
+  TextVariants,
+  Toolbar,
+  ToolbarContent,
+  ToolbarGroup,
+  ToolbarItem,
+  Truncate
+} from '@patternfly/react-core';
+
+import { Table, Thead, Tr, Th, Tbody, Td } from '@patternfly/react-table';
+import translationsEn from './examples/translations.en.json';
+import translationsHe from './examples/translations.he.json';
+import AlignRightIcon from '@patternfly/react-icons/dist/esm/icons/align-right-icon';
+import ToolsIcon from '@patternfly/react-icons/dist/esm/icons/tools-icon';
+import ClockIcon from '@patternfly/react-icons/dist/esm/icons/clock-icon';
+import WalkingIcon from '@patternfly/react-icons/dist/esm/icons/walking-icon';
+import pfLogo from '@patternfly/react-core/src/demos/assets/pf-logo.svg';
+import BarsIcon from '@patternfly/react-icons/dist/esm/icons/bars-icon';
+import CogIcon from '@patternfly/react-icons/dist/esm/icons/cog-icon';
+import QuestionCircleIcon from '@patternfly/react-icons/dist/esm/icons/question-circle-icon';
+import HelpIcon from '@patternfly/react-icons/dist/esm/icons/help-icon';
+import EllipsisVIcon from '@patternfly/react-icons/dist/esm/icons/ellipsis-v-icon';
+import HandPaperIcon from '@patternfly/react-icons/dist/esm/icons/hand-paper-icon';
+import imgAvatar from '@patternfly/react-core/src/components/assets/avatarImg.svg';
+
+export const PaginatedTableAction = () => {
+  const [translation, setTranslation] = React.useState(translationsEn);
+  const [page, setPage] = React.useState(1);
+  const [perPage, setPerPage] = React.useState(10);
+
+  const columns = [
+    translation.table.columns.servers,
+    translation.table.columns.status,
+    translation.table.columns.location,
+    translation.table.columns.modified,
+    translation.table.columns.url
+  ];
+
+  const numRows = 25;
+  const getRandomInteger = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+  const createRows = () => {
+    const rows = [];
+    for (let i = 0; i < numRows; i++) {
+      const num = i + 1;
+      const rowObj = {
+        name: translation.table.rows.node + num,
+        status: [
+          translation.table.rows.status.stopped,
+          translation.table.rows.status.running,
+          translation.table.rows.status.down,
+          translation.table.rows.status.needsMaintenance
+        ][getRandomInteger(0, 3)],
+        location: [
+          translation.table.rows.locations.raleigh,
+          translation.table.rows.locations.boston,
+          translation.table.rows.locations.atlanta,
+          translation.table.rows.locations.sanFrancisco
+        ][getRandomInteger(0, 3)],
+        lastModified: [
+          translation.table.rows.lastModified.oneHr,
+          translation.table.rows.lastModified.threeHrs,
+          translation.table.rows.lastModified.fiveHrs,
+          translation.table.rows.lastModified.sevenMins,
+          translation.table.rows.lastModified.fortyTwoMins,
+          translation.table.rows.lastModified.twoDays,
+          translation.table.rows.lastModified.oneMonth
+        ][getRandomInteger(0, 6)],
+        url: 'http://www.redhat.com/en/office-locations/node' + num
+      };
+      rows.push(rowObj);
+    }
+
+    return rows;
+  };
+
+  const rows = createRows();
+  const [managedRows, setManagedRows] = React.useState(rows);
+  const [paginatedRows, setPaginatedRows] = React.useState(rows.slice(0, 10));
+  const [isDirRTL, setIsDirRTL] = React.useState(false);
+
+  const capitalize = (input) => input[0].toUpperCase() + input.substring(1);
+
+  const switchTranslation = () => {
+    setIsDirRTL((prevIsDirRTL) => !prevIsDirRTL);
+    setTranslation((prevTranslation) => (prevTranslation === translationsEn ? translationsHe : translationsEn));
+  };
+
+  React.useEffect(() => {
+    const newRows = createRows();
+    setManagedRows(newRows);
+    setPaginatedRows(newRows.slice((page - 1) * perPage, page * perPage));
+  }, [translation]);
+
+  React.useEffect(() => {
+    const html = document.querySelector('html');
+    html.dir = isDirRTL ? 'rtl' : 'ltr';
+  }, [isDirRTL]);
+
+  // Pagination logic
+
+  const handleSetPage = (_evt, newPage, _perPage, startIdx, endIdx) => {
+    setPaginatedRows(managedRows.slice(startIdx, endIdx));
+    setPage(newPage);
+  };
+
+  const handlePerPageSelect = (_evt, newPerPage, _newPage, startIdx, endIdx) => {
+    setPaginatedRows(managedRows.slice(startIdx, endIdx));
+    setPerPage(newPerPage);
+  };
+
+  const renderPagination = (variant) => {
+    const { pagination } = translation;
+
+    return (
+      <Pagination
+        itemCount={managedRows.length}
+        page={page}
+        perPage={perPage}
+        onSetPage={handleSetPage}
+        onPerPageSelect={handlePerPageSelect}
+        variant={variant}
+        titles={{
+          paginationAriaLabel: pagination?.[`${variant}VariantAriaLabel`] || `${variant} pagination`,
+          ofWord: pagination?.ofWord,
+          items: pagination?.items,
+          perPageSuffix: pagination?.perPageSuffix,
+          toNextPageAriaLabel: pagination?.toNextPageAriaLabel,
+          toPreviousPageAriaLabel: pagination?.toPreviousPageAriaLabel,
+          toFirstPageAriaLabel: pagination?.toFirstPageAriaLabel,
+          toLastPageAriaLabel: pagination?.perPageSuffix,
+          currPageAriaLabel: pagination?.currPageAriaLabel
+        }}
+      />
+    );
+  };
+
+  const breadcrumbItems = {
+    home: {
+      url: '#home'
+    },
+    category: {
+      url: '#category'
+    },
+    subCategory: {
+      url: 'sub-category'
+    }
+  };
+
+  const renderLabel = (labelText) => {
+    switch (labelText) {
+      case 'Running':
+      case 'רץ':
+        return (
+          <Label
+            color="green"
+            icon={
+              <Icon shouldMirrorRTL>
+                <WalkingIcon />
+              </Icon>
+            }
+          >
+            {translation.table.rows.status.running}
+          </Label>
+        );
+      case 'Stopped':
+      case 'עצר':
+        return (
+          <Label
+            icon={
+              <Icon shouldMirrorRTL>
+                <HandPaperIcon />
+              </Icon>
+            }
+            color="red"
+          >
+            {translation.table.rows.status.stopped}
+          </Label>
+        );
+      case 'Needs maintenance':
+      case 'זקוק לתחזוקה':
+        return (
+          <Label icon={<ToolsIcon />} color="blue">
+            {translation.table.rows.status.needsMaintenance}
+          </Label>
+        );
+      case 'Down':
+      case 'מטה':
+        return (
+          <Label icon={<ClockIcon />} color="orange">
+            {translation.table.rows.status.down}
+          </Label>
+        );
+    }
+  };
+
+  const toolbarItems = (
+    <React.Fragment>
+      <Toolbar id="rtl-paginated-table">
+        <ToolbarContent>
+          <ToolbarItem>
+            <Button
+              variant="primary"
+              icon={
+                <Icon shouldMirrorRTL>
+                  <AlignRightIcon />
+                </Icon>
+              }
+              iconPosition="end"
+              onClick={switchTranslation}
+            >
+              {translation.switchBtn}
+            </Button>
+          </ToolbarItem>
+          <ToolbarItem variant="pagination">{renderPagination(PaginationVariant.top)}</ToolbarItem>
+        </ToolbarContent>
+      </Toolbar>
+    </React.Fragment>
+  );
+
+  const pageNav = (
+    <Nav aria-label={translation.nav.ariaLabel || undefined}>
+      <NavList>
+        <NavItem itemId={0} isActive to="#system-panel">
+          {translation.nav.systemPanel}
+        </NavItem>
+        <NavItem itemId={1} to="#policy">
+          {translation.nav.policy}
+        </NavItem>
+        <NavItem itemId={2} to="#auth">
+          {translation.nav.authentication}
+        </NavItem>
+        <NavItem itemId={3} to="#network">
+          {translation.nav.networkServices}
+        </NavItem>
+        <NavItem itemId={4} to="#server">
+          {translation.nav.server}
+        </NavItem>
+      </NavList>
+    </Nav>
+  );
+
+  const sidebar = (
+    <PageSidebar>
+      <PageSidebarBody>{pageNav}</PageSidebarBody>
+    </PageSidebar>
+  );
+
+  const [isDropdownOpen, setIsDropdownOpen] = React.useState(false);
+  const [isKebabDropdownOpen, setIsKebabDropdownOpen] = React.useState(false);
+  const [isFullKebabDropdownOpen, setIsFullKebabDropdownOpen] = React.useState(false);
+
+  const kebabDropdownItems = (
+    <>
+      <DropdownItem icon={<CogIcon />}>{translation.kebabDropdown.settings}</DropdownItem>
+      <DropdownItem icon={<HelpIcon />}>{translation.kebabDropdown.help}</DropdownItem>
+    </>
+  );
+
+  const userDropdownItems = (
+    <>
+      <DropdownItem key="group 2 profile">{translation.userDropdown.myProfile}</DropdownItem>
+      <DropdownItem key="group 2 user">{translation.userDropdown.userManagement}</DropdownItem>
+      <DropdownItem key="group 2 logout">{translation.userDropdown.logout}</DropdownItem>
+    </>
+  );
+
+  const onDropdownToggle = () => {
+    setIsDropdownOpen(!isDropdownOpen);
+  };
+
+  const onDropdownSelect = () => {
+    setIsDropdownOpen(false);
+  };
+
+  const onKebabDropdownToggle = () => {
+    setIsKebabDropdownOpen(!isKebabDropdownOpen);
+  };
+
+  const onKebabDropdownSelect = () => {
+    setIsKebabDropdownOpen(false);
+  };
+
+  const onFullKebabToggle = () => {
+    setIsFullKebabDropdownOpen(!isFullKebabDropdownOpen);
+  };
+
+  const onFullKebabSelect = () => {
+    setIsFullKebabDropdownOpen(false);
+  };
+
+  const masthead = (
+    <Masthead>
+      <MastheadToggle>
+        <PageToggleButton variant="plain" aria-label={translation.mastheadToggleAriaLabel}>
+          <BarsIcon />
+        </PageToggleButton>
+      </MastheadToggle>
+      <MastheadMain>
+        <MastheadBrand dir="ltr">
+          <Brand src={pfLogo} alt="PatternFly" heights={{ default: '36px' }} />
+          {translation.brandLanguage && <span className="brand-language">{translation.brandLanguage}</span>}
+        </MastheadBrand>
+      </MastheadMain>
+      <MastheadContent>
+        <Toolbar id="toolbar" isFullHeight isStatic>
+          <ToolbarContent>
+            <ToolbarGroup
+              variant="icon-button-group"
+              align={{ default: 'alignRight' }}
+              spacer={{ default: 'spacerNone', md: 'spacerMd' }}
+            >
+              <ToolbarGroup variant="icon-button-group" visibility={{ default: 'hidden', lg: 'visible' }}>
+                <ToolbarItem>
+                  <Button
+                    aria-label={translation.kebabDropdown.settings}
+                    variant={ButtonVariant.plain}
+                    icon={<CogIcon />}
+                  />
+                </ToolbarItem>
+                <ToolbarItem>
+                  <Button
+                    aria-label={translation.kebabDropdown.help}
+                    variant={ButtonVariant.plain}
+                    icon={<QuestionCircleIcon />}
+                  />
+                </ToolbarItem>
+              </ToolbarGroup>
+              <ToolbarItem visibility={{ default: 'hidden', md: 'visible', lg: 'hidden' }}>
+                <Dropdown
+                  isOpen={isKebabDropdownOpen}
+                  onSelect={onKebabDropdownSelect}
+                  onOpenChange={setIsKebabDropdownOpen}
+                  popperProps={{ position: 'right' }}
+                  toggle={(toggleRef) => (
+                    <MenuToggle
+                      ref={toggleRef}
+                      isExpanded={isKebabDropdownOpen}
+                      onClick={onKebabDropdownToggle}
+                      variant="plain"
+                      aria-label={translation.kebabDropdown.settingsAndHelp}
+                    >
+                      <EllipsisVIcon aria-hidden="true" />
+                    </MenuToggle>
+                  )}
+                >
+                  <DropdownList>{kebabDropdownItems}</DropdownList>
+                </Dropdown>
+              </ToolbarItem>
+              <ToolbarItem visibility={{ md: 'hidden' }}>
+                <Dropdown
+                  isOpen={isFullKebabDropdownOpen}
+                  onSelect={onFullKebabSelect}
+                  onOpenChange={setIsFullKebabDropdownOpen}
+                  popperProps={{ position: 'right' }}
+                  toggle={(toggleRef) => (
+                    <MenuToggle
+                      ref={toggleRef}
+                      isExpanded={isFullKebabDropdownOpen}
+                      onClick={onFullKebabToggle}
+                      variant="plain"
+                      aria-label={translation.kebabAndUserDropdown.toolbarMenuAriaLabel}
+                    >
+                      <EllipsisVIcon aria-hidden="true" />
+                    </MenuToggle>
+                  )}
+                >
+                  <DropdownGroup key="group 2" aria-label={translation.kebabAndUserDropdown.groupAriaLabel}>
+                    <DropdownList>{userDropdownItems}</DropdownList>
+                  </DropdownGroup>
+                  <Divider />
+                  <DropdownList>{kebabDropdownItems}</DropdownList>
+                </Dropdown>
+              </ToolbarItem>
+            </ToolbarGroup>
+            <ToolbarItem visibility={{ default: 'hidden', md: 'visible' }}>
+              <Dropdown
+                isOpen={isDropdownOpen}
+                onSelect={onDropdownSelect}
+                onOpenChange={setIsDropdownOpen}
+                popperProps={{ position: 'right' }}
+                toggle={(toggleRef) => (
+                  <MenuToggle
+                    ref={toggleRef}
+                    isExpanded={isDropdownOpen}
+                    onClick={onDropdownToggle}
+                    icon={<Avatar src={imgAvatar} alt="" />}
+                    isFullHeight
+                  >
+                    {translation.username}
+                  </MenuToggle>
+                )}
+              >
+                <DropdownList>{userDropdownItems}</DropdownList>
+              </Dropdown>
+            </ToolbarItem>
+          </ToolbarContent>
+        </Toolbar>
+      </MastheadContent>
+    </Masthead>
+  );
+
+  return (
+    <React.Fragment>
+      <Page sidebar={sidebar} header={masthead} isManagedSidebar>
+        <PageBreadcrumb>
+          <Breadcrumb aria-label={translation.breadcrumbs.ariaLabel || undefined}>
+            {Object.keys(breadcrumbItems).map((key, idx, arr) => (
+              <BreadcrumbItem key={idx} isActive={arr.length - 1 === idx} to={`${breadcrumbItems[key].url}`}>
+                {translation.breadcrumbs[key]}
+                {breadcrumbItems.length}
+              </BreadcrumbItem>
+            ))}
+          </Breadcrumb>
+        </PageBreadcrumb>
+        <PageSection variant="light">
+          <TextContent>
+            <Text component={TextVariants.h1}>{translation.title}</Text>
+            <Text component={TextVariants.p}>{translation.body}</Text>
+          </TextContent>
+        </PageSection>
+        <PageSection>
+          <Card>
+            {toolbarItems}
+            <Table variant="compact" aria-label={translation.table.ariaLabel}>
+              <Thead>
+                <Tr>
+                  {columns.map((column, columnIndex) => (
+                    <Th key={columnIndex}>{column}</Th>
+                  ))}
+                </Tr>
+              </Thead>
+              <Tbody>
+                {paginatedRows.map((row, rowIndex) => (
+                  <Tr key={rowIndex}>
+                    <>
+                      {Object.entries(row).map(([key, value]) => {
+                        if (key === 'status') {
+                          return (
+                            <Td key={key} width={15} dataLabel="Status">
+                              {renderLabel(value)}
+                            </Td>
+                          );
+                        } else if (key === 'url') {
+                          return (
+                            // Passing dir="rtl" forces truncation at the start of the URL,
+                            // resulting in the unique portion being visible regardless of language
+                            <Td key={key} dataLabel="URL" width={15}>
+                              <a href="#">
+                                <Truncate content={row.url} position={isDirRTL ? 'end' : 'start'} />
+                              </a>
+                            </Td>
+                          );
+                        } else {
+                          return (
+                            <Td key={key} dataLabel={key === 'lastModified' ? 'Last modified' : capitalize(key)}>
+                              {value}
+                            </Td>
+                          );
+                        }
+                      })}
+                    </>
+                  </Tr>
+                ))}
+              </Tbody>
+            </Table>
+            {renderPagination(PaginationVariant.bottom)}
+          </Card>
+        </PageSection>
+      </Page>
+    </React.Fragment>
+  );
+};

package/src/demos/RTL/examples/translations.en.json

@@ -0,0 +1,67 @@
+{
+  "title": "Main title",
+  "username": "John Doe",
+  "body": "This is a full page demo.",
+  "mastheadToggleAriaLabel": "Global navigation",
+  "kebabDropdown": {
+    "settings": "Settings",
+    "help": "Help",
+    "settingsAndHelp": "Settings and help"
+  },
+  "userDropdown": {
+    "myProfile": "My profile",
+    "userManagement": "User management",
+    "logout": "Log out"
+  },
+  "kebabAndUserDropdown": {
+    "toolbarMenuAriaLabel": "Toolbar menu",
+    "groupAriaLabel": "User actions"
+  },
+  "breadcrumbs": {
+    "home": "Home",
+    "category": "Category",
+    "subCategory": "Sub category"
+  },
+  "nav": {
+    "systemPanel": "System panel",
+    "policy": "Policy",
+    "authentication": "Authentication",
+    "networkServices": "Network services",
+    "server": "Server"
+  },
+  "switchBtn": "Switch to Hebrew",
+  "table": {
+    "ariaLabel": "Right to left demo table",
+    "columns": {
+      "servers": "Servers",
+      "status": "Status",
+      "location": "Location",
+      "modified": "Last modified",
+      "url": "URL"
+    },
+    "rows": {
+      "node": "Node",
+      "status": {
+        "stopped": "Stopped",
+        "running": "Running",
+        "down": "Down",
+        "needsMaintenance": "Needs maintenance"
+      },
+      "locations": {
+        "raleigh": "Raleigh",
+        "boston": "Boston",
+        "atlanta": "Atlanta",
+        "sanFrancisco": "San Francisco"
+      },
+      "lastModified": {
+        "oneHr": "1 hour ago",
+        "threeHrs": "3 hours ago",
+        "fiveHrs": "5 hours ago",
+        "sevenMins": "7 minutes ago",
+        "fortyTwoMins": "42 minutes ago",
+        "twoDays": "2 days ago",
+        "oneMonth": "1 month ago"
+      }
+    }
+  }
+}