Vue3瀑布流(Waterfall)
Vue2瀑布流Waterfall瀑布流_百度百科可自定义设置以下属性图片数组images类型Image[]默认 []要划分的列数columnCount类型number默认 3各列之间的间隙columnGap类型number单位 px默认 30瀑布流区域的总宽度width类型number | string单位 px默认 100%瀑布流区域和图片圆角borderRadius类型number单位 px默认 8瀑布流区域背景填充色backgroundColor类型string默认 #F2F4F8Spin 组件属性配置spinProps类型object默认 {}参考 Spin Props用于配置图片加载中样式效果如下图在线预览在线预览①创建瀑布流组件Waterfall.vue其中引用使用了以下组件和工具函数Vue3加载中Spin监听DOM尺寸 useResizeObserverscript setup langts import { ref, computed, onMounted, watch } from vue import Spin from components/spin import { useResizeObserver } from components/utils /* 宽度固定图片等比例缩放使用JS获取每张图片宽度和高度结合 relative 和 absolute 定位 计算每个图片的位置 topleft保证每张新的图片都追加在当前高度最小的那列末尾 */ export interface Image { name?: string // 图片名称 src: string // 图片地址 link?: string // 图片跳转链接 target?: _self | _blank // 如何打开跳转链接 } export interface Props { images?: Image[] // 图片数组 columnCount?: number // 要划分的列数 columnGap?: number // 各列之间的间隙单位 px width?: string | number // 瀑布流区域的总宽度单位 px borderRadius?: number // 瀑布流区域和图片圆角单位 px backgroundColor?: string // 瀑布流区域背景填充色 spinProps?: object // Spin 组件属性配置参考 Spin Props用于配置图片加载中样式 } const props withDefaults(definePropsProps(), { images: () [], columnCount: 3, columnGap: 20, width: 100%, borderRadius: 8, backgroundColor: #F2F4F8, spinProps: () ({}) }) const waterfallRef ref() // 瀑布流容器引用 const waterfallWidth refnumber(0) // 瀑布流区域宽度 const imagesLoaded refboolean[]([]) // 图片是否加载完成 const imagesSize ref{ width: number; height: number }[]([]) // 所有图片原始尺寸 const imagesProperty ref{ width: number; height: number; top: number; left: number }[]([]) // 瀑布流图片的宽高和位置信息 const preColumnHeight refnumber[]([]) // 每列的高度 const flag refnumber(0) // 更新瀑布流标识 // 瀑布流区域总宽度 const totalWidth computed(() { if (typeof props.width number) { return ${props.width}px } else { return props.width } }) // 瀑布流区域总高度 const totalHeight computed(() { return Math.max(...preColumnHeight.value) props.columnGap }) // 每列的图片宽度 const imageWidth computed(() { return (waterfallWidth.value - (props.columnCount 1) * props.columnGap) / props.columnCount }) // 图片总数量 const imagesAmount computed(() { return props.images.length }) watch( () props.images, (to, from) { // 只有当图片数组长度变化或图片文件变化时才清空图片尺寸数组并重新初始化 if (to.length ! to.length || to.some((image, index) image.src ! from[index]?.src)) { imagesSize.value [] initWaterfall() } }, { deep: true, flush: post } ) watch( [() props.columnCount, () props.columnGap, () props.width], () { initWaterfall() }, { flush: post } ) onMounted(() { initWaterfall() }) // 窗口宽度改变时重新计算瀑布流布局 useResizeObserver(waterfallRef, () { const currentWidth waterfallRef.value.offsetWidth if (props.images.length currentWidth ! waterfallWidth.value) { initWaterfall() } }) // 初始化瀑布流 function initWaterfall() { if (!waterfallRef.value) return waterfallWidth.value waterfallRef.value.offsetWidth preColumnHeight.value Array(props.columnCount).fill(0) imagesProperty.value.splice(0) flag.value updateWaterfall(flag.value) } // 更新瀑布流 async function updateWaterfall(symbol: number): Promiseboolean | void { for (let i 0; i imagesAmount.value; i) { if (symbol flag.value) { if (!imagesSize.value[i]) { await loadImage(props.images[i].src, i) } else { getImagesProperty(i) } } else { return false } } } // 加载图片并计算宽高和位置信息 function loadImage(url: string, n: number): void | Promisestring { const loadedImageSize imagesSize.value[n] if (loadedImageSize) { // 图片已被加载过 getImagesProperty(n) } else { // 图片未被加载过 return new Promise((resolve, reject) { const image new Image() image.src url // 图片加载完成后通过 image.naturalWidth 和 image.naturalHeight 获取图片原始宽高 image.onload function () { imagesSize.value[n] { // 保存已加载图片的尺寸信息 width: image.naturalWidth, height: image.naturalHeight } getImagesProperty(n) resolve(loaded) } image.onerror function (err) { reject(new Error(Failed to load image at ${url}, err: ${err})) } }) } } // 获取并存储实际渲染图片的宽高和位置信息 function getImagesProperty(n: number): void { const loadedImageSize imagesSize.value[n] const height loadedImageSize.height / (loadedImageSize.width / imageWidth.value) imagesProperty.value[n] { width: imageWidth.value, height: height, ...getPosition(n, height) } } // 获取图片位置信息 function getPosition(i: number, height: number): { top: number; left: number } { if (i props.columnCount) { preColumnHeight.value[i] props.columnGap height return { top: props.columnGap, left: (imageWidth.value props.columnGap) * i props.columnGap } } else { const top Math.min(...preColumnHeight.value) let index 0 for (let n 0; n props.columnCount; n) { if (preColumnHeight.value[n] top) { index n break } } preColumnHeight.value[index] top props.columnGap height return { top: top props.columnGap, left: (imageWidth.value props.columnGap) * index props.columnGap } } } function onLoaded(index: number): void { imagesLoaded.value[index] true } // 从图像地址 src 中获取图像名称 function getImageName(image: Image): string { if (image) { if (image.name) { return image.name } else { const res image.src.split(?)[0].split(/) return res[res.length - 1] } } return } /script template div refwaterfallRef classwaterfall-wrap :style --waterfall-border-radius: ${borderRadius}px; --waterfall-bg-color: ${backgroundColor}; --waterfall-width: ${totalWidth}; --waterfall-height: ${totalHeight}px; Spin classwaterfall-image :stylewidth: ${property.width}px; height: ${property.height}px; top: ${property property.top}px; left: ${property property.left}px; :spinning!imagesLoaded[index] sizesmall indicatordynamic-circle v-bindspinProps v-for(property, index) in imagesProperty :keyindex a classimage-link :class{ link-cursor: images[index].link } :hrefimages[index].link :targetimages[index].target ? images[index].target : _blank img classimage-item :srcimages[index].src :altgetImageName(images[index]) loadonLoaded(index) / /a /Spin /div /template style langless scoped .waterfall-wrap { position: relative; width: var(--waterfall-width); height: var(--waterfall-height); border-radius: var(--waterfall-border-radius); background-color: var(--waterfall-bg-color); .waterfall-image { position: absolute; .image-link { display: block; height: 100%; cursor: default; .image-item { width: 100%; height: 100%; border-radius: var(--border-radius); display: inline-block; vertical-align: bottom; } } .link-cursor { cursor: pointer; } } } /style②在要使用的页面引入其中引入使用了以下组件Vue3 栅格GridVue3弹性布局FlexVue3 滑动输入条SliderVue3颜色选择器ColorPickerscript setup langts import Waterfall from ./Waterfall.vue import { ref, onBeforeMount, reactive } from vue import type { WaterfallImage } from vue-amazing-ui const images refWaterfallImage[]([]) const state reactive({ columnCount: 3, columnGap: 20, backgroundColor: #e6f4ff, borderRadius: 12 }) function loadImages() { for (let i 1; i 10; i) { images.value.push({ name: image-${i}, src: https://cdn.jsdelivr.net/gh/themusecatcher/resources0.1.2/${i}.jpg // link: https://cdn.jsdelivr.net/gh/themusecatcher/resources0.1.2/${i}.jpg }) } } onBeforeMount(() { // 组件已完成响应式状态设置但未创建DOM节点 loadImages() }) /script template div h1{{ $route.name }} {{ $route.meta.title }}/h1 h2 classmt30 mb10基本使用/h2 Waterfall :imagesimages / h2 classmt30 mb10瀑布流配置器/h2 Row :gutter24 Col :span6 Flex vertical gapmiddle columnCount: Slider :min1 :max6 v-model:valuestate.columnCount / /Flex /Col Col :span6 Flex vertical gapmiddle columnGap: Slider :min10 :max100 v-model:valuestate.columnGap / /Flex /Col Col :span6 Flex vertical gapmiddle borderRadius: Slider :min0 :max100 v-model:valuestate.borderRadius / /Flex /Col Col :span6 Flex vertical backgroundColor: ColorPicker v-model:valuestate.backgroundColor / /Flex /Col /Row Waterfall classmt30 :imagesimages :column-countstate.columnCount :column-gapstate.columnGap :background-colorstate.backgroundColor :border-radiusstate.borderRadius / /div /template

相关新闻

开源替代前端Invidious:用API网关思想卸下视频平台复杂依赖

开源替代前端Invidious:用API网关思想卸下视频平台复杂依赖

开源社区一直有一种很有意思的工程产物,叫做“替代前端”。刚开始接触这类项目的人,往往会把它理解成“换一套皮肤”或者“去掉几个广告位”,这个理解其实偏差很大。真正优秀的替代前端项目,本质上是在做一个别人没有做的接口层&a…

2026/11/21 18:08:04 阅读更多 →
工业革命 vs 智能革命:增长曲线对比与历史类比分析

工业革命 vs 智能革命:增长曲线对比与历史类比分析

从 18 世纪的蒸汽机到今天的算力集群,“技术爆炸”这个词被反复提起,而最常被拿来对比的参照系,就是工业革命。 这次我们不讨论历史叙事,而是从技术演进的角度拆一个问题: 工业革命到底能不能作为今天智能技术爆发式…

2026/10/25 7:53:18 阅读更多 →
Don‘t credit the LLM:AI辅助开发的代码归属与合规实践指南

Don‘t credit the LLM:AI辅助开发的代码归属与合规实践指南

这次我们不聊具体模型,不聊部署脚本,先聊一个在 LLM 应用开发里越来越绕不开的问题:AI 写的代码,功劳算谁的?最近技术社区里有一个说法叫"Dont credit the LLM",翻译过来就是“不要把功劳归给大语…

2026/11/20 17:42:28 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻