@patternfly/react-core 6.5.0-prerelease.3 → 6.5.0-prerelease.31

package/src/demos/DateTimePicker.md

@@ -14,96 +14,12 @@ In this demo, learn how to use a [CalendarMonth](/components/date-and-time/calen
 
 ### Date and time picker
 
-```ts file="./examples/DateTimePicker/DateTimePicker.tsx"
+```ts file="examples/DateTimePicker/DateTimePicker.tsx"
 
 ```
 
 ### Date and time range picker
 
-```js
-import { useState } from 'react';
-import { Flex, FlexItem, InputGroup, InputGroupItem, DatePicker, isValidDate, TimePicker, yyyyMMddFormat, updateDateTime } from '@patternfly/react-core';
-
-DateTimeRangePicker = () => {
-  const [from, setFrom] = useState();
-  const [to, setTo] = useState();
-
-  const toValidator = (date) => {
-    return isValidDate(from) && yyyyMMddFormat(date) >= yyyyMMddFormat(from)
-      ? ''
-      : 'The "to" date must be after the "from" date';
-  };
-
-  const onFromDateChange = (_event, inputDate, newFromDate) => {
-    if (isValidDate(from) && isValidDate(newFromDate) && inputDate === yyyyMMddFormat(newFromDate)) {
-      newFromDate.setHours(from.getHours());
-      newFromDate.setMinutes(from.getMinutes());
-    }
-    if (isValidDate(newFromDate) && inputDate === yyyyMMddFormat(newFromDate)) {
-      setFrom(new Date(newFromDate));
-    }
-  };
-
-  const onFromTimeChange = (_event, time, hour, minute) => {
-    if (isValidDate(from)) {
-      const updatedFromDate = new Date(from);
-      updatedFromDate.setHours(hour);
-      updatedFromDate.setMinutes(minute);
-      setFrom(updatedFromDate);
-    }
-  };
-
-  const onToDateChange = (_event, inputDate, newToDate) => {
-    if (isValidDate(to) && isValidDate(newToDate) && inputDate === yyyyMMddFormat(newToDate)) {
-      newToDate.setHours(to.getHours());
-      newToDate.setMinutes(to.getMinutes());
-    }
-    if (isValidDate(newToDate) && inputDate === yyyyMMddFormat(newToDate)) {
-      setTo(newToDate);
-    }
-  };
-
-  const onToTimeChange = (_event, time, hour, minute) => {
-    if (isValidDate(to)) {
-      const updatedToDate = new Date(to);
-      updatedToDate.setHours(hour);
-      updatedToDate.setMinutes(minute);
-      setTo(updatedToDate);
-    }
-  };
+```ts file="examples/DateTimePicker/DateTimeRangePicker.tsx"
 
-  return (
-    <Flex direction={{ default: 'column', lg: 'row' }}>
-      <FlexItem>
-        <InputGroup>
-          <InputGroupItem>
-            <DatePicker onChange={onFromDateChange} aria-label="Start date" placeholder="YYYY-MM-DD" />
-          </InputGroupItem>
-          <InputGroupItem>
-            <TimePicker aria-label="Start time" style={{ width: '150px' }} onChange={onFromTimeChange} />
-          </InputGroupItem>
-        </InputGroup>
-      </FlexItem>
-      <FlexItem>to</FlexItem>
-      <FlexItem>
-        <InputGroup>
-          <InputGroupItem>
-            <DatePicker
-              value={isValidDate(to) ? yyyyMMddFormat(to) : to}
-              onChange={onToDateChange}
-              isDisabled={!isValidDate(from)}
-              rangeStart={from}
-              validators={[toValidator]}
-              aria-label="End date"
-              placeholder="YYYY-MM-DD"
-            />
-          </InputGroupItem>
-          <InputGroupItem>
-            <TimePicker style={{ width: '150px' }} onChange={onToTimeChange} isDisabled={!isValidDate(from)} />
-          </InputGroupItem>
-        </InputGroup>
-      </FlexItem>
-    </Flex>
-  );
-}
 ```

package/src/demos/JumpLinks.md

@@ -21,134 +21,7 @@ JumpLinks has a scrollspy built-in to make your implementation easier. When impl
 
 This demo expands on the previous to show the JumpLinks in a vertical layout with subsections. It scrolls the [Page](/components/page)'s `mainContainerId` with an `offset` calculated based on the height of the masthead and the nav list when it appears above the content. The headings are given a tab index to allow the jump links to focus on them.
 
-```js isFullscreen
-import { useEffect, useState } from 'react';
-import {
-  PageSection,
-  JumpLinks,
-  JumpLinksItem,
-  JumpLinksList,
-  PageGroup,
-  Sidebar,
-  SidebarContent,
-  SidebarPanel,
-  Switch,
-  Title,
-  Content,
-  getResizeObserver
-} from '@patternfly/react-core';
-import { DashboardWrapper } from '@patternfly/react-core/dist/js/demos/DashboardWrapper';
-import mastheadStyles from '@patternfly/react-styles/css/components/Masthead/masthead';
-
-ScrollspyH2 = () => {
-  const headings = [1, 2, 3, 4, 5];
-
-  const [isVertical, setIsVertical] = useState(true);
-  const [offsetHeight, setOffsetHeight] = useState(10);
-  const offsetForPadding = 10;
-  let masthead;
-
-  // Update offset based on the masthead and jump links nav heights.
-  useEffect(() => {
-    masthead = document.getElementsByClassName(mastheadStyles.masthead)[0];
-
-    if (isVertical) {
-      setOffsetHeight(masthead.offsetHeight + offsetForPadding);
-    } else {
-      // Append jump links nav height to the masthead height when value exists.
-      const jumpLinksHeaderHeight = document.getElementsByClassName('pf-m-sticky')[0].offsetHeight;
-      jumpLinksHeaderHeight && setOffsetHeight(masthead.offsetHeight + jumpLinksHeaderHeight + offsetForPadding);
-    }
-
-    
-  }, [isVertical]);
-
-  getResizeObserver(
-    document.getElementsByClassName(mastheadStyles.masthead)[0],
-    () => {
-      if (isVertical) {
-        setOffsetHeight(masthead.offsetHeight + offsetForPadding);
-      } else {
-        // Append jump links nav height to the masthead height when value exists.
-        const jumpLinksHeaderHeight = document.getElementsByClassName('pf-m-sticky')[0].offsetHeight;
-        jumpLinksHeaderHeight && setOffsetHeight(masthead.offsetHeight + jumpLinksHeaderHeight + offsetForPadding);
-      }
-    },
-    true
-  );
-
-  return (
-    <DashboardWrapper breadcrumb={null} mainContainerId="scrollable-element">
-      <PageSection aria-labelledby='main-title'>
-        <Title headingLevel="h1" size="2xl" id='main-title'>
-          Main title
-        </Title>
-        <Switch
-          id="is-vertical"
-          label="Vertical jump links"
-          isChecked={isVertical}
-          onChange={(_event, check) => setIsVertical(check)}
-        />
-      </PageSection>
-      <PageSection padding={{ default: 'noPadding' }} >
-        <Sidebar hasGutter orientation={!isVertical && 'stack'}>
-          <SidebarPanel variant="sticky">
-            <PageSection aria-label='Jump links navigation'>
-              <JumpLinks
-                isVertical={isVertical}
-                isCentered={!isVertical}
-                label="Jump to section"
-                scrollableSelector=".pf-v6-c-page__main-container"
-                offset={offsetHeight}
-                expandable={{ default: isVertical ? 'expandable' : 'nonExpandable', md: 'nonExpandable' }}
-                isExpanded
-              >
-                {headings.map(i => (
-                  <JumpLinksItem key={i} href={`#heading-${i}`}>
-                    {`Heading ${i}`}
-                    <JumpLinksList></JumpLinksList>
-                  </JumpLinksItem>
-                ))}
-              </JumpLinks>
-            </PageSection>
-          </SidebarPanel>
-          <SidebarContent hasNoBackground>
-            <PageSection aria-label='Main content'>
-              <Content>
-                {headings.map(i => (
-                  <div key={i} style={{ maxWidth: '800px', marginBottom: '32px' }}>
-                    <h2 id={`heading-${i}`} tabIndex={-1}>
-                      {`Heading ${i}`}
-                    </h2>
-                    <p>
-                      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
-                      labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
-                      nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit
-                      esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt
-                      in culpa qui officia deserunt mollit anim id est laborum.
-                    </p>
-                    <br />
-                    <p>
-                      At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum
-                      deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non
-                      provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum
-                      fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta
-                      nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus,
-                      omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis
-                      debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non
-                      recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus
-                      maiores alias consequatur aut perferendis doloribus asperiores repellat.
-                    </p>
-                  </div>
-                ))}
-              </Content>
-            </PageSection>
-          </SidebarContent>
-        </Sidebar>
-      </PageSection>
-    </DashboardWrapper>
-  );
-};
+```ts file="examples/JumpLinks/JumpLinksScrollspy.tsx" isFullscreen 
 ```
 
 ### With drawer
@@ -157,5 +30,5 @@ This demo shows how jump links can be used in combination with a drawer.
 
 This demo uses a `scrollableRef` prop on the JumpLinks component, which is a React ref to the `DrawerContent` component.
 
-```js isFullscreen file="./examples/JumpLinks/JumpLinksWithDrawer.js"
+```ts file="examples/JumpLinks/JumpLinksWithDrawer.tsx" isFullscreen
 ```

package/src/demos/Page.md

@@ -3,7 +3,7 @@ id: Page
 section: components
 ---
 
-import { useState } from 'react';
+import { useState, useRef, useEffect } from 'react';
 import BellIcon from '@patternfly/react-icons/dist/esm/icons/bell-icon';
 import CogIcon from '@patternfly/react-icons/dist/esm/icons/cog-icon';
 import HelpIcon from '@patternfly/react-icons/dist/esm/icons/help-icon';
@@ -13,7 +13,12 @@ import BarsIcon from '@patternfly/react-icons/dist/esm/icons/bars-icon';
 import AttentionBellIcon from '@patternfly/react-icons/dist/esm/icons/attention-bell-icon';
 import LightbulbIcon from '@patternfly/react-icons/dist/esm/icons/lightbulb-icon';
 import EllipsisVIcon from '@patternfly/react-icons/dist/esm/icons/ellipsis-v-icon';
+import CubeIcon from '@patternfly/react-icons/dist/esm/icons/cube-icon';
+import FolderIcon from '@patternfly/react-icons/dist/esm/icons/folder-icon';
+import CloudIcon from '@patternfly/react-icons/dist/esm/icons/cloud-icon';
+import CodeIcon from '@patternfly/react-icons/dist/esm/icons/code-icon';
 import pfLogo from '@patternfly/react-core/src/demos/assets/PF-HorizontalLogo-Color.svg';
+import pfIconLogo from '@patternfly/react-core/src/demos/assets/PF-IconLogo-color.svg';
 
 - All examples set the `isManagedSidebar` prop on the Page component to have the sidebar automatically close for smaller screen widths. You can also manually control this behavior by not adding the `isManagedSidebar` prop and instead:
 
@@ -49,3 +54,9 @@ When adding a context selector/perspective switcher in a `PageSidebar`, you must
 ```ts file='./examples/Page/PageContextSelector.tsx' isFullscreen
 
 ```
+
+### Docked nav
+
+```ts file='./examples/Page/PageDockedNav.tsx' isFullscreen
+
+```

package/src/demos/ProgressDemo.md

@@ -9,77 +9,14 @@ import accessibilityStyles from '@patternfly/react-styles/css/utilities/Accessib
 
 ### Basic
 
-```js
-import { useState } from 'react';
-import { Progress, Button, Stack, StackItem } from '@patternfly/react-core';
-import accessibilityStyles from '@patternfly/react-styles/css/utilities/Accessibility/accessibility';
-
-ProgressStepperDemo = () => {
-  const [currentValue, setCurrentValue] = useState(0);
-
-  const onProgressUpdate = (nextValue) => {
-    setCurrentValue(nextValue);
-  };
+```ts file="examples/Progress/ProgressBasic.tsx"
 
-  return (
-    <Stack>
-      <StackItem>
-        <Button onClick={() => onProgressUpdate(currentValue - 10)} isDisabled={currentValue === 0}>
-          Decrease value
-        </Button>{' '}
-        <Button onClick={() => onProgressUpdate(currentValue + 10)} isDisabled={currentValue === 100}>
-          Increase value
-        </Button>
-        <br />
-        <br />
-      </StackItem>
-      <StackItem>
-        <div className={accessibilityStyles.screenReader} aria-live="polite">
-          {`Progress value is ${currentValue}%.`}
-        </div>
-        <Progress value={currentValue} title="Title" />
-      </StackItem>
-    </Stack>
-  );
-};
 ```
 
 ### With only increasing progress
 
 Sometimes a progress bar should only show increases to progress state. In this case, before the next value is set it should be checked against the current progress. The `Decrease progress` button attempts to set a lower progress value, simulating an update to a progress state that isn't desired, but won't change the progress state due to this check.
 
-```js
-import { useState } from 'react';
-import { Progress, Button, Stack, StackItem } from '@patternfly/react-core';
-
-ProgressStepperDemo = () => {
-  const [currentValue, setCurrentValue] = useState(0);
-
-  const onProgressUpdate = (nextValue) => {
-    if (nextValue > currentValue) {
-      setCurrentValue(nextValue);
-    }
-  };
+```ts file="examples/Progress/ProgressWithOnlyIncreasing.tsx"
 
-  return (
-    <Stack>
-      <StackItem>
-        <Button onClick={() => onProgressUpdate(currentValue - 10)} isDisabled={currentValue === 0}>
-          Decrease value
-        </Button>{' '}
-        <Button onClick={() => onProgressUpdate(currentValue + 10)} isDisabled={currentValue === 100}>
-          Increase value
-        </Button>
-        <br />
-        <br />
-      </StackItem>
-      <StackItem>
-          <div className={accessibilityStyles.screenReader} aria-live="polite">
-          {`Progress value is ${currentValue}%.`}
-        </div>
-        <Progress value={currentValue} title="Title" />
-      </StackItem>
-    </Stack>
-  );
-};
 ```

package/src/demos/ProgressStepperDemo.md

@@ -10,77 +10,6 @@ import accessibilityStyles from '@patternfly/react-styles/css/utilities/Accessib
 
 ### Basic
 
-```js
-import { useState } from 'react';
-import { ProgressStepper, ProgressStep, Button, Stack, StackItem } from '@patternfly/react-core';
-import accessibilityStyles from '@patternfly/react-styles/css/utilities/Accessibility/accessibility';
-
-ProgressStepperDemo = () => {
-  const [currentStep, setCurrentStep] = useState(0);
-
-  const steps = [
-    { title: 'First step', id: 'step1' },
-    { title: 'Second step', id: 'step2' },
-    { title: 'Third step', id: 'step3' },
-    { title: 'Fourth step', id: 'step4' },
-    { title: 'Fifth step', id: 'step5' }
-  ];
-
-  const onStepForward = event => {
-    const next = currentStep + 1;
-    setCurrentStep(next <= 5 ? next : 4);
-  };
-
-  const onStepBack = event => {
-    const next = currentStep - 1;
-    setCurrentStep(next > 0 ? next : 0);
-  };
-
-  return (
-    <Stack>
-      <StackItem>
-        <Button onClick={onStepBack} isDisabled={currentStep === 0}>
-          Step back
-        </Button>{' '}
-        <Button onClick={onStepForward} isDisabled={currentStep === 5}>
-          Step forward
-        </Button>
-        <br />
-        <br />
-      </StackItem>
-      <StackItem>
-        <div className={accessibilityStyles.screenReader} aria-live="polite">
-          {steps[currentStep] && `On ${steps[currentStep].title}.`}
-          {steps[currentStep - 1] && `${steps[currentStep - 1].title} was successful.`}
-        </div>
-        <ProgressStepper>
-          {steps.map((step, index) => {
-            let variant = 'pending';
-            let ariaLabel = 'pending step';
-            if (index < currentStep) {
-              variant = 'success';
-              ariaLabel = 'completed step, step with success';
-            } else if (index === currentStep) {
-              variant = 'info';
-              ariaLabel = 'current step';
-            }
+```ts file="examples/ProgressStepper/ProgressStepperBasic.tsx"
 
-            return (
-              <ProgressStep
-                id={index}
-                titleId={step.id}
-                key={index}
-                variant={variant}
-                isCurrent={index === currentStep}
-                aria-label={ariaLabel}
-              >
-                {step.title}
-              </ProgressStep>
-            );
-          })}
-        </ProgressStepper>
-      </StackItem>
-    </Stack>
-  );
-};
 ```