组件/Gallery 画廊

Gallery 画廊

带合集、三种布局与作品详情的作品墙

自 0.6.0BETA

当前组件文档正在开发中

该页面正在持续迁移,示例与 API 可能会继续调整。

用法

作品墙

切换合集、缩略图大小与布局,点开作品看详情。作品图由代码生成。

示例加载中...

概述

Tuff 社区的作品墙:壁纸、CoreBox 主题与插件封面在同一面墙上浏览、收藏与评分。

  • 作品图全部是由代码生成的 SVG,另有三张站内 JPG,不请求外部图片。
  • 首次进入视口时播放一次错峰入场,切合集、布局、排序或「只看收藏」时重播;减少动态效果时不播放,也取消悬停缩放。
  • 缩略图大小经 CSS 变量 --thumb-min 决定网格与瀑布流的列宽;窄于 640px 固定两列。
  • 详情里 ← / → 切换作品,只在详情内生效;评分与设为壁纸的结果显示在详情内部。
  • 上传的图片只在本页预览;每个文件的 object URL 由模板自己持有,重置或卸载时回收。

自定义

  • 换成真实作品时,每件只需 url、朝向与色板;缩略图用服务端裁好的小图,大图在详情里按需加载。
  • 想要卡片「翻开」成详情的动效,可换成 TxFlipOverlay,并用 teleport 到 body 的版本(在 content-visibility 容器里就地渲染会错位)。
  • 收藏与评分走接口时,先乐观更新计数,失败再回滚并说明原因。
  • 瀑布流基于 CSS 多列,先列后行;需要严格按时间逐行排列时用网格。

相关组件

区域组件作用
顶栏TxBadge、TxAvatarGroup、TxIconButton、TxTooltip、TxPopover、TxImageUploader总数、收藏筛选与上传
合集TxFilterChips标签页语义的合集切换
工具条TxGlassSurface、TxSegmentedSlider、TxFlatRadio、TxDropdownMenu缩略图大小、布局与排序
作品墙TxEdgeFadeMask、TxStagger、TxRating、TxAvatar、TxTag渐隐、错峰入场与卡片信息
空态TxEmptyState还没有收藏时
结果提示TxToastPanel收藏与上传的结果
作品详情TxModal、TxRating、TxButton、TxImageGallery、TxToastPanel大图、评分、色板与变体
合集栏(展开后)TxAvatarGroup、TxTag、TxImageUploader合集简介、标签与上传区