[犀牛鸟]feat(color-picker): add eyeDropper prop for screen color sampling

packages/components/color-picker/__tests__/__snapshots__/color-picker-panel.test.tsx.snap

@@ -74,6 +74,7 @@ exports[`ColorPickerPanel > :props > :colorModes[monochrome,linear-gradient] 1`]
         />
       </div>
     </div>
+    <!---->
   </div>
   <div
     class="t-color-picker__body"
@@ -1353,6 +1354,7 @@ exports[`ColorPickerPanel > :props > :colorModes[monochrome,linear-gradient] 3`]
         />
       </div>
     </div>
+    <!---->
   </div>
   <div
     class="t-color-picker__body"
@@ -2335,6 +2337,7 @@ exports[`ColorPickerPanel > :ui > :mount 1`] = `
         />
       </div>
     </div>
+    <!---->
   </div>
   <div
     class="t-color-picker__body"

packages/components/color-picker/_example/eye-dropper.vue

@@ -0,0 +1,8 @@
+<template>
+  <t-color-picker v-model="color" :eye-dropper="true" default-value="#0052d9" />
+</template>
+<script lang="ts" setup>
+import { ref } from 'vue';
+
+const color = ref('#0052d9');
+</script>

packages/components/color-picker/color-picker-panel-props.ts

@@ -22,6 +22,8 @@ export default {
     type: Boolean,
     default: true,
   },
+  /** 是否开启吸色功能，启用后面板顶部出现吸色按钮，仅支持 Chrome/Edge 等现代浏览器 */
+  eyeDropper: Boolean,
   /** 格式化色值。`enableAlpha` 为真时，`HEX8/RGBA/HSLA/HSVA` 有效 */
   format: {
     type: String as PropType<TdColorPickerPanelProps['format']>,

packages/components/color-picker/components/panel/header.tsx

@@ -1,6 +1,6 @@
-import { defineComponent, PropType, ref, watch } from 'vue';
-
+import { defineComponent, PropType, ref, watch, onUnmounted } from 'vue';
 import { COLOR_MODES } from '@tdesign/common-js/color-picker/constants';
+import { isEyeDropperSupported, openEyeDropper } from '../../utils/eyedropper';
 import { useConfig } from '@tdesign/shared-hooks';
 import { RadioButton as TRadioButton, RadioGroup as TRadioGroup } from '../../../radio';
 import props from '../../color-picker-panel-props';
@@ -17,35 +17,75 @@ export default defineComponent({
     },
     onModeChange: {
       type: Function,
-      default: () => {
-        return () => {};
-      },
+      default: () => () => {},
+    },
+    onEyeDropperPick: {
+      type: Function as PropType<(hex: string) => void>,
+      default: () => () => {},
     },
   },
   setup(props) {
     const { globalConfig } = useConfig('colorPicker');
     const baseClassName = useBaseClassName();
     const modeValue = ref(props.mode);
-    const handleModeChange = (v: string) => props.onModeChange(v);
+    const picking = ref(false);
+    const supported = isEyeDropperSupported();
+    let abortCtrl: AbortController | null = null;
+
     watch(
       () => props.mode,
       (v) => (modeValue.value = v),
     );
-    return () => {
-      if (props.colorModes?.length === 1) {
-        return null;
+
+    onUnmounted(() => {
+      abortCtrl?.abort();
+    });
+
+    const handleModeChange = (v: string) => props.onModeChange(v);
+
+    const handleEyeDropperClick = async () => {
+      if (picking.value || !supported) return;
+      abortCtrl = new AbortController();
+      picking.value = true;
+      try {
+        const hex = await openEyeDropper(abortCtrl.signal);
+        if (hex) props.onEyeDropperPick(hex);
+      } finally {
+        picking.value = false;
+        abortCtrl = null;
       }
+    };
+
+    return () => {
+      const showModeSwitch = (props.colorModes?.length ?? 0) !== 1;
+      const showEyeDropper = props.eyeDropper;
+      if (!showModeSwitch && !showEyeDropper) return null;
+
       return (
         <div class={`${baseClassName.value}__head`}>
-          <div class={`${baseClassName.value}__mode`}>
-            <TRadioGroup variant="default-filled" size="small" v-model={modeValue.value} onChange={handleModeChange}>
-              {Object.keys(COLOR_MODES).map((key) => (
-                <TRadioButton key={key} value={key}>
-                  {Reflect.get(globalConfig.value, COLOR_MODES[key as keyof typeof COLOR_MODES])}
-                </TRadioButton>
-              ))}
-            </TRadioGroup>
-          </div>
+          {showModeSwitch && (
+            <div class={`${baseClassName.value}__mode`}>
+              <TRadioGroup variant="default-filled" size="small" v-model={modeValue.value} onChange={handleModeChange}>
+                {Object.keys(COLOR_MODES).map((key) => (
+                  <TRadioButton key={key} value={key}>
+                    {Reflect.get(globalConfig.value, COLOR_MODES[key as keyof typeof COLOR_MODES])}
+                  </TRadioButton>
+                ))}
+              </TRadioGroup>
+            </div>
+          )}
+          {showEyeDropper && (
+            <button
+              class={[`${baseClassName.value}__eyedropper`, !supported && 't-is-disabled']}
+              title={globalConfig.value.eyeDropper ?? '吸色'}
+              disabled={!supported || picking.value}
+              onClick={handleEyeDropperClick}
+            >
+              <svg viewBox="0 0 16 16" width="1em" height="1em" fill="currentColor" aria-hidden="true">
+                <path d="M13.354.646a2.207 2.207 0 0 0-3.121 0L8.75 2.129l-.604-.604a1 1 0 1 0-1.414 1.414l.25.25L1.47 9.2A2.5 2.5 0 0 0 .75 11v.25H.5a.5.5 0 0 0 0 1h.25V12.5a.5.5 0 0 0 1 0v-.25H2a2.5 2.5 0 0 0 1.8-.72l5.982-5.982.25.25a1 1 0 1 0 1.414-1.414l-.604-.604 1.483-1.483a2.207 2.207 0 0 0 0-3.121zM3.094 11.78A1.5 1.5 0 0 1 2 12.25H1.75v-.25A1.5 1.5 0 0 1 2.22 10.906L8 5.121l.879.879-5.785 5.78z" />
+              </svg>
+            </button>
+          )}
         </div>
       );
     };

packages/components/color-picker/components/panel/index.tsx

@@ -111,6 +111,11 @@ export default defineComponent({
       },
     );
 
+    const handleEyeDropperPick = (hex: string) => {
+      color.value.update(hex);
+      emitColorChange('eyedropper');
+    };
+
     /**
      * mode change
      * @param newMode
@@ -289,7 +294,12 @@ export default defineComponent({
 
       return (
         <div class={[`${baseClassName.value}__panel`, props.disabled ? statusClassNames.disabled : false]}>
-          <PanelHeader {...props} mode={mode.value} onModeChange={handleModeChange} />
+          <PanelHeader
+            {...props}
+            mode={mode.value}
+            onModeChange={handleModeChange}
+            onEyeDropperPick={handleEyeDropperPick}
+          />
           <div class={[`${baseClassName.value}__body`]}>
             {isGradient.value ? (
               <LinearGradient

packages/components/color-picker/type.ts

@@ -39,6 +39,11 @@ export interface TdColorPickerProps {
    * @default true
    */
   enableMultipleGradient?: boolean;
+  /**
+   * 是否开启吸色功能，启用后面板顶部出现吸色按钮，仅支持 Chrome/Edge 等现代浏览器
+   * @default false
+   */
+  eyeDropper?: boolean;
   /**
    * 格式化色值。`enableAlpha` 为真时，`HEX8/RGBA/HSLA/HSVA` 有效
    * @default RGB
@@ -133,13 +138,18 @@ export interface TdColorPickerPanelProps {
    * @default true
    */
   enableMultipleGradient?: boolean;
+  /**
+   * 是否开启吸色功能，启用后面板顶部出现吸色按钮，仅支持 Chrome/Edge 等现代浏览器
+   * @default false
+   */
+  eyeDropper?: boolean;
   /**
    * 格式化色值。`enableAlpha` 为真时，`HEX8/RGBA/HSLA/HSVA` 有效
    * @default RGB
    */
   format?: 'HEX' | 'HEX8' | 'RGB' | 'RGBA' | 'HSL' | 'HSLA' | 'HSV' | 'HSVA' | 'CMYK' | 'CSS';
   /**
-   * 最近使用的颜色。值为 [] 表示以组件内部的“最近使用颜色”为准，值长度大于 0 则以该值为准显示“最近使用颜色”。值为 false 或 null 则完全不显示“最近使用颜色”
+   * 最近使用的颜色。值为 [] 表示以组件内部的”最近使用颜色”为准，值长度大于 0 则以该值为准显示”最近使用颜色”。值为 false 或 null 则完全不显示”最近使用颜色”
    * @default []
    */
   recentColors?: Array<string> | boolean | null;
@@ -198,7 +208,8 @@ export type ColorPickerChangeTrigger =
   | 'palette-alpha-bar'
   | 'input'
   | 'preset'
-  | 'recent';
+  | 'recent'
+  | 'eyedropper';
 
 export interface ColorObject {
   alpha: number;

packages/components/color-picker/utils/eyedropper.ts

@@ -0,0 +1,26 @@
+interface EyeDropperInstance {
+  open(options?: { signal?: AbortSignal }): Promise<{ sRGBHex: string }>;
+}
+
+interface EyeDropperConstructor {
+  new (): EyeDropperInstance;
+}
+
+function getEyeDropperCtor(): EyeDropperConstructor | undefined {
+  if (typeof window === 'undefined') return undefined;
+  const { EyeDropper } = window as Window & { EyeDropper?: unknown };
+  return typeof EyeDropper === 'function' ? (EyeDropper as EyeDropperConstructor) : undefined;
+}
+
+export const isEyeDropperSupported = (): boolean => getEyeDropperCtor() !== undefined;
+
+export const openEyeDropper = async (signal?: AbortSignal): Promise<string | null> => {
+  const Ctor = getEyeDropperCtor();
+  if (!Ctor) return null;
+  try {
+    const result = await new Ctor().open(signal ? { signal } : undefined);
+    return result.sRGBHex;
+  } catch {
+    return null;
+  }
+};

packages/components/config-provider/type.ts

@@ -384,6 +384,11 @@ export interface ColorPickerConfig {
    * @default ''
    */
   clearConfirmText?: string;
+  /**
+   * 语言配置，“吸色” 吸色按钮文案
+   * @default ''
+   */
+  eyeDropper?: string;
   /**
    * 语言配置，“最近使用颜色” 区域标题文本
    * @default ''