@dxc-technology/halstack-react 3.4.1 → 5.0.0

package/dropdown/Dropdown.stories.tsx

@@ -0,0 +1,249 @@
+import React from "react";
+import { userEvent, within } from "@storybook/testing-library";
+import DxcDropdown from "./Dropdown";
+import Title from "../../.storybook/components/Title";
+import ExampleContainer from "../../.storybook/components/ExampleContainer";
+
+export default {
+  title: "Dropdown",
+  component: DxcDropdown,
+};
+
+const iconSVG = (
+  <svg viewBox="0 0 24 24" fill="currentColor">
+    <path d="M0 0h24v24H0z" fill="none" />
+    <path d="M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z" />
+  </svg>
+);
+
+const iconSVGLarge = (
+  <svg enable-background="new 0 0 24 24" height="48px" viewBox="0 0 24 24" width="48px" fill="currentColor">
+    <g>
+      <path d="M0,0h24v24H0V0z" fill="none" />
+      <path d="M0,0h24v24H0V0z" fill="none" />
+    </g>
+    <g>
+      <path d="M12,17.27L18.18,21l-1.64-7.03L22,9.24l-7.19-0.61L12,2L9.19,8.63L2,9.24l5.46,4.73L5.82,21L12,17.27z" />
+    </g>
+  </svg>
+);
+
+const options: any = [
+  {
+    value: "1",
+    label: "Amazon with a very long text",
+  },
+  {
+    value: "2",
+    label: "Ebay",
+  },
+  {
+    value: "3",
+    label: "Apple",
+  },
+];
+
+const option: any = [
+  {
+    value: "1",
+    label: "Ebay",
+  },
+];
+
+const icons = [
+  iconSVG,
+  iconSVGLarge,
+  "https://iconape.com/wp-content/files/yd/367773/svg/logo-linkedin-logo-icon-png-svg.png",
+];
+
+const optionsIcon: any = options.map((op, i) => ({ ...op, icon: icons[i] }));
+
+export const Chromatic = () => (
+  <>
+    <ExampleContainer>
+      <Title title="Default" theme="light" level={4} />
+      <DxcDropdown label="Default" options={options} onSelectOption={(value) => {}} />
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-hover">
+      <Title title="Hovered" theme="light" level={4} />
+      <DxcDropdown label="Hovered" options={options} onSelectOption={(value) => {}} />
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-focus-visible">
+      <Title title="Focused" theme="light" level={4} />
+      <DxcDropdown label="Focused" options={options} onSelectOption={(value) => {}} />
+    </ExampleContainer>
+    <ExampleContainer pseudoState="pseudo-active">
+      <Title title="Actived" theme="light" level={4} />
+      <DxcDropdown label="Actived" options={options} onSelectOption={(value) => {}} />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Disabled" theme="light" level={4} />
+      <DxcDropdown label="Disabled" options={options} onSelectOption={(value) => {}} disabled />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Caret hidden" theme="light" level={4} />
+      <DxcDropdown label="Caret hidden" options={options} onSelectOption={(value) => {}} caretHidden />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="With icon before" theme="light" level={4} />
+      <DxcDropdown label="Icon before" options={options} onSelectOption={(value) => {}} icon={iconSVG} />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="With icon after" theme="light" level={4} />
+      <DxcDropdown
+        label="Icon after"
+        options={options}
+        onSelectOption={(value) => {}}
+        icon="https://iconape.com/wp-content/files/yd/367773/svg/logo-linkedin-logo-icon-png-svg.png"
+        iconPosition="after"
+      />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Only icon" theme="light" level={4} />
+      <DxcDropdown options={options} onSelectOption={(value) => {}} icon={iconSVG} />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large icon" theme="light" level={4} />
+      <DxcDropdown label="Large icon" options={options} onSelectOption={(value) => {}} icon={iconSVGLarge} />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Disabled with icon" theme="light" level={4} />
+      <DxcDropdown
+        label="Disabled with icon"
+        options={options}
+        onSelectOption={(value) => {}}
+        icon={iconSVG}
+        disabled
+      />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Ellipsis" theme="light" level={4} />
+      <DxcDropdown
+        label="Very long text in dropdown button"
+        options={options}
+        onSelectOption={(value) => {}}
+        icon={iconSVG}
+        size="medium"
+      />
+    </ExampleContainer>
+    <Title title="Margins" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Xxsmall" theme="light" level={4} />
+      <DxcDropdown label="Xxsmall" options={options} onSelectOption={(value) => {}} icon={iconSVG} margin="xxsmall" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xsmall" theme="light" level={4} />
+      <DxcDropdown label="Xsmall" options={options} onSelectOption={(value) => {}} icon={iconSVG} margin="xsmall" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Small" theme="light" level={4} />
+      <DxcDropdown label="Small" options={options} onSelectOption={(value) => {}} icon={iconSVG} margin="small" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Medium" theme="light" level={4} />
+      <DxcDropdown label="Medium" options={options} onSelectOption={(value) => {}} icon={iconSVG} margin="medium" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large" theme="light" level={4} />
+      <DxcDropdown label="Large" options={options} onSelectOption={(value) => {}} icon={iconSVG} margin="large" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xlarge" theme="light" level={4} />
+      <DxcDropdown label="Xlarge" options={options} onSelectOption={(value) => {}} icon={iconSVG} margin="xlarge" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Xxlarge" theme="light" level={4} />
+      <DxcDropdown label="Xxlarge" options={options} onSelectOption={(value) => {}} icon={iconSVG} margin="xxlarge" />
+    </ExampleContainer>
+    <Title title="Sizes" theme="light" level={2} />
+    <ExampleContainer>
+      <Title title="Small" theme="light" level={4} />
+      <DxcDropdown label="Small" options={options} onSelectOption={(value) => {}} icon={iconSVG} size="small" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Medium" theme="light" level={4} />
+      <DxcDropdown label="Medium" options={options} onSelectOption={(value) => {}} icon={iconSVG} size="medium" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="Large" theme="light" level={4} />
+      <DxcDropdown label="Large" options={options} onSelectOption={(value) => {}} icon={iconSVG} size="large" />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="FitContent" theme="light" level={4} />
+      <DxcDropdown
+        label="FitContent"
+        options={options}
+        onSelectOption={(value) => {}}
+        icon={iconSVG}
+        size="fitContent"
+      />
+    </ExampleContainer>
+    <ExampleContainer>
+      <Title title="FillParent" theme="light" level={4} />
+      <DxcDropdown
+        label="FillParent"
+        options={options}
+        onSelectOption={(value) => {}}
+        icon={iconSVG}
+        size="fillParent"
+      />
+    </ExampleContainer>
+  </>
+);
+
+const DropdownWithOptions = () => (
+  <ExampleContainer expanded>
+    <Title title="Options" theme="light" level={4} />
+    <DxcDropdown label="Options with icon" options={optionsIcon} onSelectOption={(value) => {}} />
+  </ExampleContainer>
+);
+
+const DropdownHoverOption = () => (
+  <ExampleContainer pseudoState="pseudo-hover" expanded>
+    <Title title="Hovered option" theme="light" level={4} />
+    <DxcDropdown label="Hovered options" options={option} onSelectOption={(value) => {}} />
+  </ExampleContainer>
+);
+
+const DropdownActiveOption = () => (
+  <ExampleContainer pseudoState="pseudo-active" expanded>
+    <Title title="Actived option" theme="light" level={4} />
+    <DxcDropdown label="Actived options" options={option} onSelectOption={(value) => {}} />
+  </ExampleContainer>
+);
+
+const DropdownWithOptionsIconAfter = () => (
+  <ExampleContainer expanded>
+    <Title title="Icon after options" theme="light" level={4} />
+    <DxcDropdown
+      label="Icon after options"
+      options={optionsIcon}
+      onSelectOption={(value) => {}}
+      optionsIconPosition="after"
+    />
+  </ExampleContainer>
+);
+
+export const DropdownOptions = DropdownWithOptions.bind({});
+DropdownOptions.play = async ({ canvasElement }) => {
+  const canvas = within(canvasElement);
+  await userEvent.click(canvas.getByRole("button"));
+};
+
+export const DropdownHoveredOption = DropdownHoverOption.bind({});
+DropdownHoveredOption.play = async ({ canvasElement }) => {
+  const canvas = within(canvasElement);
+  await userEvent.click(canvas.getByRole("button"));
+};
+
+export const DropdownActivedOption = DropdownActiveOption.bind({});
+DropdownActivedOption.play = async ({ canvasElement }) => {
+  const canvas = within(canvasElement);
+  await userEvent.click(canvas.getByRole("button"));
+};
+
+export const DropdownOptionsIconAfter = DropdownWithOptionsIconAfter.bind({});
+DropdownOptionsIconAfter.play = async ({ canvasElement }) => {
+  const canvas = within(canvasElement);
+  await userEvent.click(canvas.getByRole("button"));
+};

package/dropdown/Dropdown.test.js

@@ -0,0 +1,189 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _react = _interopRequireDefault(require("react"));
+
+var _react2 = require("@testing-library/react");
+
+var _Dropdown = _interopRequireDefault(require("./Dropdown"));
+
+global.document.createRange = function () {
+  return {
+    setStart: function setStart() {},
+    setEnd: function setEnd() {},
+    commonAncestorContainer: {
+      nodeName: "BODY",
+      ownerDocument: document
+    }
+  };
+};
+
+describe("Dropdown component tests", function () {
+  test("Dropdown renders with correct label", function () {
+    var _render = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      label: "dropdown-test"
+    })),
+        getByText = _render.getByText;
+
+    expect(getByText("dropdown-test")).toBeTruthy();
+  });
+  test("Dropdown renders with correct icon before", function () {
+    var _render2 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      icon: "/testIcon",
+      label: "dropdown-test"
+    })),
+        getAllByRole = _render2.getAllByRole;
+
+    var image = getAllByRole("img")[0];
+    expect(image.getAttribute("src")).toEqual("/testIcon");
+  });
+  test("Dropdown renders with correct icon after", function () {
+    var _render3 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      icon: "/testIcon",
+      iconPosition: "after",
+      label: "dropdown-test"
+    })),
+        getAllByRole = _render3.getAllByRole;
+
+    var image = getAllByRole("img")[0];
+    expect(image.getAttribute("src")).toEqual("/testIcon");
+  });
+  test("onClick shows and hides option", function () {
+    var options = [{
+      value: 1,
+      label: "option-test"
+    }];
+
+    var _render4 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      options: options,
+      label: "dropdown-test"
+    })),
+        queryByText = _render4.queryByText;
+
+    var dropdown = queryByText("dropdown-test"); //Before clicked is not showed
+
+    expect(queryByText("option-test")).toBeFalsy();
+    (0, _react2.act)(function () {
+      _react2.fireEvent.click(dropdown);
+    });
+    expect(queryByText("option-test")).toBeTruthy();
+  });
+  test("Disabled dropdown is not clickable", function () {
+    var options = [{
+      value: 1,
+      label: "option-test"
+    }];
+
+    var _render5 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      options: options,
+      disabled: true,
+      label: "dropdown-test"
+    })),
+        queryByText = _render5.queryByText;
+
+    var dropdown = queryByText("dropdown-test");
+    expect(queryByText("option-test")).toBeFalsy();
+    (0, _react2.act)(function () {
+      _react2.fireEvent.click(dropdown);
+    });
+    expect(queryByText("option-test")).toBeFalsy();
+  });
+  test("Dropdown renders with correct icon before option", function () {
+    var options = [{
+      value: 1,
+      label: "option-test",
+      icon: "/testIcon"
+    }];
+
+    var _render6 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      options: options,
+      label: "dropdown-test"
+    })),
+        getByText = _render6.getByText,
+        getByRole = _render6.getByRole;
+
+    var dropdown = getByText("dropdown-test");
+    (0, _react2.act)(function () {
+      _react2.fireEvent.click(dropdown);
+    });
+    expect(getByRole("img").getAttribute("src")).toEqual("/testIcon");
+  });
+  test("Dropdown renders with correct icon after option", function () {
+    var options = [{
+      value: 1,
+      label: "option-test",
+      icon: "/testIcon"
+    }];
+
+    var _render7 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      options: options,
+      optionsIconPosition: "after",
+      label: "dropdown-test"
+    })),
+        getByText = _render7.getByText,
+        getByRole = _render7.getByRole;
+
+    var dropdown = getByText("dropdown-test");
+    (0, _react2.act)(function () {
+      _react2.fireEvent.click(dropdown);
+    });
+    expect(getByRole("img").getAttribute("src")).toEqual("/testIcon");
+  });
+  test("Dropdown renders with caret hidden", function () {
+    var _render8 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      caretHidden: true,
+      label: "dropdown-test"
+    })),
+        queryByRole = _render8.queryByRole;
+
+    expect(queryByRole("img")).toBeFalsy();
+  });
+  test("onSelectOption fuction is called correctly", function () {
+    var onSelectOption = jest.fn(function (i) {
+      return i;
+    });
+    var options = [{
+      value: 1,
+      label: "option-test"
+    }];
+
+    var _render9 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      options: options,
+      onSelectOption: onSelectOption,
+      label: "dropdown-test"
+    })),
+        getByText = _render9.getByText;
+
+    var dropdown = getByText("dropdown-test");
+    (0, _react2.act)(function () {
+      _react2.fireEvent.click(dropdown);
+    });
+    var option = getByText("option-test");
+    (0, _react2.act)(function () {
+      _react2.fireEvent.click(option);
+    });
+    expect(onSelectOption).toHaveBeenCalledWith(1);
+  });
+  test("expandOnHover shows and hides the option correctly", function () {
+    var options = [{
+      value: 1,
+      label: "option-test"
+    }];
+
+    var _render10 = (0, _react2.render)( /*#__PURE__*/_react["default"].createElement(_Dropdown["default"], {
+      options: options,
+      expandOnHover: true,
+      label: "dropdown-test"
+    })),
+        queryByText = _render10.queryByText;
+
+    var dropdown = queryByText("dropdown-test"); //Verify that is not showed before
+
+    expect(queryByText("option-test")).toBeFalsy();
+    (0, _react2.act)(function () {
+      _react2.fireEvent.mouseOver(dropdown);
+    });
+    expect(queryByText("option-test")).toBeTruthy();
+  });
+});

package/dropdown/types.d.ts

@@ -0,0 +1,80 @@
+/// <reference types="react" />
+declare type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
+declare type Margin = {
+    top?: Space;
+    bottom?: Space;
+    left?: Space;
+    right?: Space;
+};
+declare type SVG = React.SVGProps<SVGSVGElement>;
+declare type Option = {
+    /**
+     * Option display value.
+     */
+    label?: string;
+    /**
+     * Element or path used as the icon that will be placed next to the
+     * option label.
+     */
+    icon?: string | SVG;
+    /**
+     * Option inner value.
+     */
+    value: string;
+};
+declare type Props = {
+    /**
+     * An array of objects representing the options.
+     */
+    options: Option[];
+    /**
+     * In case options include icons, whether the icon should appear
+     * after or before the label.
+     */
+    optionsIconPosition?: "before" | "after";
+    /**
+     * Element or path used as the icon that will be placed next to the
+     * dropdown label.
+     */
+    icon?: string | SVG;
+    /**
+     * Whether the icon should appear after or before the label.
+     */
+    iconPosition?: "before" | "after";
+    /**
+     * Text to be placed within the dropdown.
+     */
+    label?: string;
+    /**
+     * Whether the arrow next to the label must be displayed or not.
+     */
+    caretHidden?: boolean;
+    /**
+     * This function will be called every time the selection changes.
+     * The value of the selected option will be passed as a parameter.
+     */
+    onSelectOption: (value: string) => void;
+    /**
+     * If true, the options are showed when the dropdown is hover.
+     */
+    expandOnHover?: boolean;
+    /**
+     * Size of the margin to be applied to the component.
+     * You can pass an object with 'top', 'bottom', 'left' and 'right'
+     * properties in order to specify different margin sizes.
+     */
+    margin?: Space | Margin;
+    /**
+     * Size of the component.
+     */
+    size?: "small" | "medium" | "large" | "fillParent" | "fitContent";
+    /**
+     * Value of the tabindex.
+     */
+    tabIndex?: number;
+    /**
+     * If true, the component will be disabled.
+     */
+    disabled?: boolean;
+};
+export default Props;

package/dropdown/types.js

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

package/file-input/FileInput.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import FileInputPropsType from "./types";
+declare const DxcFileInput: ({ name, mode, label, buttonLabel, dropAreaLabel, helperText, accept, minSize, maxSize, showPreview, multiple, disabled, callbackFile, value, margin, tabIndex, }: FileInputPropsType) => JSX.Element;
+export default DxcFileInput;