Tooltip 文字提示
优质
小牛编辑
121浏览
2023-12-01
常用于展示鼠标 hover 时的提示信息。
与其他组件一样,此组件未依赖任何第三方组件,这是与 element-vue
的不同之处。
基础用法
在这里我们提供 9 种不同方向的展示方式,可以通过以下完整示例来理解,选择你要的效果。
使用 ng-template
的 #tip
属性来决定 hover 时的提示信息或模板。由 placement
属性决定展示效果,提示框体展示的位置与朝向。具体请参阅组件接口文档。
<div class="box"> <div class="top"> <el-tooltip placement="top-start"> <el-button>上左</el-button> <ng-template #tip><span>placement is top-start</span></ng-template> </el-tooltip> <el-tooltip placement="top"> <el-button>上边</el-button> <ng-template #tip> <span>placement is top</span> </ng-template> </el-tooltip> <el-tooltip placement="top-end"> <el-button>上右</el-button> <ng-template #tip><span>placement is top-end</span></ng-template> </el-tooltip> </div> <div class="left"> <el-tooltip placement="left-start"> <el-button>左上</el-button> <ng-template #tip><span>placement is left-start</span></ng-template> </el-tooltip> <el-tooltip placement="left"> <el-button>左边</el-button> <ng-template #tip><span>placement is left</span></ng-template> </el-tooltip> <el-tooltip placement="left-end"> <el-button>左下</el-button> <ng-template #tip><span>placement is left-end</span></ng-template> </el-tooltip> </div> <div class="right"> <el-tooltip placement="right-start"> <el-button>右上</el-button> <ng-template #tip><span>placement is right-start</span></ng-template> </el-tooltip> <el-tooltip placement="right"> <el-button>右边</el-button> <ng-template #tip><span>placement is right</span></ng-template> </el-tooltip> <el-tooltip placement="right-end"> <el-button>右下</el-button> <ng-template #tip><span>placement is right-end</span></ng-template> </el-tooltip> </div> <div class="bottom"> <el-tooltip placement="bottom-start"> <el-button>下左</el-button> <ng-template #tip><span>placement is bottom-start</span></ng-template> </el-tooltip> <el-tooltip placement="bottom"> <el-button>下边</el-button> <ng-template #tip><span>placement is bottom</span></ng-template> </el-tooltip> <el-tooltip placement="bottom-end"> <el-button>下右</el-button> <ng-template #tip> <span>placement is bottom-end</span> </ng-template> </el-tooltip> </div> </div>
主题
Tooltip 组件提供了两个不同的主题:dark
和 light
。
通过设置 effect
属性来改变主题,默认为 dark
<el-tooltip placement="top"> <el-button>Dark</el-button> <ng-template #tip> <span>Top center</span> </ng-template> </el-tooltip> <el-tooltip placement="bottom" effect="light"> <el-button>Light</el-button> <ng-template #tip> <span>Bottom center</span> </ng-template> </el-tooltip>
禁用
设置提示禁用
设置禁用后不会影响内容本身的响应,但不再弹出提示。
<el-tooltip placement="bottom" [elDisabled]="true"> <el-button>elDisabled</el-button> <ng-template #tip> <span>Top center</span> </ng-template> </el-tooltip>
Tooltip Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
effect | 默认提供的主题 | string | dark/light | dark |
tip | 显示的内容 | ng-template | ||
push | 栅格向右移动格数 | number | 0 | |
placement | Tooltip 的出现位置 | string | top/top-start/top-end/bottom/bottom-start/bottom-end/left/left-start/left-end/right/right-start/right-end | bottom |
elDisabled | Tooltip 是否可用 | boolean | ||
visible-arrow | 是否显示 Tooltip 箭头 | boolean | 1 | |
popper-class | 为 Tooltip 的 popper 添加类名 | string |