chrome:shell.skip

generated:catalog.entry.image.title

generated:catalog.entry.image.description

@xngui/components/image
@xngui/components/image

chrome:demo.section

chrome:demo.preview

Image unavailable
Mountain landscape
demo-preview:hints.category.assistive:
TipSR
demo-preview:projection.slots-label:
[xPlaceholder] [xContent]
import { Component } from '@angular/core';
import { XImage } from '@xngui/components/image';
import { XSkeleton } from '@xngui/components/skeleton';
 
@Component({
selector: 'app-example',
imports: [XImage, XSkeleton],
templateUrl: './image.component.html',
})
export class ExampleComponent {}

chrome:demo.events.title 1

  1. stateChange
    loading

chrome:demo.api.title

x-image

chrome:demo.api.col.property
chrome:demo.api.col.type
chrome:demo.api.col.default
chrome:demo.api.col.description
src chrome:demo.api.required
XFileSource
—
Primary image source — URL, data URI, blob, or file.
alt chrome:demo.api.required
string
—
Accessible description; use an empty string for decorative images.
fallback
XFileSource
—
Alternate source shown when the primary `src` fails to load.
width
number
—
Intrinsic width forwarded to the native `<img>`.
height
number
—
Intrinsic height forwarded to the native `<img>`.
aspectRatio
XAspectRatioValue
—
Aspect ratio for the inner frame — e.g. `16:9` or `16 / 9`.
fit
XImageFit
'cover'
CSS `object-fit` for the image surface.
position
string
'center'
CSS `object-position` for the image surface.
loading
XImageLoading
'lazy'
Native loading strategy.
decoding
XImageDecoding
'async'
Browser decoding hint for the native `<img>`.
crossOrigin
string
—
Native `crossorigin` attribute when loading cross-origin assets.