Skip to content

armgit / Handy

Public Imported from GitHub
0

A free, open source, and extensible speech-to-text application that works completely offline.

feat(ui): add reusable Tooltip component and integrate with settings (#538)

Ivan Tur415d0facec90
diff --git a/src/components/ui/SettingContainer.tsx b/src/components/ui/SettingContainer.tsx
index ce24b468..1777f405 100644
--- a/src/components/ui/SettingContainer.tsx
+++ b/src/components/ui/SettingContainer.tsx
@@ -1,4 +1,5 @@
import React, { useEffect, useRef, useState } from "react";
+import { Tooltip } from "./Tooltip";
interface SettingContainerProps {
title: string;
@@ -90,12 +91,11 @@ export const SettingContainer: React.FC<SettingContainerProps> = ({
/>
</svg>
{showTooltip && (
- <div className="absolute bottom-full left-1/2 transform -translate-x-1/2 mb-2 px-3 py-2 bg-background border border-mid-gray/80 rounded-lg shadow-lg z-50 max-w-xs min-w-[200px] whitespace-normal animate-in fade-in-0 zoom-in-95 duration-200">
+ <Tooltip targetRef={tooltipRef} position="top">
<p className="text-sm text-center leading-relaxed">
{description}
</p>
- <div className="absolute top-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-l-[6px] border-r-[6px] border-t-[6px] border-l-transparent border-r-transparent border-t-mid-gray/80"></div>
- </div>
+ </Tooltip>
)}
</div>
</div>
@@ -164,16 +164,11 @@ export const SettingContainer: React.FC<SettingContainerProps> = ({
/>
</svg>
{showTooltip && (
- <div
- className={`absolute ${tooltipPosition === "top" ? "bottom-full" : "top-[150%]"} left-1/2 transform -translate-x-1/2 mb-2 px-3 py-2 bg-background border border-mid-gray/80 rounded-lg shadow-lg z-50 max-w-xs min-w-[200px] whitespace-normal animate-in fade-in-0 zoom-in-95 duration-200`}
- >
+ <Tooltip targetRef={tooltipRef} position={tooltipPosition}>
<p className="text-sm text-center leading-relaxed">
{description}
</p>
- <div
- className={`absolute ${tooltipPosition === "top" ? "top-full" : "bottom-full rotate-180"} left-1/2 transform -translate-x-1/2 w-0 h-0 border-l-[6px] border-r-[6px] border-t-[6px] border-l-transparent border-r-transparent border-t-mid-gray/80`}
- ></div>
- </div>
+ </Tooltip>
)}
</div>
</div>
diff --git a/src/components/ui/Tooltip.tsx b/src/components/ui/Tooltip.tsx
new file mode 100644
index 00000000..1c1d2087
--- /dev/null
+++ b/src/components/ui/Tooltip.tsx
@@ -0,0 +1,114 @@
+import React, { useCallback, useEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+
+type TooltipPosition = "top" | "bottom";
+
+interface TooltipCoords {
+ top: number;
+ left: number;
+ arrowLeft: number;
+ actualPosition: TooltipPosition;
+}
+
+interface TooltipProps {
+ targetRef: React.RefObject<HTMLElement>;
+ position?: TooltipPosition;
+ children: React.ReactNode;
+}
+
+const TOOLTIP_WIDTH = 200;
+const VIEWPORT_PADDING = 12;
+const GAP = 8;
+const ARROW_MARGIN = 12;
+const DEFAULT_HEIGHT = 60;
+
+export const Tooltip: React.FC<TooltipProps> = ({
+ targetRef,
+ position = "top",
+ children,
+}) => {
+ const [coords, setCoords] = useState<TooltipCoords | null>(null);
+ const tooltipRef = useRef<HTMLDivElement>(null);
+
+ const updatePosition = useCallback(() => {
+ if (!targetRef.current) return;
+
+ const targetRect = targetRef.current.getBoundingClientRect();
+ const tooltipHeight = tooltipRef.current?.offsetHeight || DEFAULT_HEIGHT;
+
+ let actualPosition = position;
+ let top: number;
+
+ if (position === "top") {
+ const spaceAbove = targetRect.top - tooltipHeight - GAP;
+ if (spaceAbove < VIEWPORT_PADDING) {
+ actualPosition = "bottom";
+ top = targetRect.bottom + GAP;
+ } else {
+ top = targetRect.top - GAP - tooltipHeight;
+ }
+ } else {
+ const spaceBelow =
+ window.innerHeight - targetRect.bottom - tooltipHeight - GAP;
+ if (spaceBelow < VIEWPORT_PADDING) {
+ actualPosition = "top";
+ top = targetRect.top - GAP - tooltipHeight;
+ } else {
+ top = targetRect.bottom + GAP;
+ }
+ }
+
+ const targetCenter = targetRect.left + targetRect.width / 2;
+ let left = targetCenter - TOOLTIP_WIDTH / 2;
+
+ if (left < VIEWPORT_PADDING) {
+ left = VIEWPORT_PADDING;
+ } else if (left + TOOLTIP_WIDTH > window.innerWidth - VIEWPORT_PADDING) {
+ left = window.innerWidth - TOOLTIP_WIDTH - VIEWPORT_PADDING;
+ }
+
+ const arrowLeft = Math.min(
+ Math.max(targetCenter - left, ARROW_MARGIN),
+ TOOLTIP_WIDTH - ARROW_MARGIN,
+ );
+
+ setCoords({ top, left, arrowLeft, actualPosition });
+ }, [targetRef, position]);
+
+ useEffect(() => {
+ updatePosition();
+
+ window.addEventListener("scroll", updatePosition, true);
+ window.addEventListener("resize", updatePosition);
+
+ return () => {
+ window.removeEventListener("scroll", updatePosition, true);
+ window.removeEventListener("resize", updatePosition);
+ };
+ }, [updatePosition]);
+
+ const arrowClasses =
+ coords?.actualPosition === "top" ? "top-full" : "bottom-full rotate-180";
+
+ return createPortal(
+ <div
+ ref={tooltipRef}
+ style={{
+ position: "fixed",
+ top: coords?.top ?? -9999,
+ left: coords?.left ?? -9999,
+ width: TOOLTIP_WIDTH,
+ zIndex: 9999,
+ opacity: coords ? 1 : 0,
+ }}
+ className="px-3 py-2 bg-background border border-mid-gray/80 rounded-lg shadow-lg whitespace-normal transition-opacity duration-150"
+ >
+ {children}
+ <div
+ style={{ left: coords?.arrowLeft ?? 0 }}
+ className={`absolute ${arrowClasses} transform -translate-x-1/2 w-0 h-0 border-l-[6px] border-r-[6px] border-t-[6px] border-l-transparent border-r-transparent border-t-mid-gray/80`}
+ />
+ </div>,
+ document.body,
+ );
+};
diff --git a/src/components/ui/index.ts b/src/components/ui/index.ts
index 71f2e280..11a10f17 100644
--- a/src/components/ui/index.ts
+++ b/src/components/ui/index.ts
@@ -5,3 +5,4 @@ export { SettingContainer } from "./SettingContainer";
export { SettingsGroup } from "./SettingsGroup";
export { TextDisplay } from "./TextDisplay";
export { Textarea } from "./Textarea";
+export { Tooltip } from "./Tooltip";