playbook_ui 13.24.0.pre.alpha.play1305drycontenttag2689 → 13.25.0.pre.alpha.PBNTR272Dropdownkitv42769

data/app/pb_kits/playbook/pb_dropdown/_dropdown.scss

@@ -0,0 +1,181 @@
+@import "../tokens/colors";
+@import "../tokens/spacing";
+@import "../tokens/typography";
+@import "../tokens/border_radius";
+@import "../tokens/shadows";
+@import "../tokens/positioning";
+@import "../pb_body/body_mixins";
+@import "../pb_textarea/textarea_mixin";
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+@keyframes fadeOut {
+  from {
+    opacity: 1;
+  }
+
+  to {
+    opacity: 0;
+  }
+}
+
+.pb_dropdown {
+  .dropdown_wrapper {
+    [class*=dropdown_trigger_wrapper] {
+      @include pb_body;
+      border: 1px solid $border_light;
+      background-color: $white;
+      height: 45px;
+      @media (hover: hover) {
+        &:hover,
+        &:active,
+        &:focus {
+          background-color: $focus_input_light;
+          input {
+            background-color: $focus_input_light;
+          }
+        }
+      }
+
+      .dropdown_input {
+        @include pb_body;
+        border: unset;
+        border-radius: $border_rad_heavier;
+        padding: 0;
+        background-color: $white;
+        &:focus-visible {
+          outline: none;
+        }
+      }
+      &:focus {
+        box-shadow: 0px 0px 0 1px $primary;
+        outline: unset;
+        transition: box-shadow 0.15s ease-in-out;
+      }
+      
+      &[class*=_select_only] {
+        box-shadow: inset 0 -11px 20px rgba($primary, 0.05);
+      }
+
+      &[class*=_focus] {
+        box-shadow: 0px 0px 0 1px $primary;
+        transition: box-shadow 0.1s ease-in-out;
+      }
+    }
+
+    .pb_dropdown_container {
+      background-color: $white;
+      overflow: hidden;
+      box-shadow: $shadow_deep;
+      border-radius: $border_rad_heavier;
+      border: 1px solid $border_light;
+      margin-top: $space_xs;
+      z-index: $z_1;
+      width: 100%;
+
+      .pb_dropdown_option {
+        cursor: pointer;
+        &:hover {
+          background-color: $border_light;
+        }
+      }
+
+      .dropdown_option_focused {
+        background-color: $border_light;
+      }
+
+      .dropdown_option {
+        width: 100%;
+      }
+
+      .dropdown_option_list {
+        border-bottom: 1px solid $border_light;
+      }
+      .dropdown_option_selected {
+        background-color: $primary;
+        [class^="pb_body"],
+        [class^="pb_title_kit"] {
+          color: $white !important;
+        }
+        &:hover {
+          background-color: $primary !important;
+        }
+      }
+    }
+    .close {
+      display: none;
+      animation-name: fadeOut;
+      animation-duration: 150ms;
+      animation-timing-function: linear;
+      animation-fill-mode: forwards;
+    }
+
+    .open {
+      display: block;
+      animation-name: fadeIn;
+      animation-duration: 150ms;
+      animation-timing-function: linear;
+      animation-fill-mode: forwards;
+    }
+  }
+
+  &.dark {
+    .dropdown_wrapper {
+      [class*=dropdown_trigger_wrapper] {
+        @include pb_body_light_dark;
+        background-color: rgba($white, 0.1) !important;
+        background: none;
+        border-color: rgba($white, 0.15);
+        @media (hover: hover) {
+          &:hover,
+          &:active,
+          &:focus {
+            background-color: rgba($white, 0.05) !important;
+          }
+        }
+        [class^="pb_body"] {
+          color: $white;
+        }
+        &[class*=_select_only] {
+          box-shadow: inset 0 -11px 20px rgba($white, 0.05) !important;
+        }
+
+        .dropdown_input {
+          background-color: unset;
+          color: $white;
+        }
+      }
+    }
+    .pb_dropdown_container {
+      background-color: $bg_dark !important;
+      border-color: rgba($white, 0.15);
+      color: $white;
+      .dropdown_option_list {
+        border-color: rgba($white, 0.15);
+      }
+      [class^="pb_body"],
+      [class^="pb_title_kit"] {
+        color: $white !important;
+      }
+
+      .pb_dropdown_option {
+        &:hover {
+          background-color: $hover_dark;
+        }
+      }
+      .dropdown_option_focused {
+        background-color: $hover_dark;
+      }
+      .dropdown_option_selected {
+        background-color: $primary;
+      }
+    }
+  }
+}

data/app/pb_kits/playbook/pb_dropdown/_dropdown.tsx

@@ -0,0 +1,266 @@
+import React, { useState, useRef, useEffect, ReactElement } from "react";
+import classnames from "classnames";
+import { buildAriaProps, buildCss, buildDataProps, buildHtmlProps } from "../utilities/props";
+import { globalProps } from "../utilities/globalProps";
+
+import Body from "../pb_body/_body";
+import Caption from "../pb_caption/_caption";
+
+import DropdownContainer from "./subcomponents/DropdownContainer";
+import DropdownOption from "./subcomponents/DropdownOption";
+import DropdownTrigger from "./subcomponents/DropdownTrigger";
+import DropdownContext from "./context";
+import useDropdown from "./hooks/useDropdown";
+
+import {
+  separateChildComponents,
+  prepareSubcomponents,
+} from "./utilities/subComponentHelper";
+import { GenericObject } from "../types";
+
+type DropdownProps = {
+  aria?: { [key: string]: string };
+  autocomplete?: boolean;
+  children?: React.ReactChild[] | React.ReactChild | ReactElement[];
+  className?: string;
+  dark?: boolean;
+  data?: { [key: string]: string };
+  htmlOptions?: {[key: string]: string | number | boolean | (() => void)},
+  id?: string;
+  isClosed?: boolean;
+  label?: string;
+  onSelect?: (arg: GenericObject) => null;
+  options: GenericObject;
+  triggerRef?: any;
+};
+
+const Dropdown = (props: DropdownProps) => {
+  const {
+    aria = {},
+    autocomplete = false,
+    children,
+    className,
+    dark = false,
+    data = {},
+    htmlOptions = {},
+    id,
+    isClosed = true,
+    label,
+    onSelect,
+    options,
+    triggerRef
+  } = props;
+
+  const ariaProps = buildAriaProps(aria);
+  const dataProps = buildDataProps(data);
+  const htmlProps = buildHtmlProps(htmlOptions);
+  const classes = classnames(
+    buildCss("pb_dropdown"),
+    globalProps(props),
+    className
+  );
+
+  const [isDropDownClosed, setIsDropDownClosed, toggleDropdown] = useDropdown(isClosed);
+
+  const [filterItem, setFilterItem] = useState("");
+  const [selected, setSelected] = useState<GenericObject>({});
+  const [isInputFocused, setIsInputFocused] = useState(false);
+  const [hasTriggerSubcomponent, setHasTriggerSubcomponent] = useState(true);
+  const [hasContainerSubcomponent, setHasContainerSubcomponent] =
+    useState(true);
+  //state for keyboard events
+  const [focusedOptionIndex, setFocusedOptionIndex] = useState(-1);
+
+  const dropdownRef = useRef(null);
+  const inputRef = useRef(null);
+  const inputWrapperRef = useRef(null);
+  const dropdownContainerRef = useRef(null);
+
+  const { trigger, container, otherChildren } =
+    separateChildComponents(children);
+
+  useEffect(() => {
+    // Set the parent element of the trigger to relative to allow for absolute positioning of the dropdown
+    //Only needed for when useDropdown hook used with external trigger
+    if (triggerRef?.current) {
+      const parentElement = triggerRef.current.parentNode;
+      if (parentElement) {
+          parentElement.style.position = 'relative';
+      }
+  }
+  // Handle clicks outside the dropdown
+    const handleClickOutside = (e: MouseEvent) => {
+      let targetElement = e.target as HTMLElement;
+      let shouldClose = true;
+  
+      while (targetElement && shouldClose) {
+        //Only needed for when useDropdown hook used with external trigger
+        if (targetElement.getAttribute('data-dropdown') === 'pb-dropdown-trigger') {
+          shouldClose = false;
+        }
+        targetElement = targetElement.parentElement as HTMLElement;
+      }
+      if (
+        inputWrapperRef.current && !inputWrapperRef.current.contains(e.target) &&
+        (dropdownContainerRef.current && !dropdownContainerRef.current.contains(e.target)) &&
+        shouldClose
+      ) {
+        setIsDropDownClosed(true);
+        setFocusedOptionIndex(-1);
+        setIsInputFocused(false);
+      }
+    };
+  
+    window.addEventListener("click", handleClickOutside);
+    return () => {
+      window.removeEventListener("click", handleClickOutside);
+    };
+  }, []);
+
+  useEffect(() => {
+    setHasTriggerSubcomponent(!!trigger);
+    setHasContainerSubcomponent(!!container);
+  }, []);
+
+// dropdown to toggle with external control
+  useEffect(()=> {
+    setIsDropDownClosed(isClosed)
+   },[isClosed])
+
+  const filteredOptions = options?.filter((option: GenericObject) =>
+    option.label.toLowerCase().includes(filterItem.toLowerCase())
+  );
+
+// For keyboard accessibility: Set focus within dropdown to selected item if it exists
+  useEffect(() => {
+    if (!isDropDownClosed) { 
+        let newIndex = 0; 
+        if (selected && selected?.label) {
+            const selectedIndex = filteredOptions.findIndex((option: GenericObject) => option.label === selected.label);
+            if (selectedIndex >= 0) {
+                newIndex = selectedIndex;
+            }
+        }
+        setFocusedOptionIndex(newIndex);
+    }
+}, [isDropDownClosed]);
+
+
+  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    setFilterItem(e.target.value);
+    setIsDropDownClosed(false);
+  };
+
+  const handleOptionClick = (selectedItem: GenericObject) => {
+    setSelected(selectedItem);
+    setFilterItem("");
+    setIsDropDownClosed(true);
+    onSelect && onSelect(selectedItem);
+  };
+
+  const handleWrapperClick = () => {
+    autocomplete && inputRef.current.focus();
+    toggleDropdown();
+  };
+
+  const handleBackspace = () => {
+    setSelected({});
+    onSelect && onSelect(null);
+    setFocusedOptionIndex(-1);
+  };
+
+  const componentsToRender = prepareSubcomponents({
+    children,
+    hasTriggerSubcomponent,
+    hasContainerSubcomponent,
+    trigger,
+    container,
+    otherChildren,
+    dark
+  });
+
+
+  return (
+    <div {...ariaProps} 
+        {...dataProps} 
+        {...htmlProps}
+        className={classes} 
+        id={id}
+        style={triggerRef ? { position: "absolute"} : { position: "relative"}}
+    >
+      <DropdownContext.Provider
+          value={{
+              autocomplete,
+              dropdownContainerRef,
+              filteredOptions,
+              filterItem,
+              focusedOptionIndex,
+              handleBackspace,
+              handleChange,
+              handleOptionClick,
+              handleWrapperClick,
+              inputRef,
+              inputWrapperRef,
+              isDropDownClosed,
+              isInputFocused,
+              options,
+              selected,
+              setFocusedOptionIndex,
+              setIsDropDownClosed,
+              setIsInputFocused,
+              setSelected,
+              toggleDropdown,
+              triggerRef
+          }}
+      >
+        {label &&
+        <Caption
+            dark={dark}
+            marginBottom="xs"
+            text={label}
+        />
+        }
+        <div className="dropdown_wrapper" 
+            onBlur={() => {
+                // Debounce to delay the execution to prevent jumpiness in Focus state
+                setTimeout(() => {
+                    if (!dropdownRef.current.contains(document.activeElement)) {
+                        setIsInputFocused(false);
+                    }
+                }, 0);
+            }}
+            onFocus={() => setIsInputFocused(true)}
+            ref={dropdownRef}
+        >
+          {children ? (
+            <>
+              {componentsToRender.map((component, index) => (
+                <React.Fragment key={index}>{component}</React.Fragment>
+              ))}
+            </>
+          ) : (
+            <>
+              <DropdownTrigger />
+              <DropdownContainer>
+                {options &&
+                  options?.map((option: GenericObject) => (
+                    <Dropdown.Option key={option.id} 
+                        option={option}
+                    >
+                      <Body text={option.label} />
+                    </Dropdown.Option>
+                  ))}
+              </DropdownContainer>
+            </>
+          )}
+        </div>
+      </DropdownContext.Provider>
+    </div>
+  )
+};
+
+Dropdown.Option = DropdownOption;
+Dropdown.Trigger = DropdownTrigger;
+Dropdown.Container = DropdownContainer;
+
+export default Dropdown;

data/app/pb_kits/playbook/pb_dropdown/context/index.tsx

@@ -0,0 +1,5 @@
+import { createContext } from "react";
+
+const DropdownContext = createContext<any>({});
+
+export default DropdownContext;

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_default.jsx

@@ -0,0 +1,38 @@
+import React from 'react'
+import { Dropdown } from '../../'
+
+const DropdownDefault = (props) => {
+
+  const options = [
+    {
+      label: "United States",
+      value: "United States",
+    },
+    {
+      label: "Canada",
+      value: "Canada",
+    },
+    {
+      label: "Pakistan",
+      value: "Pakistan",
+    }
+  ];  
+
+
+  return (
+  <div>
+    <Dropdown
+        options={options}
+        {...props}
+    >
+      {options.map((option) => (
+        <Dropdown.Option key={option.id} 
+            option={option}
+        /> 
+      ))}
+    </Dropdown>
+  </div>
+  )
+}
+
+export default DropdownDefault

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_default.md

@@ -0,0 +1 @@
+`options` for the Dropdown and `option` for the Dropdown.Option are the only required props for this kit. `options` must be an array of objects. Each object can contain any key/value pairs needed but 'label' and 'value' are required.

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_with_autocomplete.jsx

@@ -0,0 +1,87 @@
+import React, { useState } from 'react'
+import { Dropdown, User, Badge, FlexItem } from '../..'
+
+const DropdownWithAutocomplete = (props) => {
+// eslint-disable-next-line no-unused-vars
+  const [selectedOption, setSelectedOption] = useState();
+
+  const options = [
+    {
+      label: "Jasper Furniss",
+      value: "Jasper Furniss",
+      territory: "PHL",
+      title: "Senior UX Engineer",
+      id: "jasper-furniss",
+      status: "Offline"
+    },
+    {
+      label: "Ramon Ruiz",
+      value: "Ramon Ruiz",
+      territory: "PHL",
+      title: "Senior UX Desinger",
+      id: "ramon-ruiz",
+      status: "Away"
+    },
+    {
+      label: "Jason Cypret",
+      value: "Jason Cypret",
+      territory: "PHL",
+      title: "VP of User Experience",
+      id: "jason-cypret",
+      status: "Online"
+    },
+    {
+      label: "Courtney Long",
+      value: "Courtney Long",
+      territory: "PHL",
+      title: "UX Design Mentor",
+      id: "courtney-long",
+      status: "Online"
+    }
+  ];
+
+
+  return (
+  <div>
+    <Dropdown autocomplete
+        onSelect={(selectedItem) => setSelectedOption(selectedItem)}
+        options={options}
+        {...props}
+    >
+        {options.map((option) => (
+          <Dropdown.Option key={option.id} 
+              option={option}
+          >
+            <>
+              <FlexItem>
+                <User
+                    align="left"
+                    avatar
+                    name={option.label}
+                    orientation="horizontal"
+                    territory={option.territory}
+                    title={option.title}
+                />
+              </FlexItem>
+              <FlexItem>
+                <Badge
+                    rounded
+                    text={option.status}
+                    variant={`${
+                        option.status === "Offline"
+                        ? "neutral"
+                        : option.status === "Online"
+                        ? "success"
+                        : "warning"
+                    }`}
+                />
+              </FlexItem>
+            </>
+          </Dropdown.Option>
+        ))}
+    </Dropdown>
+  </div>
+  )
+}
+
+export default  DropdownWithAutocomplete

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_with_autocomplete.md

@@ -0,0 +1 @@
+The `autocomplete` prop can be used to add autocomplete or typeahead functionality to the Dropdown's default Trigger. This prop is set to 'false' by default. 

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_with_autocomplete_and_custom_display.jsx

@@ -0,0 +1,102 @@
+import React, { useState } from 'react'
+import { Dropdown, User, Badge, FlexItem, Avatar } from '../..'
+
+const DropdownWithAutocompleteAndCustomDisplay = (props) => {
+// eslint-disable-next-line no-unused-vars
+  const [selectedOption, setSelectedOption] = useState();
+
+  const options = [
+    {
+      label: "Jasper Furniss",
+      value: "Jasper Furniss",
+      territory: "PHL",
+      title: "Senior UX Engineer",
+      id: "jasper-furniss",
+      status: "Offline"
+    },
+    {
+      label: "Ramon Ruiz",
+      value: "Ramon Ruiz",
+      territory: "PHL",
+      title: "Senior UX Desinger",
+      id: "ramon-ruiz",
+      status: "Away"
+    },
+    {
+      label: "Jason Cypret",
+      value: "Jason Cypret",
+      territory: "PHL",
+      title: "VP of User Experience",
+      id: "jason-cypret",
+      status: "Online"
+    },
+    {
+      label: "Courtney Long",
+      value: "Courtney Long",
+      territory: "PHL",
+      title: "UX Design Mentor",
+      id: "courtney-long",
+      status: "Online"
+    }
+  ];
+
+  const CustomDisplay = () => {
+    return (
+      <>
+      {
+        selectedOption && (
+            <Avatar
+                name={selectedOption.label}
+                size="xs"
+            />
+        )
+      }
+    </>
+    )
+  };
+
+  return (
+  <div>
+    <Dropdown autocomplete
+        onSelect={(selectedItem) => setSelectedOption(selectedItem)}
+        options={options}
+        {...props}
+    >
+        <Dropdown.Trigger customDisplay={<CustomDisplay/>} />
+        {options.map((option) => (
+          <Dropdown.Option key={option.id} 
+              option={option}
+          >
+            <>
+              <FlexItem>
+                <User
+                    align="left"
+                    avatar
+                    name={option.label}
+                    orientation="horizontal"
+                    territory={option.territory}
+                    title={option.title}
+                />
+              </FlexItem>
+              <FlexItem>
+                <Badge
+                    rounded
+                    text={option.status}
+                    variant={`${
+                        option.status === "Offline"
+                        ? "neutral"
+                        : option.status === "Online"
+                        ? "success"
+                        : "warning"
+                    }`}
+                />
+              </FlexItem>
+            </>
+          </Dropdown.Option>
+        ))}
+    </Dropdown>
+  </div>
+  )
+}
+
+export default  DropdownWithAutocompleteAndCustomDisplay

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_with_autocomplete_and_custom_display.md

@@ -0,0 +1 @@
+`autocomplete` prop can also be used in conjunction with the `customDisplay` prop.