@thecb/components 6.2.9 → 6.3.0-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thecb/components",
-  "version": "6.2.9",
+  "version": "6.3.0-beta.0",
   "description": "Common lib for CityBase react components",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/src/components/atoms/display-card/DisplayCard.js

@@ -6,7 +6,8 @@ import Paragraph from "../paragraph";
 import Cluster from "../layouts/Cluster";
 import ButtonWithAction from "../button-with-action";
 import ButtonWithLink from "../button-with-link";
-import { WHITE, CHARADE_GREY } from "../../../constants/colors";
+import { WHITE, CHARADE_GREY, STORM_GREY } from "../../../constants/colors";
+import { Popover } from "../../molecules";
 
 const DisplayCard = ({
   title,
@@ -14,18 +15,34 @@ const DisplayCard = ({
   buttonText,
   buttonAction,
   url,
-  link = false
+  link = false,
+  helpText,
+  usePopover = false,
+  popoverTriggerText = "",
+  popoverContent = "",
+  popoverExtraStyles,
+  popoverTextExtraStyles
 }) => (
   <Box padding="0 0 16px">
     <Stack childGap="0rem">
       <Box padding="0 0 8px 0">
-        <Paragraph
-          variant="pL"
-          color={CHARADE_GREY}
-          extraStyles={`letter-spacing: 0.29px`}
-        >
-          {title}
-        </Paragraph>
+        <Cluster justify="space-between" align="center" overflow>
+          <Paragraph
+            variant="pL"
+            color={CHARADE_GREY}
+            extraStyles={`letter-spacing: 0.29px`}
+          >
+            {title}
+          </Paragraph>
+          {usePopover && (
+            <Popover
+              triggerText={popoverTriggerText}
+              content={popoverContent}
+              popoverExtraStyles={popoverExtraStyles}
+              popoverTextExtraStyles={popoverTextExtraStyles}
+            />
+          )}
+        </Cluster>
       </Box>
       <Box padding="0">
         <Box
@@ -56,6 +73,14 @@ const DisplayCard = ({
                 dataQa={buttonText}
                 extraStyles={`min-width: 0;`}
               />
+            ) : helpText ? (
+              <Text
+                variant="p"
+                color={STORM_GREY}
+                extraStyles={`font-style: italic;`}
+              >
+                {helpText}
+              </Text>
             ) : (
               <Fragment />
             )}

package/src/components/atoms/text/Text.js

@@ -18,6 +18,7 @@ const Text = ({
   as,
   dataQa,
   children,
+  variant = "p",
   ...rest
 }) => (
   <TextSpan
@@ -32,6 +33,7 @@ const Text = ({
     onKeyPress={onKeyPress}
     data-qa={dataQa}
     $textWrap={textWrap}
+    $variant={variant}
     {...rest}
   >
     {safeChildren(children, <span />)}

package/src/components/molecules/index.js

@@ -20,7 +20,9 @@ export { default as PaymentButtonBar } from "./payment-button-bar";
 export { default as PaymentDetails } from "./payment-details";
 export { default as PaymentFormACH } from "./payment-form-ach";
 export { default as PaymentFormCard } from "./payment-form-card";
+export { default as PeriscopeDashboardIframe } from "./periscope-dashboard-iframe";
 export { default as PhoneForm } from "./phone-form";
+export { default as Popover } from "./popover";
 export { default as RadioSection } from "./radio-section";
 export { default as RegistrationForm } from "./registration-form";
 export { default as ResetConfirmationForm } from "./reset-confirmation-form";
@@ -33,4 +35,3 @@ export { default as TermsAndConditionsModal } from "./terms-and-conditions-modal
 export { default as Timeout } from "./timeout";
 export { default as WelcomeModule } from "./welcome-module";
 export { default as WorkflowTile } from "./workflow-tile";
-export { default as PeriscopeDashboardIframe } from "./periscope-dashboard-iframe";

package/src/components/molecules/popover/Popover.js

@@ -0,0 +1,119 @@
+import React, { useState, useContext } from "react";
+import { themeComponent } from "../../../util/themeUtils";
+import Text from "../../atoms/text";
+import Paragraph from "../../atoms/paragraph";
+import { Box } from "../../atoms/layouts";
+import ButtonWithAction from "../../atoms/button-with-action";
+import { useOutsideClickHook } from "../../../util";
+import { noop } from "../../../util/general";
+import { fallbackValues } from "./Popover.theme";
+
+const Popover = ({
+  themeValues,
+  triggerText = "",
+  content = "",
+  useIcon = false,
+  icon: Icon,
+  iconHelpText = "", // for screen-readers, required if using an icon for trigger
+  popoverID = 0,
+  popoverFocus = false,
+  extraStyles,
+  textExtraStyles,
+  minWidth = "250px",
+  maxWidth = "300px",
+  height = "auto",
+  position // { top: string, right: string, bottom: string, left: string }
+}) => {
+  const { hoverColor, activeColor, popoverTriggerColor } = themeValues;
+  const { top = "-110px", right = "auto", bottom = "auto", left = "-225px" } =
+    position ?? {};
+
+  const [popoverOpen, togglePopover] = useState(false);
+
+  const handleTogglePopover = popoverState => {
+    if (popoverOpen !== popoverState) {
+      togglePopover(popoverState);
+    }
+  };
+
+  const triggerRef = useOutsideClickHook(() => handleTogglePopover(false));
+
+  return (
+    <Box padding="0" extraStyles={`position: relative; ${extraStyles}`}>
+      <ButtonWithAction
+        action={() => noop}
+        onFocus={() => {
+          console.log("on focus") || handleTogglePopover(true);
+        }}
+        onBlur={() => {
+          console.log("on blur") || handleTogglePopover(false);
+        }}
+        onKeyDown={e => {
+          if (e.keyCode === 27) {
+            console.log("on key down") || handleTogglePopover(false);
+          }
+        }}
+        onTouchStart={() =>
+          console.log("on touch start") || handleTogglePopover(true)
+        }
+        onTouchEnd={() =>
+          console.log("on touch end") || handleTogglePopover(false)
+        }
+        onMouseEnter={() => handleTogglePopover(true)}
+        onMouseLeave={() => handleTogglePopover(false)}
+        contentOverride
+        variant="smallGhost"
+        tabIndex="0"
+        id={`btnPopover${popoverID}`}
+        aria-expanded={popoverOpen}
+        aria-labelledby={`btnPopover${popoverID}_info Disclosure${popoverID}`}
+        aria-describedby={`Disclosure${popoverID}`}
+        aria-controls={`Disclosed${popoverID}`}
+        ref={triggerRef}
+      >
+        {useIcon && <Icon />}
+        {useIcon && (
+          <Box padding="0" srOnly>
+            <Text id={`btnPopover${popoverID}_info`}>{iconHelpText}</Text>
+          </Box>
+        )}
+        {!useIcon && (
+          <Text
+            color={popoverTriggerColor}
+            extraStyles={`&:active { color: ${activeColor}; } &:hover { color: ${hoverColor} }; ${textExtraStyles}`}
+          >
+            {triggerText}
+          </Text>
+        )}
+      </ButtonWithAction>
+      <Box
+        background="white"
+        borderRadius="4px"
+        boxShadow="0px 2px 14px 0px rgb(246, 246, 249), 0px 3px 8px 0px rgb(202, 206, 216)"
+        id={`Disclosed${popoverID}`}
+        role={"region"}
+        aria-describedby={`Disclosure${popoverID}`}
+        tabIndex={popoverFocus && popoverOpen ? "0" : "-1"}
+        minWidth={minWidth}
+        maxWidth={maxWidth}
+        extraStyles={`
+          display: ${popoverOpen ? "block" : "none"}; 
+          position: absolute; 
+          top: ${top}; 
+          right: ${right}; 
+          bottom: ${bottom}; 
+          left: ${left};
+          height: ${height}
+          `}
+      >
+        <Paragraph>{content}</Paragraph>
+        <Box
+          padding="0"
+          extraStyles={`position: absolute; content: ""; width: 0; height: 0; border-left: 8px solid transparent; border-right: 8px solid transparent; border-top: 8px solid rgba(255, 255, 255, 0.85); filter: drop-shadow(2px 8px 14px black); bottom: -8px; right: 10px;`}
+        />
+      </Box>
+    </Box>
+  );
+};
+
+export default themeComponent(Popover, "Popover", fallbackValues);

package/src/components/molecules/popover/Popover.theme.js

@@ -0,0 +1,9 @@
+const hoverColor = "#116285";
+const activeColor = "#0E506D";
+const popoverTriggerColor = "#15749D";
+
+export const fallbackValues = {
+  hoverColor,
+  activeColor,
+  popoverTriggerColor
+};

package/src/components/molecules/popover/index.js

@@ -0,0 +1,3 @@
+import Popover from "./Popover";
+
+export default Popover;

package/src/util/index.js

@@ -2,5 +2,6 @@ import * as formats from "./formats";
 import * as general from "./general";
 import * as theme from "./themeUtils";
 import useFocusInvalidInput from "./focusFirstInvalidInputHook";
+import useOutsideClickHook from "./useOutsideClickHook";
 
-export { formats, general, theme, useFocusInvalidInput };
+export { formats, general, theme, useFocusInvalidInput, useOutsideClickHook };

package/src/util/useOutsideClickHook.js

@@ -0,0 +1,36 @@
+import { useRef, useEffect } from "react";
+
+/* 
+  Hook that assigns an onPointerUp event listener to the main document element
+  Returns a ref to attach to another element (like an icon/button that triggers a popover)
+  If a pointerup event gets captured by the document and the assigned element isn't the target
+  hook will run whatever handler is passed (eg a function that closes a popover)
+
+  See tooltip component for implementation
+
+*/
+
+const useOutsideClickHook = handler => {
+  const ref = useRef();
+
+  useEffect(() => {
+    const handleOutsideClick = e => {
+      if (ref.current && !ref.current.contains(e.target)) {
+        console.log("in outside click handler");
+        console.log("ref", ref);
+        console.log("target", e.target);
+        handler();
+      }
+
+      document.addEventListener("click", handleOutsideClick, true);
+
+      return () => {
+        document.removeEventListener("click", handleOutsideClick, true);
+      };
+    };
+  }, [ref]);
+
+  return ref;
+};
+
+export default useOutsideClickHook;