From 0095fa048f9517228726779d71f9194dfd5289e1 Mon Sep 17 00:00:00 2001
From: chanx <1243304602@qq.com>
Date: Fri, 10 Jul 2026 09:25:05 +0800
Subject: [PATCH] fix: Show full text on hover when text overflows the cards on
 the list page. (#16787)

---
 web/src/components/home-card.tsx | 65 +++++++++++++++++++++++++++++---
 1 file changed, 59 insertions(+), 6 deletions(-)

diff --git a/web/src/components/home-card.tsx b/web/src/components/home-card.tsx
index 12bb6427e1..fa72fb9342 100644
--- a/web/src/components/home-card.tsx
+++ b/web/src/components/home-card.tsx
@@ -1,7 +1,12 @@
 import { RAGFlowAvatar } from '@/components/ragflow-avatar';
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from '@/components/ui/tooltip';
 import { formatDate } from '@/utils/date';
-import { ReactNode } from 'react';
+import { ElementType, ReactNode, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 
 interface IProps {
@@ -24,6 +29,49 @@ interface IProps {
 function Time({ time }: { time: string | number | undefined }) {
   return <p className="text-sm truncate">{formatDate(time)}</p>;
 }
+
+function TruncatedText({
+  as: Tag = 'div',
+  className,
+  children,
+  tooltip,
+  testId,
+}: {
+  as?: ElementType;
+  className?: string;
+  children?: ReactNode;
+  tooltip?: ReactNode;
+  testId?: string;
+}) {
+  const ref = useRef<HTMLElement>(null);
+  const [open, setOpen] = useState(false);
+
+  if (tooltip == null) {
+    return (
+      <Tag ref={ref} className={className} data-testid={testId}>
+        {children}
+      </Tag>
+    );
+  }
+
+  return (
+    <Tooltip
+      open={open}
+      onOpenChange={(next) => {
+        const el = ref.current;
+        setOpen(next && el !== null && el.scrollWidth > el.clientWidth);
+      }}
+    >
+      <TooltipTrigger asChild>
+        <Tag ref={ref} className={className} data-testid={testId} tabIndex={0}>
+          {children}
+        </Tag>
+      </TooltipTrigger>
+      <TooltipContent>{tooltip}</TooltipContent>
+    </Tooltip>
+  );
+}
+
 export function HomeCard({
   data,
   onClick,
@@ -62,12 +110,14 @@ export function HomeCard({
           className="p-0 flex-1 flex flex-row items-center gap-2 space-y-0"
         >
           <CardTitle className="flex-1 inline-flex w-0 me-auto">
-            <h3
+            <TruncatedText
+              as="h3"
               className="flex-1 truncate text-base font-bold leading-snug"
-              data-testid="agent-name"
+              testId="agent-name"
+              tooltip={data.name}
             >
               {data.name}
-            </h3>
+            </TruncatedText>
 
             {icon}
           </CardTitle>
@@ -80,9 +130,12 @@ export function HomeCard({
             <section className="flex justify-between"></section>
 
             <section className="flex flex-col gap-1 mt-1">
-              <div className="whitespace-nowrap overflow-hidden text-ellipsis">
+              <TruncatedText
+                className="whitespace-nowrap overflow-hidden text-ellipsis"
+                tooltip={data.description}
+              >
                 {data.description}
-              </div>
+              </TruncatedText>
               {extra}
               <div className="flex justify-between items-center min-w-0">
                 {showReleaseTime ? (