针对 HTML 内容使用 Ant Design 图片弹框
该文章使用 ChatGPT 优化内容
在图文混排的场景中,我们可以使用 Ant Design 的 Image
组件来支持图片点击弹窗,并且可以根据需要选择图片大小。在设置缩略图的宽度和高度时,我们可以选择较小的值以保证文字阅读体验。当需要查看某张图片的具体内容时,只需点击图片即可放大查看细节。但是需要注意的是,Ant Design 的 Image
组件只适用于 React 内容,当后端返回了一份图文混排的 HTML 字符串时,则需要另寻他法。在这种场景中,我们可以通过正则表达式来提取 HTML 字符串中的 <img />
标签,并为其附加特殊的 data-type
字段来标记其为 image
,即:<img data-type="image" src="..." />
。
为了在 React 组件中使用 Ant Design 的 Image
组件,可以使用 useImage()
Hook,该 Hook 会监听所有的点击事件。当点击了符合约定的对象(即 data-type="image"
)时,会使用 Ant Design 的 Message
组件弹出一个提示,提示内容即为激活的 Image
组件。当点击遮罩层时,会触发 Message
的销毁。
需要注意以下几点:
- 使用 Dialog 创建和销毁时机不太合适,
Message
更合适; - 弹窗时左上角会有一个小正方形(
Message
的动画),可以考虑通过 CSS 将其设为透明,以提升用户体验。
下面是代码示例:
// @ts-check import React from 'react'; import { Image, message } from 'antd'; export const DATA_TYPE_KEY = 'image'; /** * 支持 html 化的 img 标签弹窗 * * 需要标签包含 `data-type="${DATA_TYPE_KEY}"` * <img data-type=`${DATA_TYPE_KEY}` /> */ export function useImage() { React.useEffect(() => { const onClick = (e) => { if (e.target.tagName === 'IMG' && e.target.dataset.type === DATA_TYPE_KEY) { message.info({ key: DATA_TYPE_KEY, style: { opacity: 0, width: 0, height: 0, overflow: 'hidden' }, duration: 0, content: ( <Image src={e.target.src} preview={{ visible: true, onVisibleChange: () => message.destroy(DATA_TYPE_KEY), }} /> ), }); } }; document.addEventListener('click', onClick); return () => { document.removeEventListener('click', onClick); }; }, []); }