CSS: avatar

.instui-avatar · stable — Avatar pengguna yang menampilkan inisial atau gambar, berbentuk lingkaran secara default.

Secara default warna palet memberi rona pada inisial di permukaan transparan; -has-inverse-color mengisi permukaan dengan warna dan menempatkan inisial dengan warna yang sama. Varian -color-ai selalu mengisi dengan gradasi violet→sea. Untuk nama tampilan penuh, letakkan di konten (agar tetap berada di pohon aksesibilitas) dan tambahkan data-initials="XX" untuk tampilan visual ringkas — teks sebenarnya adalah yang diumumkan pembaca layar. Tanpa data-initials, konten yang meluap hanya dipotong keras (tanpa elipsis); bungkus dengan .name untuk pemotongan tepat pada huruf pertama, atau bagi menjadi .first-name/.last-name untuk dua huruf yang dipotong (keduanya dapat dikosongkan dan yang lain tetap terpusat).

Source: avatar.css

TIP

Peningkatan JS — CSS komponen ini merender dan berfungsi sendiri; padukan dengan @pantoken/interactions untuk menambahkan perilaku interaktif. Lihat modifier table below.

Aksesibilitas

Berikan avatar gambar alt yang bermakna (nama orang), bukan sekadar "avatar" generik; untuk avatar hanya inisial, lebih suka konten nama asli (teks biasa, data-initials, .name, atau .first-name/.last-name) daripada huruf yang sudah dipersingkat, sehingga teknologi bantu mengumumkan nama sebenarnya.

Penggunaan

css

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

Contoh

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 menampilkan salah satu: sebuah <img>, teks bare/data-initials, pembungkus .name, atau pasangan .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;

Modifikator

Modifikator	Deskripsi
`.-color-accent1`	Tidak disarankan — use `.-color-blue`.
`.-color-accent2`	Tidak disarankan — use `.-color-green`.
`.-color-accent3`	Tidak disarankan — use `.-color-red`.
`.-color-accent4`	Tidak disarankan — use `.-color-orange`.
`.-color-accent5`	Tidak disarankan — use `.-color-ash`.
`.-color-accent6`	Tidak disarankan — use `.-color-grey`.
`.-color-ai`	Warna palet aksen-AI.
`.-color-ash`	Warna palet Ash.
`.-color-blue`	Warna palet Blue.
`.-color-green`	Warna palet Green.
`.-color-grey`	Warna palet Grey.
`.-color-orange`	Warna palet Orange.
`.-color-red`	Warna palet Red.
`.-has-inverse-color`	Gunakan warna teks inverse (on-dark).
`.-shape-rectangle`	Bentuk kotak (persegi panjang) alih-alih lingkaran.
`.-show-border`	Alias — maps to `.-show-border-always`.
`.-show-border-always`	Paksa cincin border menyala, bahkan di atas gambar atau isian inverse.
`.-show-border-never`	Paksa cincin border mati.
`.-size-2xl`	Dua ukuran lebih besar.
`.-size-2xs`	Dua ukuran lebih kecil.
`.-size-large`	Besar. Alias bentuk panjang dari `-size-lg`.
`.-size-lg`	Besar.
`.-size-md`	Sedang (default).
`.-size-medium`	Sedang (default). Alias bentuk panjang dari `-size-md`.
`.-size-sm`	Kecil.
`.-size-small`	Kecil. Alias bentuk panjang dari `-size-sm`.
`.-size-x-large`	Ekstra besar. Alias bentuk panjang dari `-size-xl`.
`.-size-x-small`	Ekstra kecil. Alias bentuk panjang dari `-size-xs`.
`.-size-xl`	Ekstra besar.
`.-size-xs`	Ekstra kecil.
`.-size-xx-large`	Dua ukuran lebih besar. Alias bentuk panjang dari `-size-2xl`.
`.-size-xx-small`	Dua ukuran lebih kecil. Alias bentuk panjang dari `-size-2xs`.

Bagian

Bagian	Deskripsi
`.first-name`	Opsional (dipasangkan dengan .last-name): membungkus nama yang diberikan, dipotong pada huruf terdepan.
`.last-name`	Opsional (dipasangkan dengan .first-name): membungkus nama keluarga, dipotong pada huruf terdepan.
`.name`	Optional: wrap the full name to clip it to a single leading letter without data-initials or JS.

Pseudo-elemen

Pseudo-elemen	Deskripsi
`::before`	—

Token yang digunakan

Token	Tipe	Nilai
`--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>`	LightDark`light-dark(#273540, #1C222B)`
`--instui-component-avatar-ash-text-color`	`<color>`	LightDark`light-dark(#273540, #C7CACD)`
`--instui-component-avatar-background-color`	`<color>`	LightDark`light-dark(#ffffff, #10141A)`
`--instui-component-avatar-blue-background-color`	`<color>`	`#2B7ABC`
`--instui-component-avatar-blue-text-color`	`<color>`	LightDark`light-dark(#2871AF, #7FB4F1)`
`--instui-component-avatar-border-color`	`<color>`	LightDark`light-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>`	LightDark`light-dark(#037D37, #61C378)`
`--instui-component-avatar-grey-background-color`	`<color>`	LightDark`light-dark(#4A5B68, #576773)`
`--instui-component-avatar-grey-text-color`	`<color>`	LightDark`light-dark(#4A5B68, #F2F4F5)`
`--instui-component-avatar-orange-background-color`	`<color>`	`#CF4A00`
`--instui-component-avatar-orange-text-color`	`<color>`	LightDark`light-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>`	LightDark`light-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`

Terkait

byline — Dapat menampung avatar sebagai figur utama di awal.

tools

ai

platforms

renderers

packages

formats

design

bundlers

plugins

pantoken

postcss

typedoc

vite

Komponen

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

side-nav-bar

table

tabs

Utilitas

Aturan

Plugins

layout

CSS: avatar

Aksesibilitas

Penggunaan

Contoh

Struktur

Modifikator

Bagian

Pseudo-elemen

Token yang digunakan

Terkait

pantoken

postcss

typedoc

vite

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

side-nav-bar

table

tabs

CSS: avatar ​

Aksesibilitas ​

Penggunaan ​

Contoh ​

Struktur ​

Modifikator ​

Bagian ​

Pseudo-elemen ​

Token yang digunakan ​

Terkait ​

CSS: avatar

Aksesibilitas

Penggunaan

Contoh

Struktur

Modifikator

Bagian

Pseudo-elemen

Token yang digunakan

Terkait