@spectrum-web-components/asset

Description

Use an <sp-asset> element to visually represent a file, folder or image in your application. File and folder representations will center themselves horizontally and vertically in the space provided to the element. Images will be contained to the element, growing to the element's full height while centering itself within the width provided.

Installation

yarn add @spectrum-web-components/asset

Import the side effectful registration of <sp-asset> via:

import '@spectrum-web-components/asset/sp-asset.js';

When looking to leverage the Asset base class as a type and/or for extension purposes, do so via:

import { Asset } from '@spectrum-web-components/asset';

Example

<sp-asset style="height: 128px">
    <img src="https://picsum.photos/500/500" alt="Demo Image" />
</sp-asset>

File

<div class="flex">
    <sp-asset variant="file"></sp-asset>
    <sp-asset variant="file" label="Named File Asset"></sp-asset>
</div>

Folder

<div class="flex">
    <sp-asset variant="folder"></sp-asset>
    <sp-asset variant="folder" label="Named Folder Asset"></sp-asset>
</div>

Changelog

1.1.0 (2025-01-29)

Bug Fixes

• lock prerelease versions for Spectrum CSS (#5014) (8aa7734)
• overlay: make :focus-visible consistent when using overlay type modal (#4912) (7a5f786), closes #5021

Features

• add an optional chromatic vrt action (7d2f840)
• opacity-checkerboard: bump CSS version (#5040) (e3bf6d3)
• picker: add forcePopover property (#5041) (3651e57)
• sp-button-group: sp-button-group react to size updates (#5037) (63bc618)
• thumbnail: bump thumbnail to use foundations release (7490324)
• use globals to enable VRT modes in chromatic (5b674b4)