Fluid Image

A simple, responsive image that will maintain its aspect ratio and grow to fit the width of its container.

UsageGuidelinesAPI

Use Fluid Image...

For images with an unknown or undefined aspect ratio.

Don't use Fluid Image...

If you know the aspect ratio of the image. Use Responsive Image instead so that the space is reserved while the page loads.

ReactVanilla

<FluidImage src="https://picsum.photos/900/450" alt="Alt text goes here" />

<FluidImage src="https://picsum.photos/900/450" alt="Alt text goes here" />

<img
  src="https://picsum.photos/900/450"
  alt="Alt text goes here"
  class="swan-fluid-image"
/>

<img
  src="https://picsum.photos/900/450"
  alt="Alt text goes here"
  class="swan-fluid-image"
/>

Alt Text

All Fluid Images need an alt attribute of some kind. Refer to Alt Text guidelines.

Multiple source images

Use the srcset prop to set the corresponding srcset attribute on the underlying <img> tag, so that you can provide both hi-res and lo-res versions of an image. The browser will only download the relevant version for the user’s screen size, resulting in better page performance. Refer to srcset at MDN.

<FluidImage
  srcset="https://picsum.photos/900/450 123w, https://picsum.photos/1800/900 456w"
  sizes="(max-width 345px) 234px, 789px"
  src="https://picsum.photos/900/450"
  alt="example image"
/>

<FluidImage
  srcset="https://picsum.photos/900/450 123w, https://picsum.photos/1800/900 456w"
  sizes="(max-width 345px) 234px, 789px"
  src="https://picsum.photos/900/450"
  alt="example image"
/>

Best practices

Do

Use descriptive, friendly file names like "blue-square-business-cards.jpg" for better Google indexing.
Compress images to minimize file size and increase performance.

Don't

Use unclear or generic file names like “biz_crd-99760.jpg”.

Props

FluidImage

This component is implemented using the <img /> as the root element. You can utilize the native attributes supported by <img /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.

See core props for additional props that can be applied to this component.

Was this page useful?