Tooltip 文字提示

简单的文字提示气泡框

何时使用

鼠标移入则显示提示,移出消失,气泡浮层不承载复杂文本和操作。可用来代替系统默认的 title 提示,提供一个按钮/文字/操作的文案解释。

代码演示

基本

最简单的用法

  1. <v-tooltip content="提示文本">
  2. <span>鼠标一上来就会出现</span>
  3. </v-tooltip>

位置

位置有 12 个方向。

  1. <template>
  2. <div class="box">
  3. <div class="top">
  4. <v-tooltip placement="topLeft" controlled>
  5. <v-button>上左</v-button>
  6. <template slot="content">
  7. <p>topLeft 文字提示</p>
  8. <p>topLeft 文字提示</p>
  9. <p>topLeft 文字提示</p>
  10. </template>
  11. </v-tooltip>
  12. <v-tooltip content="top 文字提示,初始可见" placement="top" init-visible>
  13. <v-button>上边</v-button>
  14. </v-tooltip>
  15. <v-tooltip content="topRight 不可用tooltip" placement="topRight" disabled>
  16. <v-button>上右</v-button>
  17. </v-tooltip>
  18. </div>
  19. <div class="left">
  20. <v-tooltip content="leftTop 文字提示" placement="leftTop" @hide="popperHide">
  21. <v-button>左上</v-button>
  22. </v-tooltip>
  23. <v-tooltip content="left 文字提示" placement="left">
  24. <v-button>左边</v-button>
  25. </v-tooltip>
  26. <v-tooltip content="leftBottom 文字提示" placement="leftBottom">
  27. <v-button>左下</v-button>
  28. </v-tooltip>
  29. </div>
  30. <div class="right">
  31. <v-tooltip content="rightTop 文字提示" placement="rightTop">
  32. <v-button>右上</v-button>
  33. </v-tooltip>
  34. <v-tooltip content="right 文字提示" placement="right">
  35. <v-button>右边</v-button>
  36. </v-tooltip>
  37. <v-tooltip content="rightBottom 文字提示" placement="rightBottom">
  38. <v-button>右下</v-button>
  39. </v-tooltip>
  40. </div>
  41. <div class="bottom">
  42. <v-tooltip content="bottomLeft 文字提示" placement="bottomLeft">
  43. <v-button>下左</v-button>
  44. </v-tooltip>
  45. <v-tooltip content="bottom 文字提示" placement="bottom">
  46. <v-button>下边</v-button>
  47. </v-tooltip>
  48. <v-tooltip content="bottomRight 文字提示" placement="bottomRight">
  49. <v-button>下右</v-button>
  50. <div slot="content">
  51. <span style="color:#AAA">自定义提示内容</span>
  52. <div>
  53. </v-tooltip>
  54. </div>
  55. </div>
  56. </template>
  57. <script>
  58. export default {
  59. methods: {
  60. popperHide() {
  61. console.log('tooltip hide');
  62. }
  63. }
  64. }
  65. </script>
  66. <style scoped>
  67. .box {
  68. width: 500px;
  69. }
  70. .top {
  71. margin-left: 125px;
  72. }
  73. .left {
  74. float: left;
  75. width: 60px;
  76. }
  77. .right {
  78. width: 60px;
  79. margin-left: 380px;
  80. }
  81. .bottom {
  82. clear: both;
  83. margin-left: 125px;
  84. }
  85. .box-demo .ant-tooltip-wrapper {
  86. margin-right: 8px;
  87. margin-bottom: 8px;
  88. }
  89. </style>

延时

设定延时时间 展示提示信息

  1. <v-tooltip content="延时1秒展示" placement="topLeft" :delay="1000">
  2. <v-button>延时展示</v-button>
  3. </v-tooltip>

API

Tooltip Props

参数说明类型默认值
placement气泡框位置,可选 top left right bottom topLeft topRight bottomLeft bottomRight leftTop leftBottom rightTop rightBottomStringtop
content显示的内容String/Number-
content:slot显示的内容Slot Node-
init-visible初始状态是否显示tooltipBooleanfalse
delay鼠标移入后延时多少才显示tooltip,单位:毫秒Number0
disabledtooltip是否可用Booleanfalse
controlled保持tooltop显示Booleanfalse

Tooltip Events

事件说明参数
hidetooptip由显示变为隐藏时触发-