From 1f3342d666769f016da12cbdc289951e48fb7535 Mon Sep 17 00:00:00 2001
From: Rylan <rylanbot@qq.com>
Date: Tue, 25 Aug 2026 21:24:03 +0800
Subject: [PATCH] fix(TagInput): fix scrolling issue when readOnly or disabled

---
 packages/components/cascader/_usage/props.json         |  2 +-
 packages/components/checkbox/_usage/props.json         |  2 +-
 .../components/radio/_usage/radio-group-props.json     |  2 +-
 packages/components/radio/_usage/radio-props.json      |  2 +-
 packages/components/range-input/_usage/props.json      |  2 +-
 packages/components/select-input/_usage/props.json     |  2 +-
 packages/components/select/_usage/props.json           |  2 +-
 packages/components/steps/_usage/props.json            |  2 +-
 packages/components/tag-input/_usage/props.json        |  2 +-
 packages/components/tag-input/useTagScroll.ts          | 10 +++++-----
 packages/components/textarea/_usage/props.json         |  2 +-
 .../time-picker/_usage/time-picker-props.json          |  2 +-
 .../time-picker/_usage/time-range-picker-props.json    |  2 +-
 13 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/packages/components/cascader/_usage/props.json b/packages/components/cascader/_usage/props.json
index 564afdf5e3..e1a3e93560 100644
--- a/packages/components/cascader/_usage/props.json
+++ b/packages/components/cascader/_usage/props.json
@@ -54,7 +54,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/checkbox/_usage/props.json b/packages/components/checkbox/_usage/props.json
index 0bc7fb29c4..f51f5783a8 100644
--- a/packages/components/checkbox/_usage/props.json
+++ b/packages/components/checkbox/_usage/props.json
@@ -24,7 +24,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/radio/_usage/radio-group-props.json b/packages/components/radio/_usage/radio-group-props.json
index 70668057ba..9d89e8c9d3 100644
--- a/packages/components/radio/_usage/radio-group-props.json
+++ b/packages/components/radio/_usage/radio-group-props.json
@@ -27,7 +27,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/radio/_usage/radio-props.json b/packages/components/radio/_usage/radio-props.json
index 04ddfe7113..a4a6d61971 100644
--- a/packages/components/radio/_usage/radio-props.json
+++ b/packages/components/radio/_usage/radio-props.json
@@ -18,7 +18,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/range-input/_usage/props.json b/packages/components/range-input/_usage/props.json
index 4aaf12a971..bb051e5ee3 100644
--- a/packages/components/range-input/_usage/props.json
+++ b/packages/components/range-input/_usage/props.json
@@ -18,7 +18,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/select-input/_usage/props.json b/packages/components/select-input/_usage/props.json
index dd49a99bbb..79800f3aef 100644
--- a/packages/components/select-input/_usage/props.json
+++ b/packages/components/select-input/_usage/props.json
@@ -48,7 +48,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/select/_usage/props.json b/packages/components/select/_usage/props.json
index 005af9599f..d324120356 100644
--- a/packages/components/select/_usage/props.json
+++ b/packages/components/select/_usage/props.json
@@ -54,7 +54,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/steps/_usage/props.json b/packages/components/steps/_usage/props.json
index 5a77135087..4f3e3c8539 100644
--- a/packages/components/steps/_usage/props.json
+++ b/packages/components/steps/_usage/props.json
@@ -15,7 +15,7 @@
     ]
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/tag-input/_usage/props.json b/packages/components/tag-input/_usage/props.json
index 4972ed7098..d6d7df711f 100644
--- a/packages/components/tag-input/_usage/props.json
+++ b/packages/components/tag-input/_usage/props.json
@@ -45,7 +45,7 @@
     ]
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/tag-input/useTagScroll.ts b/packages/components/tag-input/useTagScroll.ts
index 96c0b5d3cf..965a21da01 100644
--- a/packages/components/tag-input/useTagScroll.ts
+++ b/packages/components/tag-input/useTagScroll.ts
@@ -16,19 +16,19 @@ import type { InputRef } from '../input';
 import type { TdTagInputProps } from './type';
 
 export default function useTagScroll(props: TdTagInputProps) {
-  const { excessTagsDisplayType, disabled } = props;
-  const readOnly = props.readOnly || props.readonly;
+  const { excessTagsDisplayType } = props;
+
   const { classPrefix: prefix } = useConfig();
 
   /** 标签输入框组件 ref */
   const tagInputRef = useRef<InputRef>(null);
   /** 滚动容器元素缓存（.input__prefix） */
-  const scrollElementRef = useRef<HTMLElement>();
+  const scrollElementRef = useRef<HTMLElement>(null);
   /** 进入防抖定时器 */
   const mouseEnterTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
-  /** 是否为可交互的 scroll 模式 */
-  const isScrollMode = excessTagsDisplayType === 'scroll' && !readOnly && !disabled;
+  /** 是否为 scroll 模式 */
+  const isScrollMode = excessTagsDisplayType === 'scroll';
 
   /** 获取滚动容器（带缓存） */
   const getScrollElement = () => {
diff --git a/packages/components/textarea/_usage/props.json b/packages/components/textarea/_usage/props.json
index 856b190a74..8b252c64f2 100644
--- a/packages/components/textarea/_usage/props.json
+++ b/packages/components/textarea/_usage/props.json
@@ -18,7 +18,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/time-picker/_usage/time-picker-props.json b/packages/components/time-picker/_usage/time-picker-props.json
index 4aaf12a971..bb051e5ee3 100644
--- a/packages/components/time-picker/_usage/time-picker-props.json
+++ b/packages/components/time-picker/_usage/time-picker-props.json
@@ -18,7 +18,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []
diff --git a/packages/components/time-picker/_usage/time-range-picker-props.json b/packages/components/time-picker/_usage/time-range-picker-props.json
index 4aaf12a971..bb051e5ee3 100644
--- a/packages/components/time-picker/_usage/time-range-picker-props.json
+++ b/packages/components/time-picker/_usage/time-range-picker-props.json
@@ -18,7 +18,7 @@
     "options": []
   },
   {
-    "name": "readonly",
+    "name": "readOnly",
     "type": "Boolean",
     "defaultValue": false,
     "options": []