Image album
The pictures of one message as one album, and one picture's tile, which opens the viewer and holds its menu.
import { ImageAlbum, ImageTile } from "@arcadia/ui"TSX
Examples
--image-album-width- Ref<Measure>Default var(--bubble-measure)
- The widest it grows. Default a bubble's measure.
--image-album-height- Ref<Measure>Default var(--media-max-height)
- How tall one picture alone stands; several, half as tall again. Default the media height.
ImageAlbum
imagesrequired- readonly T[]
- The pictures shown together, in order: one stands alone at its own proportions, several make rows.
label- (image: T, index: number) => string
- Each picture's name for assistive technology. Default its own name, else "Image".
onOpen- (index: number, from: HTMLElement) => void
- Opens one (the product's viewer), from its tile. Without it the pictures do not open.
actions- (image: T, index: number) => readonly ImageAction[]
- What each picture's menu holds.
over- (image: T, index: number) => ReactNode
- What the product lays over a picture (an upload's ring).
mark- ReactNode
- The product's mark at its foot (a read mark), on a plate.
focusable- booleanDefault true
- Its pictures are reached with Tab.
side- "start" | "end"Default "start"
- Which side of its column it stands on.
inBubble- booleanDefault false
- At the top of a bubble, edge to edge: the bubble's corners above it, square under it, over the words.
rootStyle- RootStyle<ImageAlbumKnobs>
- Typed StyleX override: layout and the
--image-album-*knobs.
Rest props go to <div> props.
imagerequired- MediaImage
- A picture as the kit's image parts show it: plain data, nothing of the product that holds it and nothing of a server. Its sides and where its original is; everything else is optional. With no preview the original serves everywhere, and with no placeholder the quiet skeleton stands in its place until it is drawn.
frame- number
- Its box's width over its height; a picture of another shape is cut to it, a tall one from its top. Default its own, held between 2:5 and 8:1.
label- string
- Its name for assistive technology. Default the image's name, else "Image".
onOpen- (from: HTMLElement) => void
- Opens it (the product's viewer), from the tile pressed. Without it the tile is the picture alone.
actions- readonly ImageAction[]Default []
- What its menu holds (a right click, the menu key, a long press), on a tile that opens.
focusable- booleanDefault true
- Reached with Tab.
over- ReactNode
- What the product lays over the picture (an upload's ring), above its press.
rootStyle- RootStyle
- Typed StyleX override: layout.
Rest props go to <span> props.