Components

Img

A themed native image with forwarded image attributes.

Props

Native attributes and event handlers are forwarded to the underlying img element unless handled by the component.

PropTypeDefaultDescription
children Snippet undefined Content snippet rendered by the component.
class string '' Tailwind classes merged with the theme and variants.
element HTMLImageElement | null null Bindable reference to the underlying DOM element.
inTransition TransitionProps undefined Overrides the opening transition.
isVisible boolean true Bindable visibility state.
outTransition TransitionProps undefined Overrides the closing transition.
theme Theme global theme Optional local theme override.
transition TransitionProps [noopTransition, {}] A Svelte transition function and its options.
variants string[] [] Local variant names or theme references such as button.base.

Default usage

Import Img from sveltewind/components. This example shows its default styling in a usable context.

Illustrated sky
+page.svelte
Loading...

Examples

Theme variants

Every variant available for Img in the built-in themes is shown below.

rounded — Apply the rounded variant.

Illustrated sky
+page.svelte
Loading...

circle — Apply the circle variant.

Illustrated sky
+page.svelte
Loading...

cover — Apply the cover variant.

Illustrated sky
+page.svelte
Loading...

Class overrides

Apply rounded-xl border-2 border-primary-500/50 shadow-md locally.

Illustrated sky
+page.svelte
Loading...

Props and behavior

Change width, height, loading while retaining the default component styling.

Illustrated sky
+page.svelte
Loading...

Content and values

Provide different alt values.

A geometric illustration
+page.svelte
Loading...

Custom classes

Use class to merge Tailwind utilities with the component theme.

Illustrated sky
+page.svelte
Loading...