@dxc-technology/halstack-react 0.0.0-5908eb4 → 0.0.0-59b9187

package/link/Link.stories.tsx

@@ -0,0 +1,253 @@
+import React from "react";
+import DxcLink from "./Link";
+import Title from "../../.storybook/components/Title";
+import ExampleContainer from "../../.storybook/components/ExampleContainer";
+import { HalstackProvider } from "../HalstackContext";
+
+export default {
+  title: "Link",
+  component: DxcLink,
+};
+
+const icon = (
+  <svg viewBox="0 0 24 24" enableBackground="new 0 0 24 24" fill="currentColor">
+    <g id="Bounding_Box">
+      <rect fill="none" width="24" height="24" />
+    </g>
+    <g id="Master">
+      <path d="M19,9.3V4h-3v2.6L12,3L2,12h3v8h5v-6h4v6h5v-8h3L19,9.3z M10,10c0-1.1,0.9-2,2-2s2,0.9,2,2H10z" />
+    </g>
+  </svg>
+);
+
+const opinionatedTheme = {
+  link: {
+    baseColor: "#5f249f",
+  },
+};
+
+export const Chromatic = () => (
+  <>
+    <Title title="With anchor" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Disabled" theme="light" level={4} />
+      <DxcLink disabled>Test</DxcLink>
+      <Title title="Icon before" theme="light" level={4} />
+      <DxcLink href="https://www.google.com" icon="lock" iconPosition="before">
+        Test
+      </DxcLink>
+      <Title title="Icon after" theme="light" level={4} />
+      <DxcLink
+        href="https://www.youtube.com/"
+        icon="https://iconape.com/wp-content/files/yd/367773/svg/logo-linkedin-logo-icon-png-svg.png"
+        iconPosition="after"
+      >
+        Test
+      </DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-hover">
+      <Title title="With link hovered" theme="light" level={4} />
+      <DxcLink href="https://www.dxc.com">Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus">
+      <Title title="With link focused" theme="light" level={4} />
+      <DxcLink href="https://www.dxc.com">Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-active">
+      <Title title="With link active" theme="light" level={4} />
+      <DxcLink href="https://www.dxc.com">Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-visited">
+      <Title title="With link visited" theme="light" level={4} />
+      <DxcLink href="https://www.amazon.com">Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Inherit color" theme="light" level={4} />
+      This is a <DxcLink inheritColor>Test</DxcLink>.
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus">
+      <Title title="With brackets and focus" theme="light" level={4} />
+      This is a (
+      <DxcLink inheritColor href="https://www.google.com">
+        Test
+      </DxcLink>
+      ).
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-hover">
+      <Title title="Long text with hover" theme="light" level={4} />
+      Lorem{" "}
+      <DxcLink href="https://www.google.com" icon="filled_home">
+        Test
+      </DxcLink>{" "}
+      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{" "}
+      <DxcLink href="https://www.google.com" icon={icon} iconPosition="after">
+        Test
+      </DxcLink>{" "}
+      anim id est laborum.
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus">
+      <Title title="Long text with focus" theme="light" level={4} />
+      Lorem <DxcLink href="https://www.google.com">Test</DxcLink> 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.
+    </ExampleContainer>
+    <Title title="With button" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Disabled" theme="light" level={4} />
+      <DxcLink onClick={() => {}} disabled>
+        Test
+      </DxcLink>
+      <Title title="Icon before" theme="light" level={4} />
+      <DxcLink onClick={() => {}} icon={icon} iconPosition="before">
+        Test
+      </DxcLink>
+      <Title title="Icon after" theme="light" level={4} />
+      <DxcLink onClick={() => {}} icon={icon} iconPosition="after">
+        Test
+      </DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-hover">
+      <Title title="With link hovered" theme="light" level={4} />
+      <DxcLink onClick={() => {}}>Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus">
+      <Title title="With link focused" theme="light" level={4} />
+      <DxcLink onClick={() => {}}>Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-active">
+      <Title title="With link active" theme="light" level={4} />
+      <DxcLink onClick={() => {}}>Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-visited">
+      <Title title="With link visited" theme="light" level={4} />
+      <DxcLink onClick={() => {}}>Test</DxcLink>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Inherit color" theme="light" level={4} />
+      This is a{" "}
+      <DxcLink onClick={() => {}} inheritColor>
+        Test
+      </DxcLink>
+      .
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus">
+      <Title title="With brackets and focus" theme="light" level={4} />
+      This is a (
+      <DxcLink onClick={() => {}} inheritColor>
+        Test
+      </DxcLink>
+      ).
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-hover">
+      <Title title="Long text with hover" theme="light" level={4} />
+      Lorem{" "}
+      <DxcLink onClick={() => {}} href="https://www.google.com">
+        Test
+      </DxcLink>{" "}
+      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.
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus">
+      <Title title="Long text with focus" theme="light" level={4} />
+      Lorem{" "}
+      <DxcLink onClick={() => {}} href="https://www.google.com">
+        Test
+      </DxcLink>{" "}
+      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.
+    </ExampleContainer>
+    <Title title="Margins" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall margin" theme="light" level={4} />
+      <DxcLink margin="xxsmall" href="https://www.facebook.com/">
+        Test
+      </DxcLink>
+      <Title title="Xsmall margin" theme="light" level={4} />
+      <DxcLink margin="xsmall" href="https://www.linkedin.com/">
+        Test
+      </DxcLink>
+      <Title title="Small margin" theme="light" level={4} />
+      <DxcLink margin="small" href="https://www.linkedin.com/">
+        Test
+      </DxcLink>
+      <Title title="Medium margin" theme="light" level={4} />
+      <DxcLink margin="medium" href="https://www.linkedin.com/">
+        Test
+      </DxcLink>
+      <Title title="Large margin" theme="light" level={4} />
+      <DxcLink margin="large" href="https://www.linkedin.com/">
+        Test
+      </DxcLink>
+      <Title title="Xlarge margin" theme="light" level={4} />
+      <DxcLink margin="xlarge" href="https://www.linkedin.com/">
+        Test
+      </DxcLink>
+      <Title title="Xxlarge margin" theme="light" level={4} />
+      <DxcLink margin="xxlarge" href="https://www.linkedin.com/">
+        Test
+      </DxcLink>
+    </ExampleContainer>
+    <Title title="Opinionated theme" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Disabled" theme="light" level={4} />
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcLink disabled>Test</DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Icon before" theme="light" level={4} />
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcLink href="https://www.google.com" icon={icon} iconPosition="before">
+          Test
+        </DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Disabled" theme="light" level={4} />
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcLink disabled>Test</DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Icon after" theme="light" level={4} />{" "}
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcLink onClick={() => {}} icon={icon} iconPosition="after">
+          Test
+        </DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-hover">
+      <Title title="With link hovered" theme="light" level={4} />
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcLink onClick={() => {}}>Test</DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus">
+      <Title title="With link focused" theme="light" level={4} />
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcLink onClick={() => {}}>Test</DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-active">
+      <Title title="With link active" theme="light" level={4} />
+      <HalstackProvider theme={opinionatedTheme}>
+        <DxcLink onClick={() => {}}>Test</DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-visited">
+      <HalstackProvider theme={opinionatedTheme}>
+        <Title title="With link visited" theme="light" level={4} />
+        <DxcLink href="https://www.google.com">Test</DxcLink>
+      </HalstackProvider>
+    </ExampleContainer>
+  </>
+);

package/link/Link.test.js

@@ -0,0 +1,63 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _react = _interopRequireDefault(require("react"));
+var _react2 = require("@testing-library/react");
+var _Link = _interopRequireDefault(require("./Link.tsx"));
+describe("Link component tests", function () {
+  test("Link renders with correct text", function () {
+    var _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Link["default"], null, "Link")),
+      getByText = _render.getByText;
+    expect(getByText("Link")).toBeTruthy();
+  });
+  test("Link renders with correct href", function () {
+    var _render2 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Link["default"], {
+        href: "/testPage"
+      }, "Link")),
+      getByRole = _render2.getByRole;
+    expect(getByRole("link").getAttribute("href")).toEqual("/testPage");
+  });
+  test("Link renders with correct disabled state", function () {
+    var _render3 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Link["default"], {
+        href: "/testPage",
+        disabled: true
+      }, "Link")),
+      getByText = _render3.getByText;
+    expect(getByText("Link").hasAttribute("href")).toBeFalsy();
+    var _render4 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Link["default"], {
+        onClick: function onClick() {},
+        disabled: true
+      }, "LinkButton")),
+      getByTextLinkButton = _render4.getByText;
+    expect(getByTextLinkButton("LinkButton").hasAttribute("onclick")).toBeFalsy();
+  });
+  test("Link open new tab", function () {
+    var _render5 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Link["default"], {
+        href: "/testPage",
+        newWindow: true
+      }, "Link")),
+      getByRole = _render5.getByRole;
+    expect(getByRole("link").getAttribute("target")).toEqual("_blank");
+  });
+  test("Link onClick called", function () {
+    var onClick = jest.fn();
+    var _render6 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Link["default"], {
+        onClick: onClick
+      }, "Link")),
+      getByText = _render6.getByText;
+    var link = getByText("Link");
+    _react2.fireEvent.click(link);
+    expect(onClick).toHaveBeenCalled();
+  });
+  test("Disabled link onClick not called", function () {
+    var onClick = jest.fn();
+    var _render7 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Link["default"], {
+        onClick: onClick,
+        disabled: true
+      }, "Link")),
+      getByText = _render7.getByText;
+    var link = getByText("Link");
+    _react2.fireEvent.click(link);
+    expect(onClick).toHaveBeenCalledTimes(0);
+  });
+});

package/link/types.d.ts

@@ -0,0 +1,54 @@
+/// <reference types="react" />
+type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+type Margin = {
+    top?: Space;
+    bottom?: Space;
+    left?: Space;
+    right?: Space;
+};
+type SVG = React.ReactNode & React.SVGProps<SVGSVGElement>;
+export type LinkProps = {
+    /**
+     * If true, the link is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * If true, the color is inherited from parent.
+     */
+    inheritColor?: boolean;
+    /**
+     * Material Symbol name or SVG element as the icon that will be placed next to the link text.
+     */
+    icon?: string | SVG;
+    /**
+     * Indicates the position of the icon in the component.
+     */
+    iconPosition?: "before" | "after";
+    /**
+     * Page to be opened when the user clicks on the link.
+     */
+    href?: string;
+    /**
+     * If true, the page is opened in a new browser tab.
+     */
+    newWindow?: boolean;
+    /**
+     * If defined, the link will be displayed as a button. This
+     * function will be called when the user clicks the link.
+     */
+    onClick?: () => void;
+    /**
+     * Text of the link.
+     */
+    children: string;
+    /**
+     * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
+     * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
+     */
+    margin?: Space | Margin;
+    /**
+     * Value of the tabindex.
+     */
+    tabIndex?: number;
+};
+export {};

package/link/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/main.d.ts

@@ -0,0 +1,49 @@
+import DxcAlert from "./alert/Alert";
+import DxcAccordion from "./accordion/Accordion";
+import DxcButton from "./button/Button";
+import DxcCard from "./card/Card";
+import DxcCheckbox from "./checkbox/Checkbox";
+import DxcDialog from "./dialog/Dialog";
+import DxcDropdown from "./dropdown/Dropdown";
+import DxcSlider from "./slider/Slider";
+import DxcSwitch from "./switch/Switch";
+import DxcTabs from "./tabs/Tabs";
+import DxcProgressBar from "./progress-bar/ProgressBar";
+import DxcSpinner from "./spinner/Spinner";
+import DxcTable from "./table/Table";
+import DxcBox from "./box/Box";
+import DxcTag from "./tag/Tag";
+import DxcPaginator from "./paginator/Paginator";
+import DxcWizard from "./wizard/Wizard";
+import DxcLink from "./link/Link";
+import DxcHeading from "./heading/Heading";
+import DxcResultsetTable from "./resultset-table/ResultsetTable";
+import DxcChip from "./chip/Chip";
+import DxcApplicationLayout from "./layout/ApplicationLayout";
+import DxcToggleGroup from "./toggle-group/ToggleGroup";
+import DxcAccordionGroup from "./accordion-group/AccordionGroup";
+import DxcTextInput from "./text-input/TextInput";
+import DxcPasswordInput from "./password-input/PasswordInput";
+import DxcDateInput from "./date-input/DateInput";
+import DxcNumberInput from "./number-input/NumberInput";
+import DxcTextarea from "./textarea/Textarea";
+import DxcSelect from "./select/Select";
+import DxcFileInput from "./file-input/FileInput";
+import DxcRadioGroup from "./radio-group/RadioGroup";
+import DxcBleed from "./bleed/Bleed";
+import DxcInset from "./inset/Inset";
+import DxcQuickNav from "./quick-nav/QuickNav";
+import DxcNavTabs from "./nav-tabs/NavTabs";
+import DxcFlex from "./flex/Flex";
+import DxcTypography from "./typography/Typography";
+import DxcParagraph from "./paragraph/Paragraph";
+import DxcBulletedList from "./bulleted-list/BulletedList";
+import DxcGrid from "./grid/Grid";
+import DxcImage from "./image/Image";
+import DxcContainer from "./container/Container";
+import DxcBadge from "./badge/Badge";
+import DxcStatusLight from "./status-light/StatusLight";
+import DxcContextualMenu from "./contextual-menu/ContextualMenu";
+import DxcDivider from "./divider/Divider";
+import HalstackContext, { HalstackProvider, HalstackLanguageContext } from "./HalstackContext";
+export { DxcAlert, DxcButton, DxcCheckbox, DxcTextInput, DxcDropdown, DxcSwitch, DxcSlider, DxcTable, DxcTabs, DxcToggleGroup, DxcDialog, DxcCard, DxcProgressBar, DxcAccordion, DxcSpinner, DxcBox, DxcTag, DxcPaginator, DxcWizard, DxcLink, DxcHeading, DxcResultsetTable, DxcChip, DxcApplicationLayout, HalstackContext, HalstackLanguageContext, HalstackProvider, DxcAccordionGroup, DxcPasswordInput, DxcDateInput, DxcNumberInput, DxcTextarea, DxcSelect, DxcFileInput, DxcRadioGroup, DxcBleed, DxcInset, DxcQuickNav, DxcNavTabs, DxcFlex, DxcTypography, DxcParagraph, DxcBulletedList, DxcGrid, DxcImage, DxcContainer, DxcBadge, DxcStatusLight, DxcContextualMenu, DxcDivider, };