TUI

GridImages 九宫格展示效果

提供宫格对齐的图片布局效果

1张: 平铺宽度; 2张/3张: 平分宽度铺满宽度; 4张~9张: 9宫格效果。

可通过 previewable 设置是否开启预览的交互效果,但不提供直接预览,需要通过@preview自行实现
基础用法
根据图片数量生成九宫格的具体格数效果。
示例代码
vue
<template>
  <div style="width: 400px;">
    <TsGridImages :images="imageList" />
  </div>
</template>

<script setup lang="ts">
  const imageList = ['', '', '', '', '', '', '', 'https://www.timeszit.cn/tms/file?filename=articleCover2025-06-27-14-11-34evOCu.jpeg', 'https://www.timeszit.cn/tms/file?filename=articleCover2025-06-27-14-12-359Bugs.jpeg'];
</script>
布局用法
通过 layout 设置九宫格的布局。
示例代码
vue
<template>
  <TsGridImages :images="oneGirdImagelist" layout="nine-grid" />
  <div style="width: 100%; height: 1px; background-color: #ccc"></div>
  <TsGridImages :images="twoGirdImagelist" layout="nine-grid" />
</template>

<script setup lang="ts">
  const oneGirdImagelist = ['https://www.timeszit.cn/tms/file?filename=articleCover2025-06-27-14-11-34evOCu.jpeg'];
  const twoGirdImagelist = [ 'https://www.timeszit.cn/tms/file?filename=articleCover2025-06-27-14-11-34evOCu.jpeg', 'https://www.timeszit.cn/tms/file?filename=articleCover2025-06-27-14-12-359Bugs.jpeg'];
</script>
fallback用法
通过配置 fallback 属性或者插槽 设置图片加载失败的占位展示
加载失败
示例代码
vue
<template>
  <TsGridImages fallback="加载失败" :images="imageList" @preview="handlePreview" />
</template>

<script setup lang="ts">
  const imageList = [ 'https://www.timeszit.cn/tms/file?filename=articleCover2025-06-27-14-11-34evOCu.jpeg', 'https://www.timeszit.cn/tms/file?filename=articleCover2025-06-27-14-12-359Bugs.jpeg', ''];
</script>
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
list
接收图片预览数组
Array<string>
[]
removed 0.5.1
images
接收图片预览数组
Array<string>
[]
added 0.5.1
size
图片尺寸
String | Number | [String | Number, String | Number]
layout
图片布局方式,auto会跟进图片数量展示合适的布局,超出9张会展示为9宫格
auto | nine-grid
auto
gap
图片间距
Number
16
previewable
是否可以预览
Boolean
false
deprecated 0.5.1
deletable
是否可以删除
Boolean
false
deprecated 0.5.1
fallback
加载失败文本
string
-
加载失败
added 0.5.2
事件 Events
事件名
说明
回调参数
版本说明
preview
预览图片
index, 图片的索引
delete
删除图片
index, 图片的索引
error
图片加载失败
index, 图片的索引
插槽 Slots
插槽名
说明
版本说明
append
追加在末尾区域的内容, 默认继承网格的样式
added 0.3.3
fallback
加载失败内容
added 0.5.2