vue-ellipsis-tooltip

处理vue3中文本超长显示提示框
1,769
Install
npm install vue-ellipsis-tooltip
Latest Version:1.0.6
Vue:3
License:MIT
Last Updated:Apr 3, 2024
Links: npm
Maintainer: kafeitian

vue3-Ellipsis

基于 Vue3 的超出宽度显示省略号和tooltips提示框

Install

npm install vue-ellipsis-tooltip --save

Attention

使用该组件时,需要注意父容器有宽度或者最大最小宽度,否则无法生效!

Preview

image.png

Usage

例子

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <link rel="stylesheet" href="./style.css">
    <style>
      .wrapper{
        margin: 0 auto;
      }
    </style>
    <script src="https://cdn.bootcdn.net/ajax/libs/vue/3.3.4/vue.cjs.prod.min.js"></script>
    <script src="./vEllipsis.js"></script>
</head>
<body>
    <div id="app">
        <div class="wrapper" :style="{ width: '200px' }">
          <span  v-ellipsis="{ rows: 1, text: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaazzzzzzzzzz' }" />
        </div>
        <div class="wrapper" :style="{ width: `200px` }">
          <k-ellipsis :rows="3" text=" A design is a plan or specification for the" />
        </div>
    </div>
    <script>
        const App = {
          data() {
            return {
              message: "Hello Element Plus",
            };
          },
        };
        const app = Vue.createApp(App);
        app.use(vEllipsis);
        app.mount("#app");
      </script>
</body>
</html>
<template>
  <div class="wrapper" :style="{ width: `${width}px` }">
    <kEllipsis
      :rows="options.rows"
      :text="options.text"
      :poperOptions="{
          effect: 'light'
        }"/>
  </div>
</template>

<script setup lang="ts">
import { ref } from "vue"
import {kEllipsis} from "vue-ellipsis-tooltip"
const options = ref({
  rows: 1,
  text: "你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好"
})

const width = ref(200)
</script>
<template>
  <div class="wrapper" :style="{ width: `${width}px` }">
    <span ref="targetRef" v-ellipsis="{ rows: options.rows, text: options.text }" />
  </div>
</template>

<script setup lang="ts">
import { ref } from "vue"
const options = ref({
  rows: 1,
  text: "你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好"
})

const width = ref(200)
</script>
<template>
   <div class="wrapper" :style="{ width: `${width}px` }"  ref="wrapperRef">
    <span ref="targetRef" />
  </div>
</template>

<script setup lang="ts">
import { ref } from "vue"
const targetRef = ref()
const width = ref(200)
const options = ref({
  rows: 1,
  text: "你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好你好"
})
useEllipsis(targetRef, options.value, {
  effect: "dark"
})
</script>

Usage(在脚手架中使用)

main.ts

import { createApp } from 'vue'
import "vue-ellipsis-tooltip/dist/style.css"
import vEllipsis from "vue-ellipsis-tooltip"
import App from './App.vue'
const app = createApp(App)
app.use(vEllipsis)
app.mount('#app')

Attributes

名称 说明 类型 默认值
rows 显示省略的行数 number 1
showTooltip 配置省略时的弹出框 boolean false
text 显示的内容 string ''
disabled 是否禁用 boolean false

poperOptions(弹出窗属性)

名称 说明 类型 默认值
effect 主题 dark / light dark
teleported 是否插入body boolean false
showArrow 是否显示箭头 boolean true
popperClass 弹出窗类名 string ''
offset 出现位置的偏移量 number 12
showAfter 在触发后多久显示内容,单位毫秒 number 0
hideAfter 延迟关闭,单位毫秒 number 200
placement Tooltip 组件出现的位置 enum 'bottom'
zIndex 弹窗层级 number 1024
popperOptions popper.js 参数 object {}

Related Packages

lc-vue-text-tip

文字自动tooltip

1,190 0
makeit-tooltip

Makeit Tooltip 气泡浮层组件,基于 Vue3.0 + Vite + JSX 开发,不承载复杂的文本信息...

4,221 3
v-tooltip

Easy tooltips with Vue 2.x

6,036,683 3,460
vite-plugin-vue2

Vite plugin for Vue2

1,474,659 618
@vue-vine/vite-plugin

Official Vite plugin for Vue Vine

95,680 1,442

Version History

Version Released Vue License
1.0.6 3.3.4 MIT
1.0.5 3.3.4 MIT
1.0.4 3.3.4 MIT
1.0.3 3.3.4 MIT
1.0.2 3.3.4 MIT