跳到主要内容

ImagePreview 图片预览

展示图片、序号和可选删除入口。宿主提供有界图片尺寸、图片集合和关闭方式;文件持有、删除确认与真实删除由应用负责。

第2/3张
左右滑动,或按按钮定位

计数胶囊与删除控件使用主题玻璃,图片画布保持黑色、媒体保持 contain 且没有边框或圆角。返回控件由宿主组合 IconButton 的 glass 变体。

用法​

import { ImagePreview } from '@unif/react-native-design';

<ImagePreview
items={images}
width={availableWidth}
height={280}
initialId={selectedId}
onCurrentChange={(item) => setSelectedId(item.id)}
onRequestDelete={(item) => requestDelete(item)}
/>;

页码使用主题玻璃和前景文字,不支持原生玻璃或开启减少透明度时使用实色回退。胶囊跨在图片下边缘,独立于图片裁切层;图片仍按传入的 height 完整显示,媒体容器另预留半个 r(26) 的页码高度。宿主按实际可用区域为页码和删除入口留位。

API​

类型由 ImagePreviewProps、ImagePreviewItem 和 ImagePreviewHandle 导出。

参数类型默认值说明
itemsreadonly ImagePreviewItem[]必填稳定且唯一的 id,source?、label?、canDelete?、deleting?
width / heightnumber必填宿主实际可用图片区域,正有限布局尺寸
initialIdstring第一项首次非空集合中定位,后续按当前 id 保持
onCurrentChange(item: Readonly<ImagePreviewItem>) => void—有效当前身份变化时交付一次
onRequestDelete(item: Readonly<ImagePreviewItem>) => void—点击时的原项;不改集合
style / testIDStyleProp<ViewStyle> / string—外层布局与定位

canDelete、deleting 默认 false。提供删除回调且当前项允许删除时显示入口;删除中禁止重复点击。集合为空不显示图片或操作,不合成空项回调。

ref 提供 scrollTo(id: string, animated = true): void 和 getCurrent(): Readonly<ImagePreviewItem> | undefined。未知 id 不改变当前项;动画完成前仍读取上一已落位项。重入、集合身份变化和卸载后隔离旧动画回调。

同 URL 的不同 id 保持独立。当前项移除后取原位置后继,无后继取前一项。缺少来源或加载失败显示占位;只影响本次显示,不移除记录。图片采用 contain,媒体表面不加边框或圆角,序号与操作位于图片裁切区外。

组合与验证​

使用既有 GestureHandlerRootView、ThemeProvider 及轮播运行依赖。主题与应用字号影响文字,图片尺寸保持调用方给定值。实际原生展厅位于 example 的「媒体展示」。组件测试覆盖身份、集合变更、ref、旧回调与删除目标;真实手势、设备图片加载与文件生命周期由宿主另验。