feat(Search): add cursor-color prop (#794)

anlyyao · web-flow · commit 057bfa879bc6 · 2025-12-30T09:55:43.000+08:00
* feat(Search): add cursor-color prop

* docs(Search): add version info
diff --git a/db/TDesign.db b/db/TDesign.db
diff --git a/packages/products/tdesign-miniprogram/packages/components/search/README.en-US.md b/packages/products/tdesign-miniprogram/packages/components/search/README.en-US.md
@@ -17,6 +17,7 @@ clearable | Boolean | true | \- | N
 confirm-hold | Boolean | false | \- | N
 confirm-type | String | search | options: send/search/next/go/done | N
 cursor | Number | -1 | required | Y
+cursor-color | String | #0052d9 | `1.12.1` | N
 cursor-spacing | Number | 0 | \- | N
 disabled | Boolean | false | \- | N
 focus | Boolean | false | \- | N
@@ -29,7 +30,7 @@ placeholder | String | '' | \- | N
 placeholder-class | String | input-placeholder | \- | N
 placeholder-style | String | - | required | Y
 readonly | Boolean | undefined | \- | N
-result-list | Array | [] | Typescript：`Array<string>` | N
+result-list | Array | [] | Typescript: `Array<string>` | N
 right-icon | String | 'close-circle-filled' | `deprecated` | N
 selection-end | Number | -1 | \- | N
 selection-start | Number | -1 | \- | N
diff --git a/packages/products/tdesign-miniprogram/packages/components/search/README.md b/packages/products/tdesign-miniprogram/packages/components/search/README.md
@@ -17,6 +17,7 @@ clearable | Boolean | true | 是否启用清除控件 | N
 confirm-hold | Boolean | false | 点击键盘右下角按钮时是否保持键盘不收起 | N
 confirm-type | String | search | 设置键盘右下角按钮的文字，仅在type='text'时生效。<br />具体释义：<br />`send` 右下角按钮为“发送”；<br />`search` 右下角按钮为“搜索”；<br />`next` 右下角按钮为“下一个”；<br />`go` 右下角按钮为“前往”；<br />`done` 右下角按钮为“完成”。<br />[小程序官方文档](https://developers.weixin.qq.com/miniprogram/dev/component/input.html)。可选项：send/search/next/go/done | N
 cursor | Number | -1 | 必需。指定 focus 时的光标位置 | Y
+cursor-color | String | #0052d9 | `1.12.1`。光标颜色。iOS 下的格式为十六进制颜色值 #000000，安卓下的只支持 default 和 green，Skyline 下无限制 | N
 cursor-spacing | Number | 0 | 搜索框聚焦时底部与键盘的距离 | N
 disabled | Boolean | false | 是否禁用 | N
 focus | Boolean | false | 是否聚焦 | N
diff --git a/packages/products/tdesign-miniprogram/packages/components/search/props.ts b/packages/products/tdesign-miniprogram/packages/components/search/props.ts
@@ -52,6 +52,11 @@ const props: TdSearchProps = {
     value: -1,
     required: true,
   },
+  /** 光标颜色。iOS 下的格式为十六进制颜色值 #000000，安卓下的只支持 default 和 green，Skyline 下无限制 */
+  cursorColor: {
+    type: String,
+    value: '#0052d9',
+  },
   /** 搜索框聚焦时底部与键盘的距离 */
   cursorSpacing: {
     type: Number,
diff --git a/packages/products/tdesign-miniprogram/packages/components/search/type.ts b/packages/products/tdesign-miniprogram/packages/components/search/type.ts
@@ -78,6 +78,14 @@ export interface TdSearchProps {
     value?: number;
     required?: boolean;
   };
+  /**
+   * 光标颜色。iOS 下的格式为十六进制颜色值 #000000，安卓下的只支持 default 和 green，Skyline 下无限制
+   * @default #0052d9
+   */
+  cursorColor?: {
+    type: StringConstructor;
+    value?: string;
+  };
   /**
    * 搜索框聚焦时底部与键盘的距离
    * @default 0
diff --git a/packages/products/tdesign-mobile-react/src/search/defaultProps.ts b/packages/products/tdesign-mobile-react/src/search/defaultProps.ts
@@ -9,6 +9,7 @@ export const searchDefaultProps: TdSearchProps = {
   center: false,
   clearTrigger: 'always',
   clearable: true,
+  cursorColor: '#0052d9',
   disabled: false,
   focus: false,
   leftIcon: 'search',
diff --git a/packages/products/tdesign-mobile-react/src/search/search.en-US.md b/packages/products/tdesign-mobile-react/src/search/search.en-US.md
@@ -7,26 +7,27 @@
 name | type | default | description | required
 -- | -- | -- | -- | --
 className | String | - | className of component | N
-style | Object | - | CSS(Cascading Style Sheets)，Typescript：`React.CSSProperties` | N
-action | TNode | '' | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
-autocompleteOptions | Array | - | autocomplete words list。Typescript：`Array<AutocompleteOption>` `type AutocompleteOption = string \| { label: string \| TNode; group?: boolean }`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/search/type.ts) | N
+style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | N
+action | TNode | '' | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
+autocompleteOptions | Array | - | autocomplete words list。Typescript: `Array<AutocompleteOption>` `type AutocompleteOption = string \| { label: string \| TNode; group?: boolean }`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/search/type.ts) | N
 center | Boolean | false | \- | N
 clearTrigger | String | always | show clear icon, clicked to clear input value。options: always / focus | N
 clearable | Boolean | true | \- | N
+cursorColor | String | #0052d9 | `0.21.2` | N
 disabled | Boolean | false | \- | N
 focus | Boolean | false | \- | N
-leftIcon | TNode | 'search' | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
+leftIcon | TNode | 'search' | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
 placeholder | String | '' | \- | N
-prefixIcon | TElement | - | `deprecated`。Typescript：`TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
+prefixIcon | TElement | - | `deprecated`。Typescript: `TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
 readonly | Boolean | undefined | \- | N
 shape | String | 'square' | options: square/round | N
-suffixIcon | TElement | - | `deprecated`。Typescript：`TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
+suffixIcon | TElement | - | `deprecated`。Typescript: `TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
 value | String | - | \- | N
 defaultValue | String | - | uncontrolled property | N
-onActionClick | Function |  | Typescript：`({}) => void`<br/> | N
-onBlur | Function |  | Typescript：`(context: { value: string; e: FocusEvent }) => void`<br/> | N
-onChange | Function |  | Typescript：`(value: string, context: { trigger: 'input-change' \| 'option-click'; e?: InputEvent \| MouseEvent }) => void`<br/> | N
-onClear | Function |  | Typescript：`(context: { e: MouseEvent }) => void`<br/> | N
-onFocus | Function |  | Typescript：`(context: { value: string; e: FocusEvent }) => void`<br/> | N
-onSearch | Function |  | Typescript：`(context?: { value: string; trigger: 'submit' \| 'option-click' \| 'clear'; e?: InputEvent \| MouseEvent }) => void`<br/> | N
-onSubmit | Function |  | Typescript：`(context: { value: string; e: KeyboardEvent }) => void`<br/> | N
+onActionClick | Function |  | Typescript: `({}) => void`<br/> | N
+onBlur | Function |  | Typescript: `(context: { value: string; e: FocusEvent }) => void`<br/> | N
+onChange | Function |  | Typescript: `(value: string, context: { trigger: 'input-change' \| 'option-click'; e?: InputEvent \| MouseEvent }) => void`<br/> | N
+onClear | Function |  | Typescript: `(context: { e: MouseEvent }) => void`<br/> | N
+onFocus | Function |  | Typescript: `(context: { value: string; e: FocusEvent }) => void`<br/> | N
+onSearch | Function |  | Typescript: `(context?: { value: string; trigger: 'submit' \| 'option-click' \| 'clear'; e?: InputEvent \| MouseEvent }) => void`<br/> | N
+onSubmit | Function |  | Typescript: `(context: { value: string; e: KeyboardEvent }) => void`<br/> | N
diff --git a/packages/products/tdesign-mobile-react/src/search/search.md b/packages/products/tdesign-mobile-react/src/search/search.md
@@ -13,6 +13,7 @@ autocompleteOptions | Array | - | 【讨论中】联想词列表，如果不存
 center | Boolean | false | 是否居中 | N
 clearTrigger | String | always | 清空图标触发方式，仅在输入框有值时有效。可选项：always / focus | N
 clearable | Boolean | true | 是否启用清除控件 | N
+cursorColor | String | #0052d9 | `0.21.2`。光标颜色 | N
 disabled | Boolean | false | 是否禁用 | N
 focus | Boolean | false | 是否聚焦 | N
 leftIcon | TNode | 'search' | 左侧图标。TS 类型：`string \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-react/blob/develop/src/common.ts) | N
diff --git a/packages/products/tdesign-mobile-react/src/search/type.ts b/packages/products/tdesign-mobile-react/src/search/type.ts
@@ -32,6 +32,11 @@ export interface TdSearchProps {
    * @default true
    */
   clearable?: boolean;
+  /**
+   * 光标颜色
+   * @default #0052d9
+   */
+  cursorColor?: string;
   /**
    * 是否禁用
    * @default false
diff --git a/packages/products/tdesign-mobile-vue/src/search/props.ts b/packages/products/tdesign-mobile-vue/src/search/props.ts
@@ -33,6 +33,11 @@ export default {
     type: Boolean,
     default: true,
   },
+  /** 光标颜色 */
+  cursorColor: {
+    type: String,
+    default: '#0052d9',
+  },
   /** 禁用状态 */
   disabled: Boolean,
   /** 是否聚焦 */
diff --git a/packages/products/tdesign-mobile-vue/src/search/search.en-US.md b/packages/products/tdesign-mobile-vue/src/search/search.en-US.md
@@ -6,29 +6,30 @@
 
 name | type | default | description | required
 -- | -- | -- | -- | --
-action | String / Slot / Function | '' | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N
-autocompleteOptions | Array | - | autocomplete words list。Typescript：`Array<AutocompleteOption>` `type AutocompleteOption = string \| { label: string \| TNode; group?: boolean }`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/search/type.ts) | N
+action | String / Slot / Function | '' | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N
+autocompleteOptions | Array | - | autocomplete words list。Typescript: `Array<AutocompleteOption>` `type AutocompleteOption = string \| { label: string \| TNode; group?: boolean }`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts)。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/search/type.ts) | N
 center | Boolean | false | \- | N
 clearTrigger | String | always | show clear icon, clicked to clear input value。options: always / focus | N
 clearable | Boolean | true | \- | N
+cursorColor | String | #0052d9 | `1.12.2` | N
 disabled | Boolean | - | \- | N
 focus | Boolean | false | \- | N
-leftIcon | String / Slot / Function | 'search' | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N
+leftIcon | String / Slot / Function | 'search' | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N
 maxcharacter | Number | - | The maximum number of characters that the user can enter. One Chinese character represents two characters in length. Use either `maxcharacter` or `maxlength` | N
 maxlength | String / Number | - | The maximum length of text that the user can enter. One Chinese character is equal to one count length. By default, it is empty, and the input length is not limited. Use either `maxcharacter` or `maxlength` | N
 placeholder | String | '' | \- | N
 readonly | Boolean | undefined | \- | N
-resultList | Array | [] | Typescript：`Array<string>` | N
+resultList | Array | [] | Typescript: `Array<string>` | N
 shape | String | 'square' | options: square/round | N
 value | String | - | `v-model` and `v-model:value` is supported | N
 defaultValue | String | - | uncontrolled property | N
-onActionClick | Function |  | Typescript：`(context: { e: MouseEvent }) => void`<br/> | N
-onBlur | Function |  | Typescript：`(context: { value: string; e: FocusEvent }) => void`<br/> | N
-onChange | Function |  | Typescript：`(value: string, context: { e?: InputEvent \| MouseEvent }) => void`<br/> | N
-onClear | Function |  | Typescript：`(context: { e: MouseEvent }) => void`<br/> | N
-onFocus | Function |  | Typescript：`(context: { value: string; e: FocusEvent }) => void`<br/> | N
-onSearch | Function |  | Typescript：`(context?: { value: string; trigger: 'submit' \| 'option-click' \| 'clear'; e?: InputEvent \| MouseEvent }) => void`<br/> | N
-onSubmit | Function |  | Typescript：`(context: { value: string; e: KeyboardEvent }) => void`<br/> | N
+onActionClick | Function |  | Typescript: `(context: { e: MouseEvent }) => void`<br/> | N
+onBlur | Function |  | Typescript: `(context: { value: string; e: FocusEvent }) => void`<br/> | N
+onChange | Function |  | Typescript: `(value: string, context: { e?: InputEvent \| MouseEvent }) => void`<br/> | N
+onClear | Function |  | Typescript: `(context: { e: MouseEvent }) => void`<br/> | N
+onFocus | Function |  | Typescript: `(context: { value: string; e: FocusEvent }) => void`<br/> | N
+onSearch | Function |  | Typescript: `(context?: { value: string; trigger: 'submit' \| 'option-click' \| 'clear'; e?: InputEvent \| MouseEvent }) => void`<br/> | N
+onSubmit | Function |  | Typescript: `(context: { value: string; e: KeyboardEvent }) => void`<br/> | N
 
 ### Search Events
 
diff --git a/packages/products/tdesign-mobile-vue/src/search/search.md b/packages/products/tdesign-mobile-vue/src/search/search.md
@@ -11,6 +11,7 @@ autocompleteOptions | Array | - | 【讨论中】联想词列表，如果不存
 center | Boolean | false | 是否居中 | N
 clearTrigger | String | always | 清空图标触发方式，仅在输入框有值时有效。可选项：always / focus | N
 clearable | Boolean | true | 是否可清空 | N
+cursorColor | String | #0052d9 | `1.12.2`。光标颜色 | N
 disabled | Boolean | - | 禁用状态 | N
 focus | Boolean | false | 是否聚焦 | N
 leftIcon | String / Slot / Function | 'search' | 左侧图标。TS 类型：`string \| TNode`。[通用类型定义](https://github.com/Tencent/tdesign-mobile-vue/blob/develop/src/common.ts) | N
diff --git a/packages/products/tdesign-mobile-vue/src/search/type.ts b/packages/products/tdesign-mobile-vue/src/search/type.ts
@@ -31,6 +31,11 @@ export interface TdSearchProps {
    * @default true
    */
   clearable?: boolean;
+  /**
+   * 光标颜色
+   * @default #0052d9
+   */
+  cursorColor?: string;
   /**
    * 禁用状态
    */
diff --git a/packages/scripts/api.json b/packages/scripts/api.json
@@ -103472,6 +103472,82 @@
         "Number"
       ]
     },
+    {
+      "id": 1767007591,
+      "platform_framework": [
+        "64"
+      ],
+      "component": "Search",
+      "field_category": 1,
+      "field_name": "cursorColor",
+      "field_type": [
+        "1"
+      ],
+      "field_default_value": "#0052d9",
+      "field_enum": "",
+      "field_desc_zh": "光标颜色。iOS 下的格式为十六进制颜色值 #000000，安卓下的只支持 default 和 green，Skyline 下无限制",
+      "field_desc_en": null,
+      "field_required": 0,
+      "event_input": "",
+      "create_time": "2025-12-29 11:26:31",
+      "update_time": "2025-12-29 11:26:31",
+      "event_output": null,
+      "custom_field_type": null,
+      "syntactic_sugar": null,
+      "readonly": 1,
+      "html_attribute": 0,
+      "trigger_elements": "",
+      "deprecated": 0,
+      "version": "{\"Miniprogram\": \"1.12.1\"}",
+      "test_description": null,
+      "support_default_value": 0,
+      "field_category_text": "Props",
+      "platform_framework_text": [
+        "Miniprogram"
+      ],
+      "field_type_text": [
+        "String"
+      ]
+    },
+    {
+      "id": 1767007611,
+      "platform_framework": [
+        "8",
+        "16"
+      ],
+      "component": "Search",
+      "field_category": 1,
+      "field_name": "cursorColor",
+      "field_type": [
+        "1"
+      ],
+      "field_default_value": "#0052d9",
+      "field_enum": "",
+      "field_desc_zh": "光标颜色",
+      "field_desc_en": null,
+      "field_required": 0,
+      "event_input": "",
+      "create_time": "2025-12-29 11:26:51",
+      "update_time": "2025-12-29 11:26:51",
+      "event_output": null,
+      "custom_field_type": null,
+      "syntactic_sugar": null,
+      "readonly": 1,
+      "html_attribute": 0,
+      "trigger_elements": "",
+      "deprecated": 0,
+      "version": "{\"Vue(Mobile)\": \"1.12.2\", \"React(Mobile)\": \"0.21.2\"}",
+      "test_description": null,
+      "support_default_value": 0,
+      "field_category_text": "Props",
+      "platform_framework_text": [
+        "Vue(Mobile)",
+        "React(Mobile)"
+      ],
+      "field_type_text": [
+        "String"
+      ]
+    },
     {
       "id": 1712030114,
       "platform_framework": [
@@ -129263,7 +129339,7 @@
       ],
       "field_default_value": "#0052d9",
       "field_enum": "",
-      "field_desc_zh": "【试验性】光标颜色，仅在 Skyline 下有效",
+      "field_desc_zh": "【实验】光标颜色，仅在 Skyline 下有效",
       "field_desc_en": null,
       "field_required": 0,
       "event_input": "",
