Skip to content

其他指令

除了 Drag (拖拽)Resize (尺寸监听) 这两个独立的交互指令外,TechUI 还为高频使用的浮层组件提供了快捷指令版本。

使用这些指令,您可以直接将交互行为绑定到现有的 DOM 元素上,而无需改变 HTML 结构进行组件嵌套。

这些指令在对应的组件文档中均有提及,所以这些指令集合在一个文档中,不再用独立章节进行介绍。

气泡提示

用于快速唤起 Poptip (文字提示)Popinfo (信息卡片)

它是 TuiPoptipTuiPopinfo 组件的指令化封装,通过 appearance 属性进行形态切换。

基础用法

vue
<template>
  <div class="row">
    <TuiButton 
      v-tui-popover="{ 
        content: '这是一个基础提示', 
        placement: 'top',
        type: 'primary'
      }"
    >
      文字提示
    </TuiButton>

    <TuiButton 
      v-tui-popover="{ 
        appearance: 'popinfo',
        title: '详细信息', 
        content: '这是一段包含标题的卡片内容。', 
        trigger: 'click' 
      }"
    >
      卡片提示
    </TuiButton>
  </div>
</template>

详细参数配置请参阅:[Poptip 文档] 或 [Popinfo 文档]

弹出菜单

用于快速为元素绑定 Menu (菜单) 功能。

它是 TuiMenu 组件的轻量化实现,支持左键点击、悬停或右键菜单,数据源完全由 menus 数组驱动。

基础用法

vue
<script setup>
const menuData = [
  { label: '复制', value: 'copy', icon: 'ti-copy' },
  { label: '粘贴', value: 'paste', icon: 'ti-paste' }
]
</script>

<template>
  <div 
    class="context-area"
    v-tui-menu="{ 
      trigger: 'contextmenu', 
      menus: menuData,
      menuClick: (params) => console.log(params)
    }"
  >
    在此区域点击右键
  </div>
</template>

详细参数配置请参阅:[Menu 文档]

跟随提示

用于生成跟随鼠标移动的 CursorTip (光标提示)

它通过虚拟锚点技术让提示框实时吸附在鼠标旁。常用于需要实时反馈状态的区域(如地图探索、绘图板、状态指示)。

基础用法

vue
<template>
  <div 
    class="explore-zone"
    v-tui-cursor-tip="{ 
      title: '区域 A',
      content: '状态:正常运行', 
      type: 'success',
      caretOffset: 15
    }"
  >
    Hover Me
  </div>
</template>

详细参数配置请参阅:[CursorTip 文档]