@thecb/components 11.8.0-beta.6 → 11.8.0-beta.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thecb/components",
-  "version": "11.8.0-beta.6",
+  "version": "11.8.0-beta.7",
   "description": "Common lib for CityBase react components",
   "main": "dist/index.cjs.js",
   "typings": "dist/index.d.ts",

package/src/components/molecules/tooltip/Tooltip.js

@@ -1,24 +1,34 @@
-import React, { useState } from "react";
-import { themeComponent } from "../../../util/themeUtils";
+import React, { useContext, useEffect, useRef, useState } from "react";
+import { createThemeValues } from "../../../util/themeUtils";
+import { ThemeContext } from "styled-components";
 import Text from "../../atoms/text";
 import Paragraph from "../../atoms/paragraph";
 import { Box } from "../../atoms/layouts";
 import ButtonWithAction from "../../atoms/button-with-action";
 import { noop, arrowBorder } from "../../../util/general";
-import { fallbackValues } from "./Tooltip.theme";
 import WarningIconXS from "../../atoms/icons/WarningIconXS";
+import {
+  MATISSE_BLUE,
+  PEACOCK_BLUE,
+  SAPPHIRE_BLUE
+} from "../../../constants/colors";
+
+const TOOLTIP_THEME_SOURCE = "Popover";
+
+const fallbackValues = {
+  hoverColor: SAPPHIRE_BLUE,
+  activeColor: PEACOCK_BLUE,
+  popoverTriggerColor: MATISSE_BLUE,
+  borderColor: `rgba(255, 255, 255, 0.85)`
+};
 
 const Tooltip = ({
-  tooltipContainerExtraStyles = "",
-  themeValues,
-  tooltipID = "tooltip-content",
+  tooltipID,
   hasIconTrigger = false,
   IconTrigger = WarningIconXS,
   iconHelpText = "Open the tooltip",
-  tooltipContent = "",
-  tooltipTriggerText = "",
-  triggerTextExtraStyles = "",
-  contentExtraStyles = "",
+  triggerText = "Open the tooltip",
+  tooltipContent = "The contents of the tooltip go here.",
   contentPosition = {
     top: "-110px",
     right: "auto",
@@ -35,19 +45,32 @@ const Tooltip = ({
   minWidth = "250px",
   maxWidth = "300px",
   height = "auto",
-  buttonExtraStyles,
-  backgroundColor = "white",
-  borderColor = "rgba(255, 255, 255, 0.85)"
+  containerExtraStyles = "",
+  triggerExtraStyles = "",
+  triggerButtonVariant = "smallGhost"
 }) => {
-  const { hoverColor, activeColor, tooltipTriggerColor } = themeValues;
-  const { top, right, bottom, left } = contentPosition ?? {};
-  const { arrowTop, arrowRight, arrowBottom, arrowLeft } = arrowPosition ?? {};
-
+  const closeTimeoutRef = useRef(null);
   const [tooltipOpen, setTooltipOpen] = useState(false);
+  const themeContext = useContext(ThemeContext);
+  const themeValues = createThemeValues(
+    themeContext,
+    fallbackValues,
+    TOOLTIP_THEME_SOURCE
+  );
+
+  const {
+    borderColor,
+    popoverTriggerColor,
+    hoverColor,
+    activeColor
+  } = themeValues;
 
-  const handleToggleTooltip = tooltipState => {
-    if (tooltipOpen !== tooltipState) {
-      setTooltipOpen(tooltipState);
+  const { top, right, bottom, left } = contentPosition;
+  const { arrowTop, arrowRight, arrowBottom, arrowLeft } = arrowPosition;
+
+  const handleToggleTooltip = desiredTooltipState => {
+    if (tooltipOpen !== desiredTooltipState) {
+      setTooltipOpen(desiredTooltipState);
     }
   };
 
@@ -57,64 +80,97 @@ const Tooltip = ({
     }
   };
 
+  const handleMouseEnter = () => {
+    if (closeTimeoutRef.current) {
+      clearTimeout(closeTimeoutRef.current);
+      closeTimeoutRef.current = null;
+    }
+    handleToggleTooltip(true);
+  };
+
+  const handleMouseLeave = () => {
+    closeTimeoutRef.current = setTimeout(() => {
+      handleToggleTooltip(false);
+    }, 300);
+  };
+
+  useEffect(() => {
+    return () => {
+      if (closeTimeoutRef.current) {
+        clearTimeout(closeTimeoutRef.current);
+      }
+    };
+  }, []);
+
   return (
     <Box
+      ref={closeTimeoutRef}
       padding="0"
-      extraStyles={`position: relative; ${tooltipContainerExtraStyles}`}
+      extraStyles={`position: relative; ${containerExtraStyles}`}
+      action={() => noop}
+      onMouseEnter={handleMouseEnter}
+      onMouseLeave={handleMouseLeave}
+      onKeyDown={handleKeyboardEvent}
+      data-qa="tooltip-container"
     >
       <ButtonWithAction
-        action={() => noop}
+        aria-describedby={tooltipID}
+        variant={triggerButtonVariant}
         onFocus={() => handleToggleTooltip(true)}
         onBlur={() => handleToggleTooltip(false)}
-        onKeyDown={handleKeyboardEvent}
         onTouchStart={() => handleToggleTooltip(true)}
-        onTouchEnd={() => handleToggleTooltip(false)}
-        onMouseEnter={() => handleToggleTooltip(true)}
-        onMouseLeave={() => handleToggleTooltip(false)}
+        data-qa="tooltip-trigger"
         contentOverride
-        variant="smallGhost"
-        tabIndex="0"
-        aria-describedby={tooltipID}
-        extraStyles={buttonExtraStyles}
       >
-        {hasIconTrigger && (
+        {hasIconTrigger === true && (
           <>
             <Box aria-label="Open tooltip">
-              <IconTrigger color={tooltipTriggerColor} />
+              <IconTrigger color={themeValues.links} />
             </Box>
             <Box padding="0" srOnly>
               <Text>{iconHelpText}</Text>
             </Box>
           </>
         )}
-        {!hasIconTrigger && (
+        {hasIconTrigger === false && (
           <Text
-            extraStyles={`color: ${tooltipTriggerColor}; &:hover {
-          ${hoverColor}; &:active ${activeColor}; ${triggerTextExtraStyles}`}
+            color={popoverTriggerColor}
+            extraStyles={`
+              &:visited {
+                color: ${popoverTriggerColor};
+              }
+              &:hover {
+                color: ${hoverColor}; 
+              }
+              &:active {
+                color: ${activeColor}; 
+              }
+              ${triggerExtraStyles};
+            `}
           >
-            {tooltipTriggerText}
+            {triggerText}
           </Text>
         )}
       </ButtonWithAction>
       <Box
-        background={backgroundColor}
-        borderRadius="4px"
-        boxShadow="0px 2px 14px 0px rgb(246, 246, 249), 0px 3px 8px 0px rgb(202, 206, 216)"
-        id={tooltipID}
         role="tooltip"
-        minWidth={minWidth}
-        maxWidth={maxWidth}
+        id={tooltipID}
         aria-hidden={!tooltipOpen}
+        data-qa="tooltip-contents"
         extraStyles={`
+          position: absolute;
           display: ${tooltipOpen ? "block" : "none"}; 
-          position: absolute; 
           top: ${top}; 
           right: ${right}; 
           bottom: ${bottom}; 
           left: ${left};
           height: ${height};
-          ${contentExtraStyles};
           `}
+        boxShadow={`0px 2px 14px 0px rgb(246, 246, 249), 0px 3px 8px 0px rgb(202, 206, 216)`}
+        border={`1px solid transparent`}
+        borderRadius="4px"
+        minWidth={minWidth}
+        maxWidth={maxWidth}
       >
         <Paragraph>{tooltipContent}</Paragraph>
         <Box
@@ -137,4 +193,4 @@ const Tooltip = ({
   );
 };
 
-export default themeComponent(Tooltip, "Tooltip", fallbackValues);
+export default Tooltip;