也可以配置name
属性关联上下文数据
在列表中,图片组件的放大模式下默认展示所有行的图片信息,设置"enlargeWithGallary": true
效果相同。
在列表中,图片组件配置"enlargeWithGallary": false
可以关闭放大模式下图片集列表的展示。
可以配置originalSrc
,来指定原图资源地址,作为放大预览的图片地址
enlargeTitle
和enlargeCaption
可以配置放大预览中的标题和描述
href 也可以是模板
2.2.0 及以上版本
配置"showToolbar": true
使图片在放大模式下开启图片工具栏。配置"toolbarActions"
属性可以自定义工具栏的展示方式,具体配置参考ImageAction
属性名 | 类型 | 默认值 | 说明 | 版本 |
---|---|---|---|---|
type | string |
如果在 Table、Card 和 List 中,为"image" ;在 Form 中用作静态展示,为"static-image" |
||
className | string |
外层 CSS 类名 | ||
innerClassName | string |
组件内层 CSS 类名 | ||
imageClassName | string |
图片 CSS 类名 | ||
thumbClassName | string |
图片缩率图 CSS 类名 | ||
height | string |
图片缩率高度 | ||
width | string |
图片缩率宽度 | ||
title | string |
标题 | ||
imageCaption | string |
描述 | ||
placeholder | string |
占位文本 | ||
defaultImage | string |
无数据时显示的图片 | ||
src | string |
缩略图地址 | ||
href | 模板 | 外部链接地址 | ||
originalSrc | string |
原图地址 | ||
enlargeAble | boolean |
支持放大预览 | ||
enlargeTitle | string |
放大预览的标题 | ||
enlargeCaption | string |
放大预览的描述 | ||
enlargeWithGallary | string |
true |
在表格中,图片的放大功能会默认展示所有图片信息,设置为false 将关闭放大模式下图片集列表的展示 |
|
thumbMode | string |
contain |
预览图模式,可选:'w-full' , 'h-full' , 'contain' , 'cover' |
|
thumbRatio | string |
1:1 |
预览图比例,可选:'1:1' , '4:3' , '16:9' |
|
imageMode | string |
thumb |
图片展示模式,可选:'thumb' , 'original' 即:缩略图模式 或者 原图模式 |
|
showToolbar | boolean |
false |
放大模式下是否展示图片的工具栏 | 2.2.0 |
toolbarActions | ImageAction[] |
图片工具栏,支持旋转,缩放,默认操作全部开启 | 2.2.0 |
|
maxScale | number 或 模板 |
执行调整图片比例动作时的最大百分比 | 3.4.4 |
|
minScale | number 或 模板 |
执行调整图片比例动作时的最小百分比 | 3.4.4 |
interface ImageAction {
/* 操作key */
key: 'rotateRight' | 'rotateLeft' | 'zoomIn' | 'zoomOut' | 'scaleOrigin';
/* 动作名称 */
label?: string;
/* 动作icon */
icon?: string;
/* 动作自定义CSS类 */
iconClassName?: string;
/* 动作是否禁用 */
disabled?: boolean;
}
当前组件会对外派发以下事件,可以通过onEvent
来监听这些事件,并通过actions
来配置执行的动作,在actions
中可以通过${事件参数名}
或${event.data.[事件参数名]}
来获取事件产生的数据,详细查看事件动作。
事件名称 | 事件参数 | 说明 |
---|---|---|
click | 上下文数据 | 点击图片时触发 |
mouseenter | 上下文数据 | 鼠标移入时触发 |
mouseleave | 上下文数据 | 鼠标移入时触发 |
点击图片 / 鼠标移入图片 / 鼠标移出图片,可以尝试通过${event.context.nativeEvent}获取鼠标事件对象。
当前组件对外暴露以下特性动作,其他组件可以通过指定actionType: 动作名称
、componentId: 该组件id
来触发这些动作,动作配置可以通过args: {动作配置项名称: xxx}
来配置具体的参数,详细请查看事件动作。
动作名称 | 动作配置 | 说明 |
---|---|---|
preview | - | 预览图片 |
zoom | scale: number 或 scale: 模板,定义每次放大或缩小图片的百分比大小,正值为放大,负值为缩小,默认 50 |
调整图片比例,将图片等比例放大或缩小 |
预览图片,可以通过配置originalSrc
来指定预览的原图地址。