import { ComponentType, ImgHTMLAttributes } from 'react' import { StandardProps, CommonEventFunction } from './common' interface ImageProps extends StandardProps { /** 图片资源地址 * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid */ src: string /** 图片裁剪、缩放的模式 * @default "scaleToFill" * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid * @rn 部分支持 scaleToFill, aspectFit, aspectFill, widthFix * @harmony 部分支持 scaleToFill, aspectFit, aspectFill, widthFix, heightFix */ mode?: keyof ImageProps.Mode /** 默认不解析 webP 格式,只支持网络资源 * @default false * @supported weapp, swan */ webp?: boolean /** 默认不解析 svg 格式,svg 图片只支持 aspectFit * @default false * @supported rn */ svg?: boolean /** 图片懒加载。只针对 page 与 scroll-view 下的 image 有效 * @default false * @supported weapp, alipay, swan, tt, qq, h5, harmony_hybrid */ lazyLoad?: boolean /** 开启长按图片显示识别小程序码菜单 * @default false * @supported weapp */ showMenuByLongpress?: boolean /** * 为 img 标签额外增加的属性 * @supported h5, harmony_hybrid */ imgProps?: ImgHTMLAttributes /** 用于透传 `WebComponents` 上的属性到内部 H5 标签上 * @supported h5, harmony_hybrid */ nativeProps?: Record /** 默认图片地址,若设置默认图片地址,会先显示默认图片,等 src 对应的图片加载成功后,再渲染对应的图片。 * @supported alipay */ defaultSource?: string /** 阻止长按图片时弹起默认菜单(即将该属性设置为image-menu-prevent="true"或image-menu-prevent),只在初始化时有效,不能动态变更;若不想阻止弹起默认菜单,则不需要设置此属性。注:长按菜单后的操作暂不支持 svg 格式 * @supported swan */ imageMenuPrevent?: string /** 点击后是否预览图片。在不设置的情况下,若 image 未监听点击事件且宽度大于 1/4 屏宽,则默认开启 * @supported swan */ preview?: string /** 预览时显示的图片地址 * @supported swan */ originalSrc?: string /** 无障碍访问,(属性)元素的额外描述 * @supported qq */ ariaLabel?: string /** 是否渐显 * @supported weapp * @default false */ fadeIn?: boolean /** 当错误发生时,发布到 AppService 的事件名,事件对象 * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid */ onError?: CommonEventFunction /** 当图片载入完毕时,发布到 AppService 的事件名,事件对象 * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony_hybrid */ onLoad?: CommonEventFunction /** 点击图片时触发。 * @supported alipay */ onTap?: CommonEventFunction /** 点击图片时触发,阻止事件冒泡。 * @supported alipay */ catchTap?: CommonEventFunction } declare namespace ImageProps { /** mode 的合法值 */ interface Mode { /** 缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素 */ scaleToFill /** 缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。 */ aspectFit /** 缩放模式,保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。 */ aspectFill /** 缩放模式,宽度不变,高度自动变化,保持原图宽高比不变 */ widthFix /** 缩放模式,高度不变,宽度自动变化,保持原图宽高比不变 */ heightFix /** 裁剪模式,不缩放图片,只显示图片的顶部区域 */ top /** 裁剪模式,不缩放图片,只显示图片的底部区域 */ bottom /** 裁剪模式,不缩放图片,只显示图片的中间区域 */ center /** 裁剪模式,不缩放图片,只显示图片的左边区域 */ left /** 裁剪模式,不缩放图片,只显示图片的右边区域 */ right /** 裁剪模式,不缩放图片,只显示图片的左上边区域 */ 'top left' /** 裁剪模式,不缩放图片,只显示图片的右上边区域 */ 'top right' /** 裁剪模式,不缩放图片,只显示图片的左下边区域 */ 'bottom left' /** 裁剪模式,不缩放图片,只显示图片的右下边区域 */ 'bottom right' } interface onErrorEventDetail { /** 错误信息 */ errMsg: string } interface onLoadEventDetail { /** 图片高度 */ height: number | string /** 图片宽度 */ width: number | string } } /** 图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式以及云文件ID。 * * **Note:** 为实现小程序的 `mode` 特性,在 H5 组件中使用一个 `div` 容器来对内部的 `img` 进行展示区域的裁剪,因此请勿使用元素选择器来重置 `img` 的样式! * @classification media * @supported weapp, alipay, swan, tt, qq, jd, h5, rn, harmony, harmony_hybrid * @example_react * ```tsx * export default class PageView extends Component { * constructor() { * super(...arguments) * } * * render() { * return ( * * * * * ) * } * } * ``` * @example_vue * ```html * * ``` * @see https://developers.weixin.qq.com/miniprogram/dev/component/image.html */ declare const Image: ComponentType export { Image, ImageProps }