Skip to content

CSS: avatar

.instui-avatar · stable — Eit brukaravatar som viser initialar eller eit bilete, sirkulært som standard.

Som standard fargar palettfargen initialane på ei transparent flate; -has-inverse-color fyller flata med fargen og plassar initialane på same farge. Varianten -color-ai fyller alltid med gradienten violet→sea. For eit fullt visningsnamn, legg det i innhaldet (slik at det blir i tilgjengelegheitstreet) og legg til data-initials="XX" for den kompakte visuelle versjonen — den faktiske teksten er det skjermlesaren les opp. Uten data-initials blir overløpande innhald berre hard-klipta (inga ellipsis); pakk det i .name for ei presis ein-leia-bokstav-klipping, eller del det i .first-name/.last-name for to klipte bokstavar (antingen halvdel kan utelateast og den andre held seg sentrert).

Source: avatar.css

TIP

JS-forbetring — Denne komponenten sin CSS rendrar og fungerer sjølvstendig; par han med @pantoken/interactions for å leggje til den interaktive åtferda. Sjå modifier table below.

Tilgjenge

Gjev eit bileteavatar ei meiningsfull alt (personen sitt namn), ikkje eit generisk «avatar»; for avatarar med berre initialar, føretrekk ekte namninnhald (raud tekst, data-initials, .name, eller .first-name/.last-name) framfor førehandsforkorta bokstavar, slik at assistiv teknologi kunngjer det verkelege namnet.

Bruk

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/avatar.css";

Døme

html
<span class="instui-avatar --me-sm">LH</span>
<span class="instui-avatar -color-ai --me-sm">AI</span>
<span class="instui-avatar --me-sm" data-initials="NV">Dr. Nguyen Van Thoc</span>
<span class="instui-avatar"><span class="name">Miguel Sanchez</span></span>
<span class="instui-avatar"><span class="first-name">Miguel</span> <span class="last-name">Sanchez</span></span>

Struktur

Avatar viser éin av: eit <img>, naken/data-initials tekst, ei .name-innpakning, eller eit .first-name/.last-name-par.

text
.instui-avatar
  img (0..1)
  .name (0..1)
  .first-name (0..1)
  .last-name (0..1)
flowchart TD n0[".instui-avatar"]:::cssdoc-root n1("img"):::cssdoc-part n2(".name"):::cssdoc-part n3(".first-name"):::cssdoc-part n4(".last-name"):::cssdoc-part n0 -.->|0..1| n1 n0 -.->|0..1| n2 n0 -.->|0..1| n3 n0 -.->|0..1| n4 classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Modifikatorar

ModifikatorSkildring
.-color-accent1Utdatert — use .-color-blue.
.-color-accent2Utdatert — use .-color-green.
.-color-accent3Utdatert — use .-color-red.
.-color-accent4Utdatert — use .-color-orange.
.-color-accent5Utdatert — use .-color-ash.
.-color-accent6Utdatert — use .-color-grey.
.-color-aiAI-accent palettfarge.
.-color-ashAsk-palettfarge.
.-color-blueBlå palettfarge.
.-color-greenGrøn palettfarge.
.-color-greyGrå palettfarge.
.-color-orangeOransje palettfarge.
.-color-redRaud palettfarge.
.-has-inverse-colorBruk invers (på-mørk) tekstfarge.
.-shape-rectangleFirkanta (rektangulær) form i staden for sirkel.
.-show-borderAlias — maps to .-show-border-always.
.-show-border-alwaysTving på grense-ringen, sjølv over eit bilete eller ein invers fyll.
.-show-border-neverTving av grense-ringen.
.-size-2xlTo storleikar større.
.-size-2xsTo storleikar mindre.
.-size-largeStor. Langform-alias av -size-lg.
.-size-lgStor.
.-size-mdMiddels (standard).
.-size-mediumMiddels (standard). Langform-alias av -size-md.
.-size-smLiten.
.-size-smallLiten. Langform-alias av -size-sm.
.-size-x-largeEkstra stor. Langform-alias av -size-xl.
.-size-x-smallEkstra liten. Langform-alias av -size-xs.
.-size-xlEkstra stor.
.-size-xsEkstra liten.
.-size-xx-largeTo storleikar større. Langform-alias av -size-2xl.
.-size-xx-smallTo storleikar mindre. Langform-alias av -size-2xs.

Delar

DelSkildring
.first-nameValfri (parar med .last-name): pakk det gjevne namnet, klipt til ledebokstaven.
.last-nameValfri (parar med .first-name): pakk etternamnet, klipt til ledebokstaven.
.nameOptional: wrap the full name to clip it to a single leading letter without data-initials or JS.

Pseudo-element

Pseudo-elementSkildring
::before

Token brukt

TokenTypeVerdi
--instui-component-avatar-ai-bottom-gradient-color<color>#00828E
--instui-component-avatar-ai-top-gradient-color<color>#9E58BD
--instui-component-avatar-ash-background-color<color>LightDarklight-dark(#273540, #1C222B)
--instui-component-avatar-ash-text-color<color>LightDarklight-dark(#273540, #C7CACD)
--instui-component-avatar-background-color<color>LightDarklight-dark(#ffffff, #10141A)
--instui-component-avatar-blue-background-color<color>#2B7ABC
--instui-component-avatar-blue-text-color<color>LightDarklight-dark(#2871AF, #7FB4F1)
--instui-component-avatar-border-color<color>LightDarklight-dark(#8D959F, #6A7883)
--instui-component-avatar-border-width-md<length>0.125rem
--instui-component-avatar-border-width-sm<length>0.0625rem
--instui-component-avatar-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-avatar-font-size-lg<length>1.25rem
--instui-component-avatar-font-size-md<length>1rem
--instui-component-avatar-font-size-sm<length>0.875rem
--instui-component-avatar-font-size-xl<length>1.75rem
--instui-component-avatar-font-size-xs<length>0.75rem
--instui-component-avatar-font-size2xl<length>2.5rem
--instui-component-avatar-font-size2xs<length>0.75rem
--instui-component-avatar-font-weight<integer>600
--instui-component-avatar-green-background-color<color>#03893D
--instui-component-avatar-green-text-color<color>LightDarklight-dark(#037D37, #61C378)
--instui-component-avatar-grey-background-color<color>LightDarklight-dark(#4A5B68, #576773)
--instui-component-avatar-grey-text-color<color>LightDarklight-dark(#4A5B68, #F2F4F5)
--instui-component-avatar-orange-background-color<color>#CF4A00
--instui-component-avatar-orange-text-color<color>LightDarklight-dark(#BB4200, #FF905A)
--instui-component-avatar-rectangle-radius<length>0.25rem
--instui-component-avatar-red-background-color<color>#E62429
--instui-component-avatar-red-text-color<color>LightDarklight-dark(#CF1F24, #FA917F)
--instui-component-avatar-size-lg<length>3.5rem
--instui-component-avatar-size-md<length>3rem
--instui-component-avatar-size-sm<length>2.5rem
--instui-component-avatar-size-xl<length>4rem
--instui-component-avatar-size-xs<length>2rem
--instui-component-avatar-size2xl<length>5rem
--instui-component-avatar-size2xs<length>1.5rem
--instui-component-avatar-text-on-color<color>#ffffff

Relatert

  • byline — Kan huse eit avatar som sitt leiande hovudbilete.