From 85833532b092d7b6840b8513845858df41d2d7e0 Mon Sep 17 00:00:00 2001
From: haoziqaq <357229046@qq.com>
Date: Wed, 4 Dec 2024 01:01:36 +0800
Subject: [PATCH] docs: improve docs

---
 packages/varlet-ui/src/menu/example/index.vue | 6 +++---
 packages/varlet-ui/src/tooltip/props.ts       | 4 ++--
 packages/varlet-ui/types/menu.d.ts            | 4 +++-
 packages/varlet-ui/types/menuSelect.d.ts      | 4 +++-
 packages/varlet-ui/types/tooltip.d.ts         | 4 +++-
 5 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/packages/varlet-ui/src/menu/example/index.vue b/packages/varlet-ui/src/menu/example/index.vue
index eb9ffe72190..258268cdb43 100644
--- a/packages/varlet-ui/src/menu/example/index.vue
+++ b/packages/varlet-ui/src/menu/example/index.vue
@@ -30,12 +30,12 @@ const placementOptions = ref([
   'cover-right',
 ])
 
+watchLang(use)
+onThemeChange()
+
 function closeMenu() {
   show.value = false
 }
-
-watchLang(use)
-onThemeChange()
 </script>
 
 <template>
diff --git a/packages/varlet-ui/src/tooltip/props.ts b/packages/varlet-ui/src/tooltip/props.ts
index 0bcccbf2d46..16e62ad260b 100644
--- a/packages/varlet-ui/src/tooltip/props.ts
+++ b/packages/varlet-ui/src/tooltip/props.ts
@@ -1,6 +1,6 @@
 import { defineListenerProp } from '../utils/components'
 import { type PropType, type TeleportProps } from 'vue'
-import type { NeededPopperPlacement, Trigger } from '../menu/usePopover'
+import type { NeededPopperPlacement, Reference, Trigger } from '../menu/usePopover'
 import type { PositioningStrategy } from '@popperjs/core'
 
 export type Placement = NeededPopperPlacement
@@ -21,7 +21,7 @@ export const props = {
     type: String as PropType<Trigger>,
     default: 'hover',
   },
-  reference: String,
+  reference: [String, Object] as PropType<Reference>,
   placement: {
     type: String as PropType<Placement>,
     default: 'bottom',
diff --git a/packages/varlet-ui/types/menu.d.ts b/packages/varlet-ui/types/menu.d.ts
index 779111afabf..c7c75ee6912 100644
--- a/packages/varlet-ui/types/menu.d.ts
+++ b/packages/varlet-ui/types/menu.d.ts
@@ -22,11 +22,13 @@ export type MenuTrigger = 'click' | 'hover' | 'manual'
 
 export type MenuStrategy = PositioningStrategy
 
+export type MenuReference = string | HTMLElement
+
 export interface MenuProps extends BasicAttributes {
   show?: boolean
   disabled?: boolean
   trigger?: MenuTrigger
-  reference?: string
+  reference?: MenuReference
   placement?: MenuPlacement
   strategy?: MenuStrategy
   offsetX?: string | number
diff --git a/packages/varlet-ui/types/menuSelect.d.ts b/packages/varlet-ui/types/menuSelect.d.ts
index b90989899eb..377c790c408 100644
--- a/packages/varlet-ui/types/menuSelect.d.ts
+++ b/packages/varlet-ui/types/menuSelect.d.ts
@@ -24,6 +24,8 @@ export type MenuSelectStrategy = PositioningStrategy
 
 export type MenuSelectSize = 'normal' | 'mini' | 'small' | 'large'
 
+export type MenuSelectReference = string | HTMLElement
+
 export type MenuSelectOptionLabelRender = (option: MenuSelectOption, checked: boolean) => VNodeChild
 
 export interface MenuSelectOption {
@@ -42,7 +44,7 @@ export interface MenuSelectProps extends BasicAttributes {
   show?: boolean
   disabled?: boolean
   trigger?: MenuSelectTrigger
-  reference?: string
+  reference?: MenuSelectReference
   placement?: MenuSelectPlacement
   strategy?: MenuSelectStrategy
   offsetX?: string | number
diff --git a/packages/varlet-ui/types/tooltip.d.ts b/packages/varlet-ui/types/tooltip.d.ts
index de2e842be66..5638fdbe17c 100644
--- a/packages/varlet-ui/types/tooltip.d.ts
+++ b/packages/varlet-ui/types/tooltip.d.ts
@@ -11,6 +11,8 @@ export type TooltipPlacement = TooltipNeededPopperPlacement
 
 export type TooltipTrigger = 'click' | 'hover' | 'manual'
 
+export type TooltipReference = string | HTMLElement
+
 export type TooltipType = 'default' | 'primary' | 'info' | 'success' | 'warning' | 'danger'
 
 export type TooltipStrategy = PositioningStrategy
@@ -23,7 +25,7 @@ export interface TooltipProps extends BasicAttributes {
   textColor?: string
   type?: TooltipType
   trigger?: TooltipTrigger
-  reference?: string
+  reference?: TooltipReference
   placement?: TooltipPlacement
   strategy?: TooltipStrategy
   offsetX?: string | number