Files
element-plus/packages/components/tooltip/src/trigger.vue
2025-11-21 11:18:54 +01:00

117 lines
2.6 KiB
Vue

<template>
<el-popper-trigger
:id="id"
:virtual-ref="virtualRef"
:open="open"
:virtual-triggering="virtualTriggering"
:class="ns.e('trigger')"
@blur="onBlur"
@click="onClick"
@contextmenu="onContextMenu"
@focus="onFocus"
@mouseenter="onMouseenter"
@mouseleave="onMouseleave"
@keydown="onKeydown"
>
<slot />
</el-popper-trigger>
</template>
<script lang="ts" setup>
import { inject, nextTick, ref, toRef, unref } from 'vue'
import { ElPopperTrigger } from '@element-plus/components/popper'
import {
composeEventHandlers,
focusElement,
getEventCode,
} from '@element-plus/utils'
import { useNamespace } from '@element-plus/hooks'
import { TOOLTIP_INJECTION_KEY } from './constants'
import { useTooltipTriggerProps } from './trigger'
import { whenTrigger } from './utils'
import type { OnlyChildExpose } from '@element-plus/components/slot'
defineOptions({
name: 'ElTooltipTrigger',
})
const props = defineProps(useTooltipTriggerProps)
const ns = useNamespace('tooltip')
const { controlled, id, open, onOpen, onClose, onToggle } = inject(
TOOLTIP_INJECTION_KEY,
undefined
)!
const triggerRef = ref<OnlyChildExpose | null>(null)
const stopWhenControlledOrDisabled = () => {
if (unref(controlled) || props.disabled) {
return true
}
}
const trigger = toRef(props, 'trigger')
const onMouseenter = composeEventHandlers(
stopWhenControlledOrDisabled,
whenTrigger(trigger, 'hover', (e) => {
onOpen(e)
if (props.focusOnTarget && e.target) {
nextTick(() => {
focusElement(e.target as HTMLElement, { preventScroll: true })
})
}
})
)
const onMouseleave = composeEventHandlers(
stopWhenControlledOrDisabled,
whenTrigger(trigger, 'hover', onClose)
)
const onClick = composeEventHandlers(
stopWhenControlledOrDisabled,
whenTrigger(trigger, 'click', (e) => {
// distinguish left click
if ((e as MouseEvent).button === 0) {
onToggle(e)
}
})
)
const onFocus = composeEventHandlers(
stopWhenControlledOrDisabled,
whenTrigger(trigger, 'focus', onOpen)
)
const onBlur = composeEventHandlers(
stopWhenControlledOrDisabled,
whenTrigger(trigger, 'focus', onClose)
)
const onContextMenu = composeEventHandlers(
stopWhenControlledOrDisabled,
whenTrigger(trigger, 'contextmenu', (e: Event) => {
e.preventDefault()
onToggle(e)
})
)
const onKeydown = composeEventHandlers(
stopWhenControlledOrDisabled,
(e: Event) => {
const code = getEventCode(e as KeyboardEvent)
if (props.triggerKeys.includes(code)) {
e.preventDefault()
onToggle(e)
}
}
)
defineExpose({
/**
* @description trigger element
*/
triggerRef,
})
</script>