useImage

分类

浏览器

导出大小

1.19 kB

上次更改

8 个月前

在浏览器中响应式加载图片，你可以等待结果显示图片或显示一个备用图片。

演示

源代码演练场 (beta)

加载中...

用法

vue

<script setup lang="ts">
import { useImage
 } from '@vueuse/core'

const avatarUrl
 = 'https://place.dog/300/200'
const { isLoading
 } = useImage
({ src
: avatarUrl
 })
</script>

<template>
  <span
 v-if="isLoading
">Loading</span
>
  <img
 v-else :src
="avatarUrl
">
</template>

组件用法

此函数还通过 @vueuse/components 包提供了一个无渲染组件版本。了解更多用法。

vue

<template>
  <UseImage src
="https://place.dog/300/200">
    <template #loading>
      Loading..
    </template>

    <template #error>
      Failed
    </template>
  </UseImage>
</template>

类型声明

显示类型声明

export interface UseImageOptions {
  /** Address of the resource */
  src
: string
  /** Images to use in different situations, e.g., high-resolution displays, small monitors, etc. */
  srcset
?: string
  /** Image sizes for different page layouts */
  sizes
?: string
  /** Image alternative information */
  alt
?: string
  /** Image classes */
  class
?: string
  /** Image loading */
  loading
?: HTMLImageElement["loading"]
  /** Image CORS settings */
  crossorigin
?: string
  /** Referrer policy for fetch https://mdn.org.cn/en-US/docs/Web/HTTP/Headers/Referrer-Policy */
  referrerPolicy
?: HTMLImageElement["referrerPolicy"]
  /** Image width */
  width
?: HTMLImageElement["width"]
  /** Image height */
  height
?: HTMLImageElement["height"]
  /** https://mdn.org.cn/en-US/docs/Web/HTML/Element/img#decoding */
  decoding
?: HTMLImageElement["decoding"]
  /** Provides a hint of the relative priority to use when fetching the image */
  fetchPriority
?: HTMLImageElement["fetchPriority"]
  /** Provides a hint of the importance of the image */
  ismap
?: HTMLImageElement["isMap"]
  /** The partial URL (starting with #) of an image map associated with the element */
  usemap
?: HTMLImageElement["useMap"]
}
/**
 * Reactive load an image in the browser, you can wait the result to display it or show a fallback.
 *
 * @see https://vueuse.org.cn/useImage
 * @param options Image attributes, as used in the <img> tag
 * @param asyncStateOptions
 */
export declare function useImage
<Shallow
 extends true>(
  options
: MaybeRefOrGetter
<UseImageOptions>,
  asyncStateOptions
?: UseAsyncStateOptions
<Shallow
>,
): UseAsyncStateReturn
<HTMLImageElement | undefined, any[], true>
export type UseImageReturn
 = ReturnType
<typeof useImage
>