Gallery 画廊
带合集、三种布局与作品详情的作品墙
用法
作品墙
切换合集、缩略图大小与布局,点开作品看详情。作品图由代码生成。
示例加载中...
概述
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 | 合集简介、标签与上传区 |