| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221 |
- const n = `<template>
- <!-- 锚点只用来在 DOM 上找滚动祖先,本身不占位、不参与交互 -->
- <span ref="anchorRef" class="s-back-top-anchor" aria-hidden="true"></span>
- <teleport to="body">
- <transition name="s-back-top-fade">
- <button
- v-show="visible"
- class="s-back-top"
- type="button"
- :title="$l('回到顶部')"
- :style="{ right: pos.right + 'px', bottom: pos.bottom + 'px' }"
- @click="toTop"
- >
- <UpOutlined />
- </button>
- </transition>
- </teleport>
- </template>
- <script setup>
- import { onBeforeUnmount, onMounted, reactive, ref } from 'vue'
- import { UpOutlined } from '@ant-design/icons-vue'
- defineOptions({ name: 'SBackTop' })
- const props = defineProps({
- /**
- * 滚动容器:CSS 选择器或 DOM 元素。
- * 不传时自动向上找最近的滚动祖先(如 SPanelLayout 的内容区),找不到则监听 window。
- */
- target: {
- type: [String, Object],
- default: null
- },
- /** 滚动超过该距离才出现;可滚动距离本身更短时按比例下调,避免按钮永不出现 */
- visibilityHeight: {
- type: Number,
- default: 200
- },
- /** 距滚动容器右边缘的距离(px);容器铺满窗口时即距窗口右边缘 */
- right: {
- type: Number,
- default: 30
- },
- /** 距滚动容器下边缘的距离(px) */
- bottom: {
- type: Number,
- default: 40
- }
- })
- const anchorRef = ref(null)
- const visible = ref(false)
- const pos = reactive({ right: props.right, bottom: props.bottom })
- // 滚动容器:元素为 window 时说明整页滚动
- let scroller = null
- let observer = null
- const isScrollable = (el) => {
- if (!el || el.nodeType !== 1) return false
- const style = window.getComputedStyle(el)
- const canScroll = /(auto|scroll|overlay)/.test(style.overflowY)
- return canScroll && el.scrollHeight > el.clientHeight + 1
- }
- /**
- * 自动找最近的滚动祖先,找不到返回 window(整页滚动)。
- * 先找「已溢出」的容器;内容还没撑开时(异步渲染)退回第一个声明了 overflow 的祖先,
- * 否则会误判成整页滚动,按钮跑到窗口角上。
- */
- const findScroller = () => {
- if (props.target) {
- if (typeof props.target === 'string') return document.querySelector(props.target) || window
- return props.target
- }
- let el = anchorRef.value ? anchorRef.value.parentElement : null
- let fallback = null
- while (el && el !== document.body && el !== document.documentElement) {
- if (isScrollable(el)) return el
- if (!fallback && /(auto|scroll|overlay)/.test(window.getComputedStyle(el).overflowY)) {
- fallback = el
- }
- el = el.parentElement
- }
- return fallback || window
- }
- const scrollTop = () => {
- if (!scroller || scroller === window) {
- return window.pageYOffset || document.documentElement.scrollTop || 0
- }
- return scroller.scrollTop
- }
- const scrollRange = () => {
- if (!scroller || scroller === window) {
- return document.documentElement.scrollHeight - window.innerHeight
- }
- return scroller.scrollHeight - scroller.clientHeight
- }
- /** 按钮贴在滚动容器右下角内侧,容器铺满窗口时退化为窗口右下角 */
- const updatePos = () => {
- const el = scroller
- if (!el || el === window) {
- pos.right = props.right
- pos.bottom = props.bottom
- return
- }
- const rect = el.getBoundingClientRect()
- pos.right = Math.max(0, window.innerWidth - rect.right) + props.right
- pos.bottom = Math.max(0, window.innerHeight - rect.bottom) + props.bottom
- }
- const onScroll = () => {
- const range = scrollRange()
- const threshold = Math.min(props.visibilityHeight, Math.max(40, range * 0.15))
- visible.value = scrollTop() > threshold
- // 容器高度可能随内容变化(如侧边折叠),滚动时顺手校正位置
- updatePos()
- }
- const bindScroller = () => {
- scroller = findScroller()
- updatePos()
- onScroll()
- if (observer) observer.disconnect()
- if (scroller && scroller !== window && typeof ResizeObserver !== 'undefined') {
- observer = new ResizeObserver(() => {
- updatePos()
- onScroll()
- })
- observer.observe(scroller)
- }
- }
- const toTop = () => {
- const top = { top: 0, behavior: 'smooth' }
- if (!scroller || scroller === window) {
- window.scrollTo(top)
- return
- }
- scroller.scrollTo(top)
- }
- onMounted(() => {
- bindScroller()
- // 捕获阶段监听:容器内滚动不冒泡,这样任意容器的滚动都能收到
- document.addEventListener('scroll', onScroll, true)
- window.addEventListener('resize', updatePos)
- })
- onBeforeUnmount(() => {
- document.removeEventListener('scroll', onScroll, true)
- window.removeEventListener('resize', updatePos)
- if (observer) observer.disconnect()
- observer = null
- scroller = null
- })
- <\/script>
- <style lang="less" scoped>
- .s-back-top-anchor {
- display: none;
- }
- .s-back-top {
- position: fixed;
- z-index: 1000;
- display: flex;
- align-items: center;
- justify-content: center;
- width: 40px;
- height: 40px;
- padding: 0;
- border: 1px solid var(--s-border-color-split, #e5e6eb);
- border-radius: 10px;
- background: var(--s-bg-color-container, #fff);
- color: var(--s-text-color-secondary, #4e5969);
- font-size: 16px;
- box-shadow: 0 4px 14px rgba(0, 0, 0, 0.14);
- cursor: pointer;
- outline: none;
- transition:
- color 0.2s,
- border-color 0.2s,
- box-shadow 0.2s;
- &:hover,
- &:focus-visible {
- color: var(--s-color, #1677ff);
- border-color: var(--s-color, #1677ff);
- box-shadow: 0 6px 18px rgba(0, 0, 0, 0.18);
- }
- }
- .s-back-top-fade-enter-active,
- .s-back-top-fade-leave-active {
- transition:
- opacity 0.2s,
- transform 0.2s;
- }
- .s-back-top-fade-enter-from,
- .s-back-top-fade-leave-to {
- opacity: 0;
- transform: translateY(8px);
- }
- @media (prefers-reduced-motion: reduce) {
- .s-back-top-fade-enter-active,
- .s-back-top-fade-leave-active {
- transition: none;
- }
- }
- </style>
- `;
- export {
- n as default
- };
|