Struct ImageWidget 

pub struct ImageWidget {
    pub source: ImageSource,
    pub fit: ImageFit,
    pub width: f32,
    pub height: f32,
    pub placeholder_color: Color,
    pub alt: Option<String>,
}

A widget that renders an image from a file path or raw bytes.

Falls back to a colored placeholder when the image cannot be decoded.

Fields

source: ImageSource

fit: ImageFit

width: f32

height: f32

placeholder_color: Color

alt: Option<String>

Accessible/SEO alt text (D107/Phase 25) — None produces no semantics entry at all (an image with no .alt(...) call is decorative, matching HTML’s own convention of an empty/absent alt attribute), not an empty-string placeholder.

Implementations

impl ImageWidget

pub fn new() -> Self

Create a new ImageWidget with placeholder defaults.

pub fn alt(self, alt: impl Into<String>) -> Self

Sets the accessible/SEO alt text.

pub fn file(self, path: impl Into<PathBuf>) -> Self

Set the image source to a file path.

pub fn asset(self, name: impl AssetRef) -> Self

Load the image from a bundled asset by logical name — resolved per-platform via rosace_core::asset (dev: assets/<name>; mobile: the app bundle). Prefer this over file for shipped images: it’s portable across platforms and hot-reloads under rsc dev.

ImageWidget::new().asset("logo.png").fit(ImageFit::Contain)

pub fn bytes(self, data: Vec<u8>) -> Self

Set the image source to raw PNG bytes.

pub fn fit(self, f: ImageFit) -> Self

Set the fit mode.

pub fn width(self, w: f32) -> Self

Set the widget width in pixels.

pub fn height(self, h: f32) -> Self

Set the widget height in pixels.

pub fn placeholder_color(self, c: Color) -> Self

Set the placeholder background color shown when no image is available.

pub fn render( &self, canvas: &mut SkiaCanvas, font: &FontCache, x: f32, y: f32, _theme: &ThemeData, )

Render the image at (x, y).

Falls back to a colored placeholder with a simple icon if the image cannot be loaded or decoded.

Trait Implementations

impl Default for ImageWidget

fn default() -> Self

Returns the “default value” for a type.