为什么捐赠
API 资源管理器
QImg

QImg 组件使处理图像(任何图片格式)变得简单,并为其添加了漂亮的加载效果以及许多其他功能(例如:设置纵横比的能力)。

正在加载 QImg API...

用法

基础

基础



纵横比

自定义纵横比



标题

标题



图片样式

在下面的示例中,我们添加了模糊和棕褐色效果。此外,我们使用了 rounded-borders CSS 辅助类。

自定义图像样式



适配模式

可以通过 fit 属性以多种方式显示图像:'cover'、'fill'(默认)、'contain'、'none'、'scale-down'。它基本上与称为 object-fit 的 CSS 属性相同。

某些模式会导致图像旁边出现空白区域(水平或垂直)。

您还可以通过 position 属性配置位置,它等效于 CSS object-position 属性。其默认值为“50% 50%”。

适配模式



加载状态

加载状态



当您拥有大尺寸图像时,您可以使用占位符图像(建议以 base64 编码指定),如下例所示。在目标图像加载之前,将显示占位符。我们正在切换 QImg 标签,以便您可以看到占位符图像的实际效果。

占位符源



错误状态



响应式

警告

要理解 sizessrcset 属性,请阅读有关原生支持的信息:响应式图像,因为 **QImg 完全依赖于此**。

响应式



提示

对于 sizes 属性,请阅读有关分辨率切换的信息:不同尺寸

提示

对于 srcset 属性,请阅读有关分辨率切换的信息:相同尺寸,不同分辨率

按需渲染

对于原生支持 loading=“lazy” DOM 属性 的浏览器,您可以利用它。Quasar 将使用它并告诉浏览器仅在当前显示图像的屏幕上(或当滚动到屏幕上时)请求图像并渲染它。

另一种选择是使用 QIntersection 组件作为包装器或 Intersection 指令。

原生延迟加载



无原生上下文菜单

在下面的示例中,我们禁用了图像上的原生上下文菜单。

警告

当您使用此选项时,始终注意将 defaulterror 插槽的内容包装在 div 元素中,或在元素上添加 all-pointer-events 类。

原生上下文菜单