CSS: avatar ​

.instui-avatar · stable — Un avatar d'usuari que mostra inicials o una imatge, circular per defecte.

Per defecte la paleta tiñeix les inicials sobre una superfície transparent; -has-inverse-color omple la superfície amb el color i posa les inicials sobre el color. La variant -color-ai sempre omple amb el degradat violet→sea. Per a un nom complet, posau-lo al contingut (perquè romangui a l'arbre d'accessibilitat) i afegiu data-initials="XX" per a la versió visual compacta — el text real és el que anuncia el lector de pantalla. Sense data-initials, el contingut que desborda es talla de forma rígida (sense punts suspensius); embolcallau-lo amb .name per a un tall precís de la primera lletra, o dividiu-lo en .first-name/.last-name per a dues lletres tallades (es pot ometre qualsevol meitat i l'altra roman centrada).

Source: avatar.css

TIP

Millora JS — El CSS d'aquest component es renderitza i funciona per si sol; combineu-lo amb @pantoken/interactions per afegir el comportament interactiu. Vegeu la taula de modificadors més avall.

Accessibilitat ​

Doneu a un avatar d'imatge un alt significatiu (el nom de la persona), no un "avatar" genèric; per avatar només amb inicials, preferiu el nom real en el contingut (text pla, data-initials, .name, o .first-name/.last-name) en comptes de lletres preabreujades, perquè les tecnologies d'assistència anunciïn el nom real.

Ús ​

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

Exemples ​

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>

Estructura ​

L'avatar mostra una de les opcions: un <img>, text nu/data-initials, un embolcall .name, o un parell .first-name/.last-name.

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;

Modificadors ​

ModificadorDescripció
.-color-accent1Deprecat — use .-color-blue.
.-color-accent2Deprecat — use .-color-green.
.-color-accent3Deprecat — use .-color-red.
.-color-accent4Deprecat — use .-color-orange.
.-color-accent5Deprecat — use .-color-ash.
.-color-accent6Deprecat — use .-color-grey.
.-color-aiColor de paleta amb accent d'IA.
.-color-ashColor de la paleta Ash.
.-color-blueColor de la paleta Blue.
.-color-greenColor de la paleta Green.
.-color-greyColor de la paleta Grey.
.-color-orangeColor de la paleta Orange.
.-color-redColor de la paleta Red.
.-has-inverse-colorUtilitzeu el color de text invertit (sobre fosc).
.-shape-rectangleForma quadrada (rectangular) en comptes de circular.
.-show-borderAlias — maps to .-show-border-always.
.-show-border-alwaysForça l'anell de contorn activat, fins i tot sobre una imatge o un ompliment invertit.
.-show-border-neverForça l'anell de contorn desactivat.
.-size-2xlDues mides més grans.
.-size-2xsDues mides més petites.
.-size-largeGran. Àlies en forma llarga de -size-lg.
.-size-lgGran.
.-size-mdMitjà (el per defecte).
.-size-mediumMitjà (el per defecte). Àlies en forma llarga de -size-md.
.-size-smPetit.
.-size-smallPetit. Àlies en forma llarga de -size-sm.
.-size-x-largeExtra gran. Àlies en forma llarga de -size-xl.
.-size-x-smallExtra petit. Àlies en forma llarga de -size-xs.
.-size-xlExtra gran.
.-size-xsExtra petit.
.-size-xx-largeDues mides més grans. Àlies en forma llarga de -size-2xl.
.-size-xx-smallDues mides més petites. Àlies en forma llarga de -size-2xs.

Parts ​

PartDescripció
.first-nameOpcional (fa parella amb .last-name): embolcalla el nom indicat, tallat a la seva lletra inicial.
.last-nameOpcional (fa parella amb .first-name): embolcalla el cognom, tallat a la seva lletra inicial.
.nameOptional: wrap the full name to clip it to a single leading letter without data-initials or JS.

Pseudoelements ​

PseudoelementDescripció
::before—

Tokens consumits ​

TokenTipusValor
--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

Relacionat ​

  • byline — Pot allotjar un avatar com a figura principal al principi.