| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475 |
- const n = `<template>
- <div class="s-tab" :class="{ dragging }">
- <button
- v-if="hasOverflow"
- type="link"
- class="s-tab-arrow prev"
- :disabled="!canPrevTab"
- :title="$l('上一个')"
- @click="handPrev"
- >
- <left-outlined />
- </button>
- <div
- ref="scrollRef"
- class="s-tab-scroll"
- role="tablist"
- @scroll="syncArrow"
- @wheel.prevent="handWheel"
- @pointerdown="handDragStart"
- @dragstart.prevent
- @click.capture="swallowClick"
- >
- <div ref="trackRef" class="s-tab-track">
- <!-- 用法一:传 tabs 数组,组件自己渲染标签 -->
- <template v-if="!hasItems">
- <a
- v-for="(item, index) in list"
- :key="keyOf(item, index)"
- class="s-tab-item"
- :class="{ active: keyOf(item, index) === innerActive }"
- :data-value="keyOf(item, index)"
- role="tab"
- :aria-selected="keyOf(item, index) === innerActive"
- :tabindex="keyOf(item, index) === innerActive ? 0 : -1"
- @click="handSelect(keyOf(item, index))"
- @keydown.left.prevent="handPrev"
- @keydown.right.prevent="handNext"
- >
- {{ labelOf(item) }}
- </a>
- </template>
- <!-- 用法二:不传 tabs,用 <s-tab-item value="x">标签</s-tab-item> 自己写 -->
- <slot v-else />
- </div>
- </div>
- <button
- v-if="hasOverflow"
- type="link"
- class="s-tab-arrow next"
- :disabled="!canNextTab"
- :title="$l('下一个')"
- @click="handNext"
- >
- <right-outlined />
- </button>
- </div>
- </template>
- <script setup>
- import { computed, nextTick, onBeforeUnmount, onMounted, provide, ref, useSlots, watch } from 'vue'
- defineOptions({ name: 'STab' })
- const props = defineProps({
- // 用法一的数据源:[{ label, value }];字段名可用 tabKey 改
- tabs: {
- type: Array,
- default: () => []
- },
- // 当前选中值(v-model:activeKey)
- activeKey: {
- type: [String, Number],
- default: ''
- },
- // 默认选中值:activeKey 未传(或传空)时用它;它也没传就自动选中第一项
- defaultActiveKey: {
- type: [String, Number],
- default: ''
- },
- // 标签字段映射,默认 { label: 'label', value: 'value' }
- tabKey: {
- type: Object,
- default: () => ({ label: 'label', value: 'value' })
- },
- // 已到首个/末个标签但仍可滚动时,一次滚多少屏
- stepRatio: {
- type: Number,
- default: 0.6
- }
- })
- const emit = defineEmits(['update:activeKey', 'change'])
- // 标签与容器之间的呼吸空隙,滚动定位时留出来,避免贴边
- const GAP = 8
- const slots = useSlots()
- const scrollRef = ref(null)
- const trackRef = ref(null)
- const canPrev = ref(false)
- const canNext = ref(false)
- const hasOverflow = ref(false)
- const innerActive = ref(props.activeKey)
- // 是否处于「鼠标拖拽滑动」中(只影响光标与文字选择,不影响布局)
- const dragging = ref(false)
- const list = computed(() => props.tabs || [])
- const keyField = computed(() => (props.tabKey && props.tabKey.value) || 'value')
- const labelField = computed(() => (props.tabKey && props.tabKey.label) || 'label')
- // 是否用了 <s-tab-item> 写法(此时 tabs 数组不参与渲染)
- const hasItems = computed(() => !!slots.default)
- function keyOf(item, index) {
- const v = item && item[keyField.value]
- return v === undefined || v === null ? index : v
- }
- function labelOf(item) {
- if (!item) return ''
- const v = item[labelField.value]
- return v === undefined || v === null ? (item.label ?? item.tab ?? '') : v
- }
- // 空选中值统一判定:''/undefined/null 都视为「没传」
- const isEmptyKey = (v) => v === '' || v === undefined || v === null
- // 第一项的 key:数组模式直接取数据(保留 Number/String 原始类型),插槽模式从渲染结果读
- function firstKey() {
- if (!hasItems.value && list.value.length) return keyOf(list.value[0], 0)
- const els = itemEls()
- return els.length ? els[0].dataset.value : ''
- }
- // 解析默认值:传了 defaultActiveKey 就用它,没传取第一项
- function defaultKey() {
- return isEmptyKey(props.defaultActiveKey) ? firstKey() : props.defaultActiveKey
- }
- // 当前没有选中值时补上默认值;真的补了才返回 true(供调用方决定要不要同步给父级)
- function ensureActive() {
- if (!isEmptyKey(innerActive.value)) return false
- const key = defaultKey()
- if (isEmptyKey(key)) return false
- innerActive.value = key
- return true
- }
- // 两种用法统一从 DOM 取标签:数组模式由本组件渲染、插槽模式来自 s-tab-item,
- // 都带 .s-tab-item 与 data-value,滚动/切换只认这两个标记,逻辑不用分叉
- function itemEls() {
- const track = trackRef.value
- return track ? Array.from(track.querySelectorAll('.s-tab-item')) : []
- }
- function indexOfActive() {
- return itemEls().findIndex((el) => el.dataset.value === String(innerActive.value))
- }
- // 箭头显隐:只有内容放不下(出现横向溢出)时才显示,放得下就铺满整行
- function syncArrow() {
- const box = scrollRef.value
- if (!box) return
- hasOverflow.value = box.scrollWidth - box.clientWidth > 1
- canPrev.value = box.scrollLeft > 1
- canNext.value = box.scrollLeft + box.clientWidth < box.scrollWidth - 1
- }
- // 把某个标签滚进可视区(只动横向,不惊动外层纵向滚动)
- function scrollToEl(el) {
- const box = scrollRef.value
- if (!box || !el) return
- const boxRect = box.getBoundingClientRect()
- const elRect = el.getBoundingClientRect()
- let next = null
- if (elRect.left < boxRect.left) {
- next = box.scrollLeft + (elRect.left - boxRect.left) - GAP
- } else if (elRect.right > boxRect.right) {
- next = box.scrollLeft + (elRect.right - boxRect.right) + GAP
- }
- if (next !== null) {
- box.scrollTo({ left: Math.max(0, next), behavior: 'smooth' })
- }
- }
- function scrollToActive() {
- const i = indexOfActive()
- if (i >= 0) scrollToEl(itemEls()[i])
- }
- // 已到首个/末个标签但仍可滚动时,箭头退化为「纯滚动一屏」
- function scrollByStep(dir) {
- const box = scrollRef.value
- if (!box) return
- box.scrollBy({ left: dir * box.clientWidth * props.stepRatio, behavior: 'smooth' })
- }
- function handSelect(key) {
- if (key === innerActive.value) return
- innerActive.value = key
- emit('update:activeKey', key)
- const idx = list.value.findIndex((item, i) => keyOf(item, i) === key)
- emit('change', key, idx >= 0 ? list.value[idx] : undefined)
- nextTick(scrollToActive)
- }
- function handPrev() {
- const els = itemEls()
- const i = indexOfActive()
- if (i > 0) {
- handSelect(els[i - 1].dataset.value)
- return
- }
- scrollByStep(-1)
- }
- function handNext() {
- const els = itemEls()
- const i = indexOfActive()
- if (i >= 0 && i < els.length - 1) {
- handSelect(els[i + 1].dataset.value)
- return
- }
- scrollByStep(1)
- }
- // 鼠标滚轮纵向滚动转横向(触控板/tab 行常见交互),避免整页跟着滚
- function handWheel(e) {
- const box = scrollRef.value
- if (!box || !hasOverflow.value) return
- const delta = Math.abs(e.deltaX) > Math.abs(e.deltaY) ? e.deltaX : e.deltaY
- box.scrollLeft += delta
- }
- /**
- * 鼠标左键拖动横向滑动
- * - 只在内容溢出(出现左右箭头)时启用;触摸屏保持原生惯性滚动,不接管
- * - 位移超过阈值才算拖动,否则仍按普通点击处理(避免手抖点不中标签)
- * - 用 scrollLeft 增量补偿而非 transform:不脱离文档流、不产生额外合成层,
- * 且浏览器会把 scrollLeft 夹在 [0, max] 之间,拖到边界后反向移动不会出现死区
- */
- const DRAG_THRESHOLD = 5
- let drag = null
- // 拖动结束时浏览器还会补发一次 click,落点在标签上会误切换,需要吞掉那一次
- let suppressClick = false
- function handDragStart(e) {
- suppressClick = false
- const box = scrollRef.value
- if (!box || !hasOverflow.value) return
- if (e.pointerType === 'touch') return
- if (e.button !== 0) return
- drag = { id: e.pointerId, startX: e.clientX, lastX: e.clientX, moved: false }
- // 按下即切抓手光标(dragging 只管光标与文字选择,是否真的滚动看 drag.moved)
- dragging.value = true
- // move/up 一律挂到 window:按下后手指/鼠标跑出标签栏(含不足阈值就移出)时依然能收事件,
- // 否则「按下 → 快速划出去」会丢掉整个拖动
- window.addEventListener('pointermove', handDragMove, true)
- window.addEventListener('pointerup', handDragEnd, true)
- window.addEventListener('pointercancel', handDragEnd, true)
- }
- function handDragMove(e) {
- if (!drag || e.pointerId !== drag.id) return
- const box = scrollRef.value
- if (!box) return
- if (!drag.moved) {
- if (Math.abs(e.clientX - drag.startX) < DRAG_THRESHOLD) return
- drag.moved = true
- // 捕获指针:拖出标签栏范围后仍持续收到 move/up,不会「拖丢」
- box.setPointerCapture?.(e.pointerId)
- }
- box.scrollLeft -= e.clientX - drag.lastX
- drag.lastX = e.clientX
- }
- function handDragEnd() {
- unbindWindowEnd()
- if (!drag) return
- const box = scrollRef.value
- const { moved, id } = drag
- drag = null
- dragging.value = false
- if (box?.hasPointerCapture?.(id)) box.releasePointerCapture(id)
- if (moved) suppressClick = true
- }
- function unbindWindowEnd() {
- window.removeEventListener('pointermove', handDragMove, true)
- window.removeEventListener('pointerup', handDragEnd, true)
- window.removeEventListener('pointercancel', handDragEnd, true)
- }
- function swallowClick(e) {
- if (!suppressClick) return
- suppressClick = false
- e.preventDefault()
- e.stopPropagation()
- }
- // 箭头是否可点:既有上一个/下一个标签可切,或者还能往回/往前滚(两者取或)
- const canPrevTab = computed(() => {
- const i = indexOfActive()
- return i > 0 || canPrev.value
- })
- const canNextTab = computed(() => {
- const i = indexOfActive()
- return (i >= 0 && i < itemEls().length - 1) || canNext.value
- })
- // 供 s-tab-item 注入:读 activeValue、点击调 select、方向键调 prev/next
- provide('sTabContext', {
- activeValue: innerActive,
- select: handSelect,
- prev: handPrev,
- next: handNext
- })
- watch(
- () => props.activeKey,
- (v) => {
- if (v === innerActive.value) return
- // 外部清空选中值(没传 / 重置)→ 回落到 defaultActiveKey,再回落到第一项
- if (isEmptyKey(v)) {
- if (ensureActive()) emit('update:activeKey', innerActive.value)
- nextTick(scrollToActive)
- return
- }
- innerActive.value = v
- nextTick(scrollToActive)
- }
- )
- // 数组变化 / 插槽内容变化的兜底重算
- watch(
- () => list.value,
- () => {
- nextTick(() => {
- syncArrow()
- if (ensureActive()) emit('update:activeKey', innerActive.value)
- scrollToActive()
- })
- },
- { deep: true }
- )
- let ro = null
- onMounted(() => {
- nextTick(() => {
- syncArrow()
- // 首帧才拿得到 DOM(插槽模式尤其如此),默认值在这里补
- if (ensureActive()) emit('update:activeKey', innerActive.value)
- scrollToActive()
- })
- if (window.ResizeObserver && scrollRef.value) {
- ro = new ResizeObserver(() => syncArrow())
- ro.observe(scrollRef.value)
- if (scrollRef.value.firstElementChild) ro.observe(scrollRef.value.firstElementChild)
- }
- })
- onBeforeUnmount(() => {
- unbindWindowEnd()
- if (ro) {
- ro.disconnect()
- ro = null
- }
- })
- defineExpose({ syncArrow, scrollToActive, scrollRef })
- <\/script>
- <style lang="less" scoped>
- .s-tab {
- // 配色不写死,全部从主题变量推导(packages/index.js 按 VITE_APP_THEME 写入 :root 的 --s-*):
- // 未选中 = 主题主色 30% 混入中性灰 → 带主题倾向的灰,对比度仍 ≥ 4.5:1
- // 悬停/选中 = 主题主色 --s-color
- // 箭头到头 = 主题描边色 --s-border-color
- // 业务要微调可直接在外层覆盖这几个 --s-tab-* 变量,不用改组件
- --s-tab-color: var(--s-color, #1677ff);
- --s-tab-active-color: var(--s-color, #1677ff);
- --s-tab-disabled-color: var(--s-text-color-disabled);
- width: 100%;
- min-width: 0;
- display: flex;
- align-items: center;
- gap: 8px;
- box-sizing: border-box;
- }
- // 可横向滚动区:原生滚动条藏起来,靠左右箭头驱动
- .s-tab-scroll {
- flex: 1 1 auto;
- min-width: 0;
- overflow-x: auto;
- overflow-y: hidden;
- scrollbar-width: none;
- -ms-overflow-style: none;
- &::-webkit-scrollbar {
- display: none;
- }
- }
- .s-tab-track {
- display: inline-flex;
- align-items: center;
- gap: 40px;
- padding: 0 4px;
- white-space: nowrap;
- // 用 :deep 是因为两种用法的标签来源不同:
- // 数组模式由本组件渲染(带 scopeId),<s-tab-item> 渲染在子组件里(不带本组件的 scopeId)
- :deep(.s-tab-item) {
- flex: 0 0 auto;
- font-size: 14px;
- line-height: 40px;
- // 老浏览器不认识 color-mix,先给中性灰兜底;支持的浏览器用「主题色调和的灰」
- color: var(--s-text-color-regular);
- color: ~'color-mix(in srgb, var(--s-tab-color) 30%, var(--s-text-color-regular))';
- cursor: pointer;
- user-select: none;
- transition: color 0.2s;
- &:hover {
- color: var(--s-tab-active-color);
- }
- &.active {
- color: var(--s-tab-active-color);
- font-weight: 500;
- }
- }
- }
- .s-tab-arrow {
- flex: 0 0 32px;
- width: 32px;
- height: 32px;
- padding: 0;
- display: flex;
- align-items: center;
- justify-content: center;
- // 与标签同一套推导:主题色调和出的灰
- color: var(--s-text-color-regular);
- color: ~'color-mix(in srgb, var(--s-tab-color) 30%, var(--s-text-color-regular))';
- font-size: 12px;
- cursor: pointer;
- transition: all 0.2s;
- &:not(:disabled):hover {
- color: var(--s-tab-active-color);
- }
- &:disabled {
- color: var(--s-tab-disabled-color);
- cursor: not-allowed;
- }
- }
- // 光标:悬停不做任何提示(标签保持 pointer,空白保持默认箭头),**按下**才切抓手
- // 放在 .s-tab-track 之后:两者特异性相同,靠顺序覆盖标签的 pointer
- .s-tab.dragging {
- .s-tab-scroll,
- .s-tab-scroll .s-tab-track :deep(.s-tab-item) {
- cursor: grabbing;
- }
- .s-tab-track {
- user-select: none;
- }
- }
- </style>
- `;
- export {
- n as default
- };
|