Skip to content
On this page

image图片

Hidden Title

基础用法:<s-image src="https://example.com/image.png" width="240" height="150" />

属性事件插槽简介

Element Plus Image Documentation

基础用法(width 默认值:未设置;height 默认值:未设置)

本地源码图片(resolver 默认值:未设置)

单图预览(preview 默认值:false)

插槽

全局路径配置

如果图片位于 public/images,可以统一配置基础路径:

ts
app.use(SybzComponents, {
  image: {
    basePath: '/images',
  },
})
app.use(SybzComponents, {
  image: {
    basePath: '/images',
  },
})

之后业务中只需使用:

vue
<s-image src="tenant/test1.png" />
<s-image src="tenant/test1.png" />

如果图片位于 src/assets/images,必须先让 Vite 静态收集资源,再统一配置解析器:

ts
import SybzComponents, { createImageResolver } from 'sybz-components'

const imageModules = import.meta.glob('/src/assets/images/**/*', {
  eager: true,
  query: '?url',
  import: 'default',
})

app.use(SybzComponents, {
  image: {
    resolver: createImageResolver(imageModules, '/src/assets/images'),
  },
})
import SybzComponents, { createImageResolver } from 'sybz-components'

const imageModules = import.meta.glob('/src/assets/images/**/*', {
  eager: true,
  query: '?url',
  import: 'default',
})

app.use(SybzComponents, {
  image: {
    resolver: createImageResolver(imageModules, '/src/assets/images'),
  },
})

业务组件中同样只需写 <s-image src="tenant/test1.png" />preview-src-list 中的相对路径也会自动解析。

属性

属性名说明类型默认值
src图片地址,相对路径会通过 resolver 或 basePath 解析string''
width图片宽度,数字自动补 pxstring / number-
height图片高度,数字自动补 pxstring / number-
basePath相对图片的公共基础路径string''
resolver自定义图片路径解析函数(src) => string | void-
preview是否直接使用当前 src 开启单图预览booleanfalse
previewSrcList图片预览列表,其中的相对路径也会被解析string[][]

其他属性、事件和方法与 Element Plus Image 保持一致,包括 fitlazyloadingpreview-src-listloaderrorswitchcloseshowshowPreview()

思云博智私有前端组件库