Skip to content
ui8kit

primitive / kit

Kit Image

UI8Kit 3 Image primitive (unstyled), from @ui8kit/registry

Install

npx ui8kit add kit-image

Pulls in: utils

Preview

No static preview for this item: it needs content or a parent that this page cannot supply. The code is below.

Code

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework svelte --dir src --registry-url https://registry.buildy.tw/svelte --strict-cdn
npx ui8kit add kit-image
kit/ui/image/Image.svelte
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Image renders an img element; alt is always emitted.
-->
<script lang="ts" module>

  export type ImageProps = {
    alt: string;
    class?: string;
    [key: string]: unknown;
  };
</script>

<script lang="ts">
  import { imageClasses } from "./image.shared";
  import { safeRest } from "../../utils/expr";

  let {
    alt,
    class: className,
    ...rawRest
  }: ImageProps = $props();

  const rest = $derived(safeRest(rawRest, { img: true, blank: ["src", "srcset", "sizes", "width", "height", "loading", "decoding"] }));
  const cls = $derived(imageClasses({ className }));
</script>

<img alt={(alt) ?? ""} {...(cls ? { class: cls } : {})} {...rest} />
kit/ui/image/Picture.svelte
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Picture wraps Source candidates and a fallback Image.
-->
<script lang="ts" module>
  import type { Snippet } from "svelte";

  export type PictureProps = {
    class?: string;
    children?: Snippet;
    [key: string]: unknown;
  };
</script>

<script lang="ts">
  import { pictureClasses } from "./image.shared";
  import { safeRest } from "../../utils/expr";

  let {
    class: className,
    children,
    ...rawRest
  }: PictureProps = $props();

  const rest = $derived(safeRest(rawRest));
  const cls = $derived(pictureClasses({ className }));
</script>

<picture {...(cls ? { class: cls } : {})} {...rest}>
  {@render children?.()}
</picture>
kit/ui/image/Source.svelte
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Source renders a source candidate inside picture.
-->
<script lang="ts" module>

  export type SourceProps = {
    class?: string;
    [key: string]: unknown;
  };
</script>

<script lang="ts">
  import { safeRest } from "../../utils/expr";

  let {
    class: className,
    ...rawRest
  }: SourceProps = $props();

  const rest = $derived(safeRest(rawRest, { blank: ["srcset", "media", "type", "sizes"] }));
</script>

<source {...rest} />
kit/ui/image/image.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.image — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Image renders an img element; alt is always emitted. */
export type ImageBaseProps = {
  alt: string;
};

export type ImageClassesInput = {
  className?: string;
};

/** Compose Image classes without rendering — the cross-runtime `asChild` substitute. */
export function imageClasses(input: ImageClassesInput = {}): string {
  return cn(input.className);
}

/** Picture wraps Source candidates and a fallback Image. */
export type PictureBaseProps = {

};

export type PictureClassesInput = {
  className?: string;
};

/** Compose Picture classes without rendering — the cross-runtime `asChild` substitute. */
export function pictureClasses(input: PictureClassesInput = {}): string {
  return cn(input.className);
}

/** Source renders a source candidate inside picture. */
export type SourceBaseProps = {

};

Svelte registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework react --dir src --registry-url https://registry.buildy.tw/react --strict-cdn
npx ui8kit add kit-image
kit/ui/image/image.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.image — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Image renders an img element; alt is always emitted. */
export type ImageBaseProps = {
  alt: string;
};

export type ImageClassesInput = {
  className?: string;
};

/** Compose Image classes without rendering — the cross-runtime `asChild` substitute. */
export function imageClasses(input: ImageClassesInput = {}): string {
  return cn(input.className);
}

/** Picture wraps Source candidates and a fallback Image. */
export type PictureBaseProps = {

};

export type PictureClassesInput = {
  className?: string;
};

/** Compose Picture classes without rendering — the cross-runtime `asChild` substitute. */
export function pictureClasses(input: PictureClassesInput = {}): string {
  return cn(input.className);
}

/** Source renders a source candidate inside picture. */
export type SourceBaseProps = {

};
kit/ui/image/image.tsx
// Code generated by @ui8kit/codegen. DO NOT EDIT.
/**
 * Image renders img, picture, and source. Alt is required; pass an empty
 * string for decorative images.
 */

import { forwardRef, type ReactNode, type HTMLAttributes, type ImgHTMLAttributes, type SourceHTMLAttributes } from "react";
import { imageClasses, pictureClasses } from "./image.shared";
import { safeRest } from "../../utils/expr";

/**
 * Image renders an img element; alt is always emitted.
 */
export type ImageProps = Omit<ImgHTMLAttributes<HTMLImageElement>, "className" | "children" | "alt"> & {
  alt: string;
  className?: string;
};

export const Image = forwardRef<HTMLImageElement, ImageProps>(function Image(
  { alt, className, ...rawRest },
  ref
) {
  const rest = safeRest(rawRest, { img: true, blank: ["src", "srcset", "sizes", "width", "height", "loading", "decoding"] });
  const cls = imageClasses({ className });
  return (
    <img ref={ref} alt={(alt) ?? ""} className={cls || undefined} {...rest} />
  );
});
Image.displayName = "Image";

/**
 * Picture wraps Source candidates and a fallback Image.
 */
export type PictureProps = Omit<HTMLAttributes<HTMLElement>, "className" | "children"> & {
  className?: string;
  children?: ReactNode;
};

export const Picture = forwardRef<HTMLElement, PictureProps>(function Picture(
  { className, children, ...rawRest },
  ref
) {
  const rest = safeRest(rawRest);
  const cls = pictureClasses({ className });
  return (
    <picture ref={ref} className={cls || undefined} {...rest}>
      {children}
    </picture>
  );
});
Picture.displayName = "Picture";

/**
 * Source renders a source candidate inside picture.
 */
export type SourceProps = Omit<SourceHTMLAttributes<HTMLSourceElement>, "className" | "children"> & {
  className?: string;
};

export const Source = forwardRef<HTMLSourceElement, SourceProps>(function Source(
  { className, ...rawRest },
  ref
) {
  const rest = safeRest(rawRest, { blank: ["srcset", "media", "type", "sizes"] });
  return (
    <source ref={ref} {...rest} />
  );
});
Source.displayName = "Source";

React registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework vue --dir src --registry-url https://registry.buildy.tw/vue --strict-cdn
npx ui8kit add kit-image
kit/ui/image/Image.vue
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Image renders an img element; alt is always emitted.
-->
<script setup lang="ts">
import { computed, useAttrs } from "vue";
import { imageClasses } from "./image.shared";
import { safeRest } from "../../utils/expr";

defineOptions({ name: "Image", inheritAttrs: false });

const props = defineProps<{
  alt: string;
}>();

const attrs = useAttrs();
const callerClass = computed(() => attrs.class as string | undefined);
const restAttrs = computed(() => {
  const { class: _class, ...restEntries } = attrs;
  return safeRest(restEntries, { img: true, blank: ["src", "srcset", "sizes", "width", "height", "loading", "decoding"] });
});
const cls = computed(() => imageClasses({ className: callerClass.value }));
</script>

<template>
  <img :alt="(props.alt) ?? ''" :class="cls || undefined" v-bind="restAttrs" />
</template>
kit/ui/image/Picture.vue
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Picture wraps Source candidates and a fallback Image.
-->
<script setup lang="ts">
import { computed, useAttrs } from "vue";
import { pictureClasses } from "./image.shared";
import { safeRest } from "../../utils/expr";

defineOptions({ name: "Picture", inheritAttrs: false });

const attrs = useAttrs();
const callerClass = computed(() => attrs.class as string | undefined);
const restAttrs = computed(() => {
  const { class: _class, ...restEntries } = attrs;
  return safeRest(restEntries);
});
const cls = computed(() => pictureClasses({ className: callerClass.value }));
</script>

<template>
  <picture :class="cls || undefined" v-bind="restAttrs">
    <slot />
  </picture>
</template>
kit/ui/image/Source.vue
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Source renders a source candidate inside picture.
-->
<script setup lang="ts">
import { computed, useAttrs } from "vue";
import { safeRest } from "../../utils/expr";

defineOptions({ name: "Source", inheritAttrs: false });

const attrs = useAttrs();
const restAttrs = computed(() => {
  const { class: _class, ...restEntries } = attrs;
  return safeRest(restEntries, { blank: ["srcset", "media", "type", "sizes"] });
});
</script>

<template>
  <source v-bind="restAttrs" />
</template>
kit/ui/image/image.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.image — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Image renders an img element; alt is always emitted. */
export type ImageBaseProps = {
  alt: string;
};

export type ImageClassesInput = {
  className?: string;
};

/** Compose Image classes without rendering — the cross-runtime `asChild` substitute. */
export function imageClasses(input: ImageClassesInput = {}): string {
  return cn(input.className);
}

/** Picture wraps Source candidates and a fallback Image. */
export type PictureBaseProps = {

};

export type PictureClassesInput = {
  className?: string;
};

/** Compose Picture classes without rendering — the cross-runtime `asChild` substitute. */
export function pictureClasses(input: PictureClassesInput = {}): string {
  return cn(input.className);
}

/** Source renders a source candidate inside picture. */
export type SourceBaseProps = {

};

Vue registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework solid --dir src --registry-url https://registry.buildy.tw/solid --strict-cdn
npx ui8kit add kit-image
kit/ui/image/image.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.image — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Image renders an img element; alt is always emitted. */
export type ImageBaseProps = {
  alt: string;
};

export type ImageClassesInput = {
  className?: string;
};

/** Compose Image classes without rendering — the cross-runtime `asChild` substitute. */
export function imageClasses(input: ImageClassesInput = {}): string {
  return cn(input.className);
}

/** Picture wraps Source candidates and a fallback Image. */
export type PictureBaseProps = {

};

export type PictureClassesInput = {
  className?: string;
};

/** Compose Picture classes without rendering — the cross-runtime `asChild` substitute. */
export function pictureClasses(input: PictureClassesInput = {}): string {
  return cn(input.className);
}

/** Source renders a source candidate inside picture. */
export type SourceBaseProps = {

};
kit/ui/image/image.solid.tsx
// Code generated by @ui8kit/codegen. DO NOT EDIT.
/**
 * Image renders img, picture, and source. Alt is required; pass an empty
 * string for decorative images.
 */

import { splitProps, type JSX, type Component } from "solid-js";
import { imageClasses, pictureClasses } from "./image.shared";
import { safeRest } from "../../utils/expr";

/**
 * Image renders an img element; alt is always emitted.
 */
export type ImageProps = Omit<JSX.ImgHTMLAttributes<HTMLImageElement>, "class" | "className" | "children" | "alt"> & {
  alt: string;
  class?: string;
  className?: string;
};

export const Image: Component<ImageProps> = (props) => {
  const [local, rest] = splitProps(props, ["alt", "class", "className"]);
  const cls = () => imageClasses({ className: local.class ?? local.className });
  return (
    <img alt={(local.alt) ?? ""} {...(cls() ? { class: cls() } : {})} {...safeRest(rest, { img: true, blank: ["src", "srcset", "sizes", "width", "height", "loading", "decoding"] })} />
  );
};

/**
 * Picture wraps Source candidates and a fallback Image.
 */
export type PictureProps = Omit<JSX.HTMLAttributes<HTMLElement>, "class" | "className" | "children"> & {
  class?: string;
  className?: string;
  children?: JSX.Element;
};

export const Picture: Component<PictureProps> = (props) => {
  const [local, rest] = splitProps(props, ["class", "className", "children"]);
  const cls = () => pictureClasses({ className: local.class ?? local.className });
  return (
    <picture {...(cls() ? { class: cls() } : {})} {...safeRest(rest)}>
      {local.children}
    </picture>
  );
};

/**
 * Source renders a source candidate inside picture.
 */
export type SourceProps = Omit<JSX.SourceHTMLAttributes<HTMLSourceElement>, "class" | "className" | "children"> & {
  class?: string;
  className?: string;
};

export const Source: Component<SourceProps> = (props) => {
  const [, rest] = splitProps(props, ["class", "className"]);
  return (
    <source {...safeRest(rest, { blank: ["srcset", "media", "type", "sizes"] })} />
  );
};

Solid registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework templ --dir src --registry-url https://registry.buildy.tw/templ --strict-cdn
npx ui8kit add kit-image
ui/image/image.templ
// Code generated by @ui8kit/codegen. DO NOT EDIT.

/*
Image renders img, picture, and source. Alt is required; pass an empty
string for decorative images.
*/

package image

import (
	uiutils "github.com/ui8kit/codegen/generated/templ/utils"
)

// ImageProps configures Image.
type ImageProps struct {
	// Class — token class names supplied by the consumer
	Class string
	Src string
	// Alt — alternative text; empty string for decorative images
	Alt string
	SrcSet string
	Sizes string
	Width string
	Height string
	Loading string
	Decoding string
	Attrs templ.Attributes
}

// ImageClasses composes Image classes without rendering —
// the server-composition escape hatch for custom root elements (no asChild in templ).
func ImageClasses(p ImageProps) string {
	return uiutils.Cn(p.Class)
}

// Image renders the Image contract.
templ Image(p ImageProps) {
	<img
		if !uiutils.HasAttr(p.Attrs, "src") {
			if uiutils.IsSetStr(uiutils.SafeImgURL(p.Src)) {
				src={ templ.SafeURL(uiutils.SafeImgURL(p.Src)) }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "alt") {
			alt={ p.Alt }
		}
		if ImageClasses(p) != "" {
			class={ ImageClasses(p) }
		}
		if !uiutils.HasAttr(p.Attrs, "srcset") {
			if uiutils.IsSetStr(p.SrcSet) {
				srcset={ p.SrcSet }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "sizes") {
			if uiutils.IsSetStr(p.Sizes) {
				sizes={ p.Sizes }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "width") {
			if uiutils.IsSetStr(p.Width) {
				width={ p.Width }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "height") {
			if uiutils.IsSetStr(p.Height) {
				height={ p.Height }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "loading") {
			if uiutils.IsSetStr(p.Loading) {
				loading={ p.Loading }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "decoding") {
			if uiutils.IsSetStr(p.Decoding) {
				decoding={ p.Decoding }
			}
		}
		{ uiutils.RestAttrs(p.Attrs, true, "src", "srcset", "sizes", "width", "height", "loading", "decoding")... }
	/>
}

// PictureProps configures Picture.
type PictureProps struct {
	// Class — token class names supplied by the consumer
	Class string
	Attrs templ.Attributes
}

// PictureClasses composes Picture classes without rendering —
// the server-composition escape hatch for custom root elements (no asChild in templ).
func PictureClasses(p PictureProps) string {
	return uiutils.Cn(p.Class)
}

// Picture renders the Picture contract.
templ Picture(p PictureProps) {
	<picture
		if PictureClasses(p) != "" {
			class={ PictureClasses(p) }
		}
		{ uiutils.RestAttrs(p.Attrs, false)... }
	>
		{ children... }
	</picture>
}

// SourceProps configures Source.
type SourceProps struct {
	SrcSet string
	Media string
	Type string
	Sizes string
	Attrs templ.Attributes
}

// Source renders the Source contract.
templ Source(p SourceProps) {
	<source
		if !uiutils.HasAttr(p.Attrs, "srcset") {
			if uiutils.IsSetStr(p.SrcSet) {
				srcset={ p.SrcSet }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "media") {
			if uiutils.IsSetStr(p.Media) {
				media={ p.Media }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "type") {
			if uiutils.IsSetStr(p.Type) {
				type={ p.Type }
			}
		}
		if !uiutils.HasAttr(p.Attrs, "sizes") {
			if uiutils.IsSetStr(p.Sizes) {
				sizes={ p.Sizes }
			}
		}
		{ uiutils.RestAttrs(p.Attrs, false, "srcset", "media", "type", "sizes")... }
	/>
}

templ registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework twig --dir src --registry-url https://registry.buildy.tw/twig --strict-cdn
npx ui8kit add kit-image
ui/image/Image.html.twig
{# Code generated by @ui8kit/codegen. DO NOT EDIT. #}
{# Image — Image renders an img element; alt is always emitted. #}
{# @param class (string) #}
{# @param src (string) #}
{# @param alt (string) #}
{# @param srcSet (string) #}
{# @param sizes (string) #}
{# @param width (string) #}
{# @param height (string) #}
{# @param loading (string) #}
{# @param decoding (string) #}
{# @param attrs (attrs) #}
{% set class = class|default('') %}
{% set src = src ?? null %}
{% set alt = alt|default('') %}
{% set srcSet = srcSet ?? null %}
{% set sizes = sizes ?? null %}
{% set width = width ?? null %}
{% set height = height ?? null %}
{% set loading = loading ?? null %}
{% set decoding = decoding ?? null %}
{% set attrs = attrs|default([]) %}
<img{{ ui8kit_attrs({'src': ui8kit_img_url_or_null(src), 'alt': alt, 'class': ui8kit_or_null(ui8kit_classes('imageClasses', {'class': class, 'src': src, 'alt': alt, 'srcSet': srcSet, 'sizes': sizes, 'width': width, 'height': height, 'loading': loading, 'decoding': decoding})), 'srcset': ui8kit_or_null(srcSet), 'sizes': ui8kit_or_null(sizes), 'width': ui8kit_or_null(width), 'height': ui8kit_or_null(height), 'loading': ui8kit_or_null(loading), 'decoding': ui8kit_or_null(decoding)}, attrs, true, ['src', 'srcset', 'sizes', 'width', 'height', 'loading', 'decoding']) }}>
ui/image/Picture.html.twig
{# Code generated by @ui8kit/codegen. DO NOT EDIT. #}
{# Picture — Picture wraps Source candidates and a fallback Image. #}
{# @param class (string) #}
{# @param attrs (attrs) #}
{# @param children (children) #}
{% set class = class|default('') %}
{% set attrs = attrs|default([]) %}
{% set children = children|default('') %}
<picture{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('pictureClasses', {'class': class}))}, attrs) }}>{{ children|raw }}</picture>
ui/image/Source.html.twig
{# Code generated by @ui8kit/codegen. DO NOT EDIT. #}
{# Source — Source renders a source candidate inside picture. #}
{# @param srcSet (string) #}
{# @param media (string) #}
{# @param type (string) #}
{# @param sizes (string) #}
{# @param attrs (attrs) #}
{% set srcSet = srcSet ?? null %}
{% set media = media ?? null %}
{% set type = type ?? null %}
{% set sizes = sizes ?? null %}
{% set attrs = attrs|default([]) %}
<source{{ ui8kit_attrs({'srcset': ui8kit_or_null(srcSet), 'media': ui8kit_or_null(media), 'type': ui8kit_or_null(type), 'sizes': ui8kit_or_null(sizes)}, attrs, false, ['srcset', 'media', 'type', 'sizes']) }}>

Twig registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework latte --dir src --registry-url https://registry.buildy.tw/latte --strict-cdn
npx ui8kit add kit-image
ui/image/Image.latte
{* Code generated by @ui8kit/codegen. DO NOT EDIT. *}
{* Image — Image renders an img element; alt is always emitted. *}
{parameters
  string $class = '',
  ?string $src = null,
  string $alt = '',
  ?string $srcSet = null,
  ?string $sizes = null,
  ?string $width = null,
  ?string $height = null,
  ?string $loading = null,
  ?string $decoding = null,
  array $attrs = [],
}
<img n:attr="[
  'src' => \UI8Kit\Latte\Rt::imgUrlOrNull($src),
  'alt' => $alt,
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::imageClasses(['class' => $class, 'src' => $src, 'alt' => $alt, 'srcSet' => $srcSet, 'sizes' => $sizes, 'width' => $width, 'height' => $height, 'loading' => $loading, 'decoding' => $decoding])),
  'srcset' => \UI8Kit\Latte\Rt::orNull($srcSet),
  'sizes' => \UI8Kit\Latte\Rt::orNull($sizes),
  'width' => \UI8Kit\Latte\Rt::orNull($width),
  'height' => \UI8Kit\Latte\Rt::orNull($height),
  'loading' => \UI8Kit\Latte\Rt::orNull($loading),
  'decoding' => \UI8Kit\Latte\Rt::orNull($decoding),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs, true, ['src', 'srcset', 'sizes', 'width', 'height', 'loading', 'decoding']),
]">
ui/image/Picture.latte
{* Code generated by @ui8kit/codegen. DO NOT EDIT. *}
{* Picture — Picture wraps Source candidates and a fallback Image. *}
{parameters
  string $class = '',
  array $attrs = [],
  string $children = '',
}
<picture n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::pictureClasses(['class' => $class])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</picture>
ui/image/Source.latte
{* Code generated by @ui8kit/codegen. DO NOT EDIT. *}
{* Source — Source renders a source candidate inside picture. *}
{parameters
  ?string $srcSet = null,
  ?string $media = null,
  ?string $type = null,
  ?string $sizes = null,
  array $attrs = [],
}
<source n:attr="[
  'srcset' => \UI8Kit\Latte\Rt::orNull($srcSet),
  'media' => \UI8Kit\Latte\Rt::orNull($media),
  'type' => \UI8Kit\Latte\Rt::orNull($type),
  'sizes' => \UI8Kit\Latte\Rt::orNull($sizes),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs, false, ['srcset', 'media', 'type', 'sizes']),
]">

Latte registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework jinja2 --dir src --registry-url https://registry.buildy.tw/jinja2 --strict-cdn
npx ui8kit add kit-image
ui/image/image.html.j2
{#- Code generated by @ui8kit/codegen. DO NOT EDIT.
    Image: Image renders an img element; alt is always emitted.
    Props (p): Class (string), Src (string), Alt (string), SrcSet (string), Sizes (string), Width (string), Height (string), Loading (string), Decoding (string), Attrs (attrs).
    Classes without rendering: image_classes(p) (no asChild in Jinja2). -#}
<img
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'src') %}{%- if ui_is_set_str(p['Src']) and ui_safe_url(p['Src'], true) != '' %} src="{{ p['Src'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'alt') %} alt="{{ ui_def(p['Alt'], '') }}"{%- endif %}
  {%- with cls = image_classes(p) %}{%- if cls %} class="{{ cls }}"{%- endif %}{%- endwith %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'srcset') %}{%- if ui_is_set_str(p['SrcSet']) %} srcset="{{ p['SrcSet'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'sizes') %}{%- if ui_is_set_str(p['Sizes']) %} sizes="{{ p['Sizes'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'width') %}{%- if ui_is_set_str(p['Width']) %} width="{{ p['Width'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'height') %}{%- if ui_is_set_str(p['Height']) %} height="{{ p['Height'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'loading') %}{%- if ui_is_set_str(p['Loading']) %} loading="{{ p['Loading'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'decoding') %}{%- if ui_is_set_str(p['Decoding']) %} decoding="{{ p['Decoding'] }}"{%- endif %}{%- endif %}
  {{ ui_attr_html(ui_def(p['Attrs'], {}), true, ['src', 'srcset', 'sizes', 'width', 'height', 'loading', 'decoding']) }}
>
ui/image/picture.html.j2
{#- Code generated by @ui8kit/codegen. DO NOT EDIT.
    Picture: Picture wraps Source candidates and a fallback Image.
    Props (p): Class (string), Attrs (attrs), Children (children).
    children: TRUSTED HTML printed with |safe — never pass unescaped user input.
    Classes without rendering: picture_classes(p) (no asChild in Jinja2). -#}
<picture
  {%- with cls = picture_classes(p) %}{%- if cls %} class="{{ cls }}"{%- endif %}{%- endwith %}
  {{ ui_attr_html(ui_def(p['Attrs'], {})) }}
>{{ children|default('', true)|safe }}</picture>
ui/image/source.html.j2
{#- Code generated by @ui8kit/codegen. DO NOT EDIT.
    Source: Source renders a source candidate inside picture.
    Props (p): SrcSet (string), Media (string), Type (string), Sizes (string), Attrs (attrs).
-#}
<source
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'srcset') %}{%- if ui_is_set_str(p['SrcSet']) %} srcset="{{ p['SrcSet'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'media') %}{%- if ui_is_set_str(p['Media']) %} media="{{ p['Media'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'type') %}{%- if ui_is_set_str(p['Type']) %} type="{{ p['Type'] }}"{%- endif %}{%- endif %}
  {%- if not ui_has_attr(ui_def(p['Attrs'], {}), 'sizes') %}{%- if ui_is_set_str(p['Sizes']) %} sizes="{{ p['Sizes'] }}"{%- endif %}{%- endif %}
  {{ ui_attr_html(ui_def(p['Attrs'], {}), false, ['srcset', 'media', 'type', 'sizes']) }}
>

Jinja2 registry item (JSON)

Props

Names and types come from the xgen specs of the source. Standard HTML attributes (id, role, tabIndex, aria-*) pass through to the root element; the class prop is className in React.

No props data for this item.