Vue3分割线(Divider)

简介: 这是一个可定制的分割线组件,支持多种属性设置,包括标题位置、边距、宽度、样式、颜色及垂直分割等。通过简单的配置即可实现多样化的视觉效果,适用于不同场景下的布局需求。在线预览和详细代码示例可见链接。

可自定义设置以下属性:

  • 分割线标题的位置(orientation),类型:'left' | 'center' | 'right',默认 'center'

  • 标题和最近 left/right 边框之间的距离,去除了分割线,同时 orientation 必须为 left 或 right(disabled),类型:string | number,默认 ''

  • 分割线宽度(borderWidth),单位 px,类型:number,默认 1

  • 分割线样式(borderStyle),类型:'solid' | 'dashed' | 'dotted' | 'double' | 'groove' | 'ridge' | 'inset' | 'outset',默认 'solid'

  • 分割线颜色(borderColor),类型:string,默认 'rgba(5, 5, 5, 0.06)'

  • 是否垂直分割(vertical),类型:boolean,默认 false

  • 垂直分割线高度(height),仅当 vertical: true 时生效,类型:string | number,默认 '0.9em'

效果如下图:在线预览

① 创建分割线组件Divider.vue:

其中引入使用了以下工具函数:

<script setup lang="ts">
import { computed } from 'vue'
import { useSlotsExist } from '../utils'
interface Props {
  orientation?: 'left' | 'center' | 'right' // 分割线标题的位置
  orientationMargin?: string | number // 标题和最近 left/right 边框之间的距离,去除了分割线,同时 orientation 必须为 left 或 right
  borderWidth?: number // 分割线宽度,单位 px
  borderStyle?: 'solid' | 'dashed' | 'dotted' | 'double' | 'groove' | 'ridge' | 'inset' | 'outset' // 分割线样式
  borderColor?: string // 分割线颜色
  vertical?: boolean // 是否垂直分割
  height?: string | number // 垂直分割线高度,仅当 vertical: true 时生效
}
const props = withDefaults(defineProps<Props>(), {
  orientation: 'center',
  orientationMargin: undefined,
  borderWidth: 1,
  borderStyle: 'solid',
  borderColor: 'rgba(5, 5, 5, 0.06)',
  vertical: false,
  height: '0.9em'
})
const margin = computed(() => {
  if (typeof props.orientationMargin === 'number') {
    return props.orientationMargin + 'px'
  }
  return props.orientationMargin
})
const lineHeight = computed(() => {
  if (typeof props.height === 'number') {
    return props.height + 'px'
  }
  return props.height
})
const slotsExist = useSlotsExist(['default'])
const showText = computed(() => {
  return slotsExist.default
})
</script>
<template>
  <div
    class="m-divider"
    :class="[
      vertical ? 'divider-vertical' : 'divider-horizontal',
      {
        'divider-with-text': showText,
        'divider-with-text-center': showText && orientation === 'center',
        'divider-with-text-left': showText && orientation === 'left',
        'divider-with-text-right': showText && orientation === 'right',
        'divider-orientation-margin-left': showText && orientation === 'left' && orientationMargin !== undefined,
        'divider-orientation-margin-right': showText && orientation === 'right' && orientationMargin !== undefined
      }
    ]"
    :style="`--border-width: ${borderWidth}px; --border-style: ${borderStyle}; --border-color: ${borderColor}; --margin: ${margin}; --line-height: ${lineHeight};`"
  >
    <span v-if="showText" class="divider-text">
      <slot></slot>
    </span>
  </div>
</template>
<style lang="less" scoped>
.m-divider {
  color: rgba(0, 0, 0, 0.88);
  font-size: 14px;
  line-height: 1.5714285714285714;
  border-block-start: var(--border-width) var(--border-style) var(--border-color);
  .divider-text {
    display: inline-block;
    padding: 0 1em;
  }
}
.divider-horizontal {
  display: flex;
  clear: both;
  width: 100%;
  min-width: 100%;
  margin: 24px 0;
}
.divider-vertical {
  position: relative;
  top: -0.06em;
  display: inline-block;
  height: var(--line-height);
  margin: 0 8px;
  vertical-align: middle;
  border-top: 0;
  border-inline-start: var(--border-width) var(--border-style) var(--border-color);
}
.divider-with-text {
  display: flex;
  align-items: center;
  margin: 16px 0;
  color: rgba(0, 0, 0, 0.88);
  font-weight: 500;
  font-size: 16px;
  white-space: nowrap;
  text-align: center;
  border-block-start: 0 var(--border-color);
  &::before,
  &::after {
    position: relative;
    width: 50%;
    border-top-width: var(--border-width);
    border-top-style: var(--border-style);
    border-top-color: inherit;
    transform: translateY(50%);
    content: '';
  }
}
.divider-with-text-left {
  &::before {
    width: 5%;
  }
  &::after {
    width: 95%;
  }
}
.divider-with-text-right {
  &::before {
    width: 95%;
  }
  &::after {
    width: 5%;
  }
}
.divider-orientation-margin-left {
  &::before {
    width: 0;
  }
  &::after {
    width: 100%;
  }
  .divider-text {
    margin-left: var(--margin);
    padding-inline-start: 0;
  }
}
.divider-orientation-margin-right {
  &::before {
    width: 100%;
  }
  &::after {
    width: 0;
  }
  .divider-text {
    margin-right: var(--margin);
    padding-inline-end: 0;
  }
}
</style>

②在要使用的页面引入:

<script setup lang="ts">
import Divider from './Divider.vue'
</script>
<template>
  <div>
    <h1>{
  
  { $route.name }} {
  
  { $route.meta.title }}</h1>
    <h2 class="mt30 mb10">基本使用</h2>
    <Divider>Center Text</Divider>
    <Divider border-style="dashed">Center Text</Divider>
    <h2 class="mt30 mb10">中间无文字</h2>
    <Divider />
    <Divider border-style="dashed" />
    <h2 class="mt30 mb10">指定文字位置</h2>
    <Divider>Center Text</Divider>
    <Divider orientation="left">Left Text</Divider>
    <Divider orientation="right">Right Text</Divider>
    <h2 class="mt30 mb10">自定义文字边距</h2>
    <h3 class="mb10">文字居左(右)并距左(右)边 120px</h3>
    <Divider orientation="left" :orientation-margin="120">Left Text</Divider>
    <Divider orientation="right" :orientation-margin="120">Right Text</Divider>
    <h2 class="mt30 mb10">垂直分割线</h2>
    <div>
      Text
      <Divider vertical />
      <a href="#">Link</a>
      <Divider vertical />
      <a href="#">Link</a>
    </div>
    <h2 class="mt30 mb10">自定义垂直线高度</h2>
    <Divider vertical :border-width="3" :height="60" />
    <Divider vertical :border-width="3" :height="60" border-style="dashed" />
    <Divider vertical :border-width="3" :height="60" border-style="dotted" />
    <h2 class="mt30 mb10">自定义样式</h2>
    <Divider :border-width="3" border-color="orange" />
    <Divider :border-width="3" border-style="dashed" border-color="orange" />
    <Divider :border-width="3" border-style="dotted" border-color="orange" />
    <Flex style="height: 120px">
      <Divider vertical :border-width="3" border-color="orange" height="auto" />
      <Divider vertical :border-width="3" border-style="dashed" border-color="orange" :height="120" />
      <Divider vertical :border-width="3" border-style="dotted" border-color="orange" height="100%" />
    </Flex>
  </div>
</template>
相关文章
|
7月前
|
JavaScript 前端开发 安全
Vue 3
Vue 3以组合式API、Proxy响应式系统和全面TypeScript支持,重构前端开发范式。性能优化与生态协同并进,兼顾易用性与工程化,引领Web开发迈向高效、可维护的新纪元。(238字)
1015 139
|
缓存 JavaScript PHP
斩获开发者口碑!SnowAdmin:基于 Vue3 的高颜值后台管理系统,3 步极速上手!
SnowAdmin 是一款基于 Vue3/TypeScript/Arco Design 的开源后台管理框架,以“清新优雅、开箱即用”为核心设计理念。提供角色权限精细化管理、多主题与暗黑模式切换、动态路由与页面缓存等功能,支持代码规范自动化校验及丰富组件库。通过模块化设计与前沿技术栈(Vite5/Pinia),显著提升开发效率,适合团队协作与长期维护。项目地址:[GitHub](https://github.com/WANG-Fan0912/SnowAdmin)。
1329 5
|
7月前
|
缓存 JavaScript 算法
Vue 3性能优化
Vue 3 通过 Proxy 和编译优化提升性能,但仍需遵循最佳实践。合理使用 v-if、key、computed,避免深度监听,利用懒加载与虚拟列表,结合打包优化,方可充分发挥其性能优势。(239字)
539 1
|
8月前
|
开发工具 iOS开发 MacOS
基于Vite7.1+Vue3+Pinia3+ArcoDesign网页版webos后台模板
最新版研发vite7+vue3.5+pinia3+arco-design仿macos/windows风格网页版OS系统Vite-Vue3-WebOS。
943 11
|
7月前
|
JavaScript 安全
vue3使用ts传参教程
Vue 3结合TypeScript实现组件传参,提升类型安全与开发效率。涵盖Props、Emits、v-model双向绑定及useAttrs透传属性,建议明确声明类型,保障代码质量。
615 0
|
9月前
|
缓存 前端开发 大数据
虚拟列表在Vue3中的具体应用场景有哪些?
虚拟列表在 Vue3 中通过仅渲染可视区域内容,显著提升大数据列表性能,适用于 ERP 表格、聊天界面、社交媒体、阅读器、日历及树形结构等场景,结合 `vue-virtual-scroller` 等工具可实现高效滚动与交互体验。
983 1
|
9月前
|
缓存 JavaScript UED
除了循环引用,Vue3还有哪些常见的性能优化技巧?
除了循环引用,Vue3还有哪些常见的性能优化技巧?
490 0
|
10月前
|
JavaScript
vue3循环引用自已实现
当渲染大量数据列表时,使用虚拟列表只渲染可视区域的内容,显著减少 DOM 节点数量。
231 0
|
JavaScript API 容器
Vue 3 中的 nextTick 使用详解与实战案例
Vue 3 中的 nextTick 使用详解与实战案例 在 Vue 3 的日常开发中,我们经常需要在数据变化后等待 DOM 更新完成再执行某些操作。此时,nextTick 就成了一个不可或缺的工具。本文将介绍 nextTick 的基本用法,并通过三个实战案例,展示它在表单验证、弹窗动画、自动聚焦等场景中的实际应用。
1168 17
|
JavaScript 前端开发 算法
Vue 3 和 Vue 2 的区别及优点
Vue 3 和 Vue 2 的区别及优点

热门文章

最新文章