@onewelcome/react-lib-components 9.8.1 → 10.0.0

package/src/components/Form/Select/SingleSelect/Select.tsx

@@ -1,306 +0,0 @@
-/*
- * Copyright 2022 OneWelcome B.V.
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- */
-
-import classes from "./Select.module.scss";
-
-import React, {
-  createRef,
-  ForwardRefRenderFunction,
-  ReactElement,
-  useEffect,
-  useRef,
-  useState
-} from "react";
-import { useClickOutside } from "../../../../hooks/useClickOutside";
-import readyclasses from "../../../../readyclasses.module.scss";
-import { filterProps } from "../../../../util/helper";
-import { Icon, Icons } from "../../../Icon/Icon";
-import { Position, SingleSelectProps } from "../Select.interfaces";
-import { useSelectPositionList } from "../useSelectPositionList";
-import { useAddNewBtn } from "../useAddNewBtn";
-import { useSearch } from "./useSearch";
-import { useArrowNavigation } from "./useArrowNavigation";
-import { withReadOnly } from "../../../withReadOnly";
-import { RequiredSign } from "../../../RequiredSign/RequiredSign";
-import { FormStatusIndicator } from "../../FormStatusIndicator/FormStatusIndicator";
-import { useInlineEditing } from "../../../InlineEditing/InlineEditingContext";
-
-const SelectComponent: ForwardRefRenderFunction<HTMLSelectElement, SingleSelectProps> = (
-  {
-    children,
-    name,
-    disabled = false,
-    labeledBy,
-    placeholder,
-    describedBy,
-    selectButtonProps,
-    className,
-    error = false,
-    success = false,
-    value,
-    clearLabel = "Clear selection",
-    noResultsLabel = "No results found",
-    onChange,
-    addNew,
-    search,
-    isReadOnlyView,
-    ...rest
-  }: SingleSelectProps,
-  ref
-) => {
-  const [expanded, setExpanded] = useState(false);
-  const [display, setDisplay] = useState("");
-  const containerReference = useRef<HTMLDivElement>(null);
-  const optionListReference = useRef<HTMLDivElement>(null);
-  const [focusedSelectItem, setFocusedSelectItem] = useState(-1);
-  const [shouldClick, setShouldClick] = useState(false);
-  /** We need this, because whenever we use the arrow keys to select the select item, and we focus the currently selected item it fires the "click" listener in Option component. Instead, we only want this to fire if we press "enter" or "spacebar" so we set this to true whenever that is the case, and back to false when it has been executed. */
-  const [shouldFocusButtonAfterClose, setShouldFocusButtonAfterClose] = useState(false);
-  const optionsCount = React.Children.count(children);
-  const {
-    filter,
-    isSearching,
-    renderSearch,
-    searchInputRef,
-    setIsSearching,
-    searchThreshold,
-    searchVisible
-  } = useSearch({
-    expanded,
-    search,
-    searchInputClassName: classes["select-search"],
-    optionsCount,
-    setFocusedSelectItem
-  });
-  const { addBtnRef, addNewBtnOptionsContainerClassName, renderAddNew } = useAddNewBtn({
-    addNew,
-    filter,
-    focusedSelectItem,
-    optionsCount,
-    searchInputRef
-  });
-
-  const { inlineClassNames } = useInlineEditing();
-  const rootClassNames = inlineClassNames ? ` ${inlineClassNames}` : "";
-
-  const nativeSelect = (ref as React.RefObject<HTMLSelectElement>) || createRef();
-
-  const onOptionChangeHandler = (optionElement: HTMLElement | null) => {
-    if (nativeSelect.current && optionElement) {
-      nativeSelect.current.value = optionElement.getAttribute("data-value")!;
-      nativeSelect.current.dispatchEvent(new Event("change", { bubbles: true }));
-    }
-
-    setExpanded(false);
-  };
-
-  const customSelectButtonRef = useRef<HTMLButtonElement>(null);
-  const { onArrowNavigation } = useArrowNavigation({
-    expanded,
-    setExpanded,
-    isSearching,
-    setIsSearching,
-    setFocusedSelectItem,
-    onOptionChangeHandler,
-    childrenCount: optionsCount,
-    setShouldClick,
-    searchInputRef,
-    addBtnRef,
-    renderThreshold: searchThreshold,
-    isReadOnlyView: isReadOnlyView || !!rest["data-readonlyview"]
-  });
-
-  const { listPosition, opacity, optionsListMaxHeight, setListPosition, setOpacity } =
-    useSelectPositionList({ expanded, optionListReference, containerReference, addBtnRef });
-
-  const syncDisplayValue = (val: string) => {
-    React.Children.forEach(children, child => {
-      if (child.props.value === val) {
-        setDisplay(child.props.children);
-      }
-    });
-  };
-
-  /**
-   * @description We have to modify the children (Option component) to have an additional props that allows us to keep track of which one is selected and focused at all times and if a filter is active.
-   * The `children` prop can be either a single object (1 child) or an array of multiple children.
-   */
-  const renderOptions = () => {
-    if (isSearching || filter !== "") {
-      const filteredChildren = React.Children.toArray(children).filter(child =>
-        (child as ReactElement).props.children.toLowerCase().includes(filter.toLowerCase())
-      );
-
-      const internalChildren = _internalRenderChildren(filteredChildren as ReactElement[]);
-
-      if (internalChildren.length === 0) {
-        return <li className={classes["no-results"]}>{noResultsLabel}</li>;
-      }
-
-      return _internalRenderChildren(filteredChildren as ReactElement[]);
-    }
-
-    return _internalRenderChildren(children);
-
-    function _internalRenderChildren(internalChildren: ReactElement[]) {
-      return React.Children.map(internalChildren, (child, index) => {
-        return React.cloneElement(child, {
-          onFocusChange: (childIndex: number) => {
-            setFocusedSelectItem(childIndex);
-          },
-          onOptionSelect: (optionRef: React.RefObject<HTMLLIElement>) => {
-            onOptionChangeHandler(optionRef.current);
-            setShouldClick(false);
-          },
-          isSelected: child.props.value === value,
-          isSearching: isSearching,
-          selectOpened: expanded,
-          childIndex: index,
-          hasFocus: focusedSelectItem === index,
-          shouldClick: shouldClick,
-          isAddBtnFocused: addBtnRef.current === document.activeElement
-        });
-      });
-    }
-  };
-
-  const renderChevronIcon = () => {
-    return expanded ? (
-      <Icon className={classes["chevron-icon"]} icon={Icons.ChevronUp} />
-    ) : (
-      <Icon className={classes["chevron-icon"]} icon={Icons.ChevronDown} />
-    );
-  };
-
-  const nativeOnChangeHandler = (event: React.ChangeEvent<HTMLSelectElement>) => {
-    onChange?.(event);
-  };
-
-  useEffect(() => {
-    if (expanded) {
-      setFocusedSelectItem(0);
-      setShouldFocusButtonAfterClose(true);
-    }
-
-    if (!expanded && customSelectButtonRef.current && shouldFocusButtonAfterClose) {
-      customSelectButtonRef.current.focus();
-      setShouldFocusButtonAfterClose(false);
-    }
-  }, [expanded, customSelectButtonRef.current, shouldFocusButtonAfterClose]);
-
-  useEffect(() => {
-    syncDisplayValue(value);
-  }, [value]);
-
-  const myElementRef = useRef<HTMLDivElement>(null);
-
-  useClickOutside(myElementRef, () => {
-    if (!expanded) {
-      return;
-    }
-    setExpanded(false);
-    setListPosition(Position.Below);
-    setOpacity(0);
-  }, [expanded]);
-
-  const additionalClasses = [];
-  expanded && additionalClasses.push(classes.expanded);
-  error && additionalClasses.push(classes.error);
-  disabled && additionalClasses.push(classes.disabled);
-  className && additionalClasses.push(className);
-  success && additionalClasses.push(classes.success);
-
-  /** The native select is purely for external form libraries. We use it to emit an onChange with native select event object so they know exactly what's happening. */
-  return (
-    <div ref={myElementRef} className={`${classes["root"]}${rootClassNames}`}>
-      <select
-        {...filterProps(rest, /^data-/, false)}
-        tabIndex={-1}
-        aria-hidden="true"
-        ref={nativeSelect}
-        name={name}
-        onChange={nativeOnChangeHandler}
-        className={readyclasses["sr-only"]}
-      >
-        <option value=""></option>
-        {React.Children.map(children, child => (
-          <option value={child.props.value}></option>
-        ))}
-      </select>
-      <div
-        {...filterProps(rest, /^data-/)}
-        ref={containerReference}
-        onKeyDown={onArrowNavigation}
-        className={`custom-select ${classes.select} ${additionalClasses.join(" ")}`}
-      >
-        {searchVisible && renderSearch()}
-        <button
-          {...selectButtonProps}
-          onClick={() => {
-            setExpanded(isReadOnlyView || rest["data-readonlyview"] ? false : !expanded);
-          }}
-          ref={customSelectButtonRef}
-          type="button"
-          name={name}
-          className={`${classes["custom-select"]} ${additionalClasses.join(" ")} `}
-          style={{ display: expanded && searchVisible ? "none" : "block" }}
-          disabled={disabled}
-          aria-disabled={disabled}
-          aria-invalid={error}
-          aria-expanded={expanded}
-          aria-haspopup="listbox"
-          aria-labelledby={labeledBy}
-          aria-describedby={describedBy}
-        >
-          <div data-display className={classes["selected"]}>
-            {!value && placeholder && <span className={classes["placeholder"]}>{placeholder}</span>}
-            {value?.length > 0 && <span data-display-inner>{display}</span>}
-            <RequiredSign className={classes["required"]} />
-          </div>
-          <div className={classes["status"]}>
-            <FormStatusIndicator isReadOnlyView={isReadOnlyView} success={success} error={error}>
-              {renderChevronIcon()}
-            </FormStatusIndicator>
-          </div>
-        </button>
-        <div className="list-wrapper-container">
-          <div
-            ref={optionListReference}
-            className={`list-wrapper ${classes["list-wrapper"]}`}
-            style={{
-              display: expanded ? "block" : "none",
-              opacity: opacity,
-              maxHeight: optionsListMaxHeight.wrapper,
-              pointerEvents: expanded ? "auto" : "none",
-              bottom: listPosition === Position.Above ? "2.85rem" : "initial",
-              marginTop: "4px"
-            }}
-          >
-            <ul
-              className={addNewBtnOptionsContainerClassName}
-              role="listbox"
-              style={{ maxHeight: optionsListMaxHeight.list }}
-            >
-              {renderOptions()}
-            </ul>
-            {renderAddNew()}
-          </div>
-        </div>
-      </div>
-    </div>
-  );
-};
-export const Select = withReadOnly(React.forwardRef(SelectComponent));

package/src/components/Form/Select/SingleSelect/useArrowNavigation.ts

@@ -1,177 +0,0 @@
-/*
- * Copyright 2022 OneWelcome B.V.
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- */
-
-import { UseArrowNavigationParams } from "../Select.interfaces";
-
-/** @scope .*/
-export const useArrowNavigation = ({
-  expanded,
-  setExpanded,
-  isSearching,
-  setIsSearching,
-  setFocusedSelectItem,
-  onOptionChangeHandler,
-  childrenCount,
-  setShouldClick,
-  searchInputRef,
-  addBtnRef,
-  renderThreshold,
-  isReadOnlyView
-}: UseArrowNavigationParams) => {
-  const onArrowNavigation = (event: React.KeyboardEvent) => {
-    const codesToPreventDefault = [
-      "ArrowDown",
-      "ArrowUp",
-      "ArrowLeft",
-      "ArrowRight",
-      "Space",
-      "Escape",
-      "End",
-      "Home"
-    ];
-
-    const codesToPreventDefaultWhenSearching = [
-      "ArrowDown",
-      "ArrowUp",
-      "Enter",
-      "Escape",
-      "MetaLeft",
-      "MetaRight"
-    ];
-
-    const isAddBtnFocused = addBtnRef?.current === document.activeElement;
-
-    if (isReadOnlyView) {
-      return;
-    }
-
-    if (expanded) {
-      codesToPreventDefault.push("Tab");
-    }
-
-    if (addBtnRef) {
-      codesToPreventDefaultWhenSearching.push("Tab");
-    }
-
-    if (codesToPreventDefault.includes(event.code) && !event.metaKey && !isSearching) {
-      event.preventDefault();
-    }
-
-    if (isSearching && codesToPreventDefaultWhenSearching.includes(event.code)) {
-      event.preventDefault();
-    }
-
-    if (isSearching) {
-      switch (event.code) {
-        case "ArrowDown":
-        case "Enter":
-          setIsSearching(false);
-          setFocusedSelectItem(0);
-          return;
-        case "ArrowUp":
-          setIsSearching(false);
-          setFocusedSelectItem(childrenCount - 1);
-          return;
-        case "Escape":
-          setIsSearching(false);
-          setExpanded(false);
-          return;
-        case "Tab":
-          if (addBtnRef?.current) {
-            addBtnRef.current.focus();
-            return;
-          }
-          setIsSearching(false);
-          setExpanded(false);
-      }
-    } else {
-      switch (event.code) {
-        case "ArrowDown":
-          if (!expanded) {
-            setExpanded(true);
-            setFocusedSelectItem(0);
-            return;
-          }
-          setFocusedSelectItem(prevState => {
-            return prevState + 1 > childrenCount - 1 ? 0 : prevState + 1;
-          });
-          return;
-        case "ArrowUp":
-          if (!expanded) {
-            setExpanded(true);
-            setFocusedSelectItem(childrenCount - 1);
-            return;
-          }
-
-          setFocusedSelectItem(prevState => {
-            return prevState - 1 < 0 ? childrenCount - 1 : prevState - 1;
-          });
-          return;
-        case "Space":
-          if (!expanded) {
-            setExpanded(true);
-            setFocusedSelectItem(0);
-            return;
-          }
-
-          onOptionChangeHandler(event.target as HTMLElement);
-          setShouldClick(true);
-          setExpanded(false);
-
-          return;
-        case "Enter":
-        case "Home":
-          setFocusedSelectItem(0);
-
-          return;
-        case "Tab":
-          if (childrenCount >= renderThreshold && expanded && !isAddBtnFocused) {
-            setIsSearching(true);
-            searchInputRef.current?.focus();
-            return;
-          } else if (addBtnRef?.current && expanded && !isAddBtnFocused) {
-            addBtnRef.current.focus();
-            return;
-          }
-          setExpanded(false);
-
-          return;
-        case "Escape":
-          if (expanded) {
-            setExpanded(false);
-          }
-          return;
-        case "End":
-          setFocusedSelectItem(childrenCount - 1);
-          return;
-        case "ArrowLeft":
-          if (event.metaKey && expanded) {
-            event.preventDefault();
-            setFocusedSelectItem(0);
-          }
-          return;
-        case "ArrowRight":
-          if (event.metaKey && expanded) {
-            event.preventDefault();
-            setFocusedSelectItem(childrenCount - 1);
-          }
-          return;
-      }
-    }
-  };
-
-  return { onArrowNavigation };
-};

package/src/components/Form/Select/SingleSelect/useSearch.tsx

@@ -1,113 +0,0 @@
-/*
- * Copyright 2022 OneWelcome B.V.
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- */
-
-import React, { useEffect, useRef, useState } from "react";
-import { SearchProps } from "../Select.interfaces";
-import { Input } from "../../Input/Input";
-
-interface Props {
-  search?: SearchProps;
-  optionsCount: number;
-  searchInputClassName: string;
-  expanded: boolean;
-  setFocusedSelectItem: (idx: number) => void;
-}
-
-/** @scope .*/
-export const useSearch = ({
-  search,
-  optionsCount,
-  searchInputClassName,
-  expanded,
-  setFocusedSelectItem
-}: Props) => {
-  const [filter, setFilter] = useState("");
-  const [isSearching, setIsSearching] = useState(false);
-
-  const DEFAULT_RENDER_THRESHOLD = 10;
-
-  const searchInputRef = useRef<HTMLInputElement>(null);
-
-  const threshold = search?.renderThreshold ?? DEFAULT_RENDER_THRESHOLD;
-  const hasEnoughChildren = optionsCount >= threshold;
-
-  const filterResults = (event: React.ChangeEvent<HTMLInputElement>) => {
-    setFilter(event.currentTarget.value);
-  };
-
-  const shouldRenderSearch = () => {
-    if (search?.enabled) {
-      return hasEnoughChildren;
-    }
-
-    if (search) {
-      return search.enabled as boolean;
-    }
-
-    return optionsCount > DEFAULT_RENDER_THRESHOLD;
-  };
-
-  const renderSearch = () => (
-    <Input
-      {...(search?.searchInputProps ?? {})}
-      ref={searchInputRef}
-      onFocus={() => setIsSearching(true)}
-      onBlur={() => setIsSearching(false)}
-      onChange={filterResults}
-      className={searchInputClassName}
-      wrapperProps={{
-        className: search?.searchInputProps?.wrapperProps?.className
-      }}
-      style={{
-        display: expanded ? "block" : "none"
-      }}
-      type="text"
-      name="search-option"
-      placeholder={search?.searchPlaceholder ? search?.searchPlaceholder : "Search item"}
-    />
-  );
-
-  const resetSearchState = () => {
-    setFilter("");
-    setIsSearching(false);
-    setFocusedSelectItem(-1);
-  };
-
-  const visible = shouldRenderSearch();
-
-  useEffect(() => {
-    search?.searchInputProps?.reset && resetSearchState();
-  }, [search?.searchInputProps?.reset]);
-
-  useEffect(() => {
-    const searchDeactivated =
-      !visible &&
-      !isSearching; /*solves issue in MultiSelect when we filtered result and selected result causes list to be shorter than threshold so still we have a filter applied but can't change it due to `visible` variable has false  */
-    if (searchDeactivated) {
-      resetSearchState();
-    }
-  }, [isSearching, visible]);
-
-  return {
-    renderSearch,
-    setIsSearching,
-    searchVisible: visible,
-    searchThreshold: threshold,
-    searchInputRef,
-    filter,
-    isSearching
-  };
-};

package/src/components/Form/Select/useAddNewBtn.module.scss

@@ -1,66 +0,0 @@
-/*!
- * Copyright 2022 OneWelcome B.V.
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- */
-@use "src/mixins.module";
-@use "src/variables";
-@use "src/functions" as *;
-
-ul.has-sibling {
-  padding-bottom: 2px;
-}
-
-.action-button {
-  position: relative;
-  border: none;
-  border-top: 1px solid var(--color-blue-grey50);
-  width: 100%;
-  height: relativeToBaseFontSize(2.5);
-  padding: 0.625rem 0.75rem;
-  margin: 0 0 0.25rem;
-  background-color: var(--light);
-  border-radius: var(--input-border-radius);
-  color: var(--default);
-  text-align: left;
-  box-sizing: border-box;
-  cursor: pointer;
-
-  font-family: var(--font-family);
-  font-size: var(--form-control-font-size);
-
-  &:focus,
-  &.focus {
-    outline: none;
-
-    &::before {
-      @include mixins.focusVisibleOutline($outlineOffset: 0, $selectors: null);
-      content: "";
-      position: absolute;
-      top: 0;
-      left: 0.125rem;
-      height: 100%;
-      width: calc(100% - 0.25rem);
-      opacity: 1;
-      z-index: calc(variables.$popover-z-index + 1);
-    }
-  }
-
-  &:hover {
-    background-color: var(--color-blue-grey50);
-  }
-
-  &:active {
-    background-color: var(--color-blue-grey100);
-  }
-}