06 · Exibição

Mask

shape squircle · reuleaux-triangle · diamond · hexagon · hexagon-2 · octagon · star · star-2 · heart

Recorta imagem ou bloco numa forma (logo de loja, avatar especial, selo).

Formas girando

BP BP BP
.heex
<div class="flex flex-wrap items-center gap-2.5"><.mask :for={{s, d} <- [{"hexagon", "0.0s"}, {"star", "0.2s"}, {"diamond", "0.4s"}]} shape={s} size="56" class="animate-[mo-pulse_2s_ease-in-out_infinite]" style={"animation-delay:#{d}"}>BP</.mask></div>

shape (9)

BP squircle
BP reuleaux-triangle
BP diamond
BP hexagon
BP hexagon-2
BP octagon
BP star
BP star-2
BP heart
.heex
<div class="flex flex-wrap items-start gap-2.5"><div :for={s <- ~w(squircle reuleaux-triangle diamond hexagon hexagon-2 octagon star star-2 heart)} class="flex flex-col gap-1"><.mask shape={s} size="64" style="background:linear-gradient(135deg,var(--lu-accent-300),var(--lu-accent-700))">BP</.mask><span class="font-mono text-xs text-muted">{s}</span></div></div>

Uso

<.mask shape="hexagon"><img src={@logo} /></.mask>

Regras

  • Use em logos e selos; para pessoas prefira o avatar redondo.

Referência da API

Todos os function components, atributos, valores e slots que este componente cobre.

Crops its content to one of nine mask shapes: squircle, reuleaux-triangle, diamond, hexagon, hexagon-2, octagon, star, star-2 and heart.

<.mask shape="heart" src="/images/avatar.jpg" alt="Jane" size="64" />
<.mask shape="hexagon" size="56"><span>JD</span></.mask>
<.mask shape="star" label="Favorite" size="32" />

With src it renders the masked image; otherwise a block holding the inner content. The block keeps its inner content readable by screen readers; give it a label when the shape itself carries the meaning (role="img" and aria-label). The size is size (pixels, or an LedgerUI.Components.Avatar size name); paint it with style="background: ...".

It is drawn with the face of the avatar (LedgerUI.Components.Avatar), so it is styled only with Tailwind utilities.

<.mask>

Attr Type Default Values / notes
shape :string "squircle" squircle, reuleaux-triangle, diamond, hexagon, hexagon-2, octagon, star, star-2, heart
src :string nil
alt :string ""
label :string nil Names a block mask for assistive technology.
size :string "64" Pixels or an avatar size name.
style :string nil
class :any nil

Any other HTML/phx attribute goes to the root element.

Slots:

  • <:inner_block>