CSS: avatar

.instui-avatar · stable — Аватар пользователя, показывающий инициалы или изображение, по умолчанию круглый.

По умолчанию цвет палитры тонирует инициалы на прозрачной поверхности; -has-inverse-color заполняет поверхность цветом и располагает инициалы на цветном фоне. Вариант -color-ai всегда заполняет градиентом от фиолетового к морскому. Для полного отображаемого имени поместите его в содержимое (чтобы оно оставалось в дереве доступности) и добавьте data-initials="XX" для компактного визуала — реальный текст будет объявлен экранным чтецом. Без data-initials выходящее за пределы содержимое просто обрезается (без троеточия); оберните в .name для точного обрезания до одной ведущей буквы, либо разделите на .first-name/.last-name для двух обрезанных букв (любой из половин можно опустить, а другая останется по центру).

Source: avatar.css

TIP

Улучшение JS — CSS этого компонента отрисовывает и работает самостоятельно; соединяйте его с @pantoken/interactions чтобы добавить интерактивное поведение. См. таблицу модификаторов ниже.

Доступность

Дайте изображению-аватару содержательный alt (имя человека), а не общий «avatar»; для аватаров с одними инициалами предпочитайте реальное имя в содержимом (обычный текст, data-initials, .name или .first-name/.last-name) вместо заранее сокращённых букв, чтобы вспомогательные технологии объявляли реальное имя.

Использование

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

Примеры

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

Структура

Аватар показывает один из вариантов: <img>, текст с bare/data-initials, обёртку .name или пару .first-name/.last-name.

.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;

Модификаторы

Модификатор	Описание
.-color-accent1	Устарело — use .-color-blue.
.-color-accent2	Устарело — use .-color-green.
.-color-accent3	Устарело — use .-color-red.
.-color-accent4	Устарело — use .-color-orange.
.-color-accent5	Устарело — use .-color-ash.
.-color-accent6	Устарело — use .-color-grey.
.-color-ai	Цвет палитры с акцентом AI.
.-color-ash	Цвет палитры Ash.
.-color-blue	Цвет палитры Blue.
.-color-green	Цвет палитры Green.
.-color-grey	Цвет палитры Grey.
.-color-orange	Цвет палитры Orange.
.-color-red	Цвет палитры Red.
.-has-inverse-color	Использовать инверсный (на тёмном фоне) цвет текста.
.-shape-rectangle	Квадратная (прямоугольная) форма вместо круга.
.-show-border	Alias — maps to .-show-border-always.
.-show-border-always	Принудительно включить кольцо границы, даже поверх изображения или инверсной заливки.
.-show-border-never	Принудительно отключить кольцо границы.
.-size-2xl	На два размера больше.
.-size-2xs	На два размера меньше.
.-size-large	Большой. Длинная форма для -size-lg.
.-size-lg	Большой.
.-size-md	Средний (по умолчанию).
.-size-medium	Средний (по умолчанию). Длинная форма для -size-md.
.-size-sm	Маленький.
.-size-small	Маленький. Длинная форма для -size-sm.
.-size-x-large	Очень большой. Длинная форма для -size-xl.
.-size-x-small	Очень маленький. Длинная форма для -size-xs.
.-size-xl	Очень большой.
.-size-xs	Очень маленький.
.-size-xx-large	На два размера больше. Длинная форма для -size-2xl.
.-size-xx-small	На два размера меньше. Длинная форма для -size-2xs.

Части

Часть	Описание
.first-name	Необязательно (в паре с .last-name): оборачивает указанное имя, обрезая до его ведущей буквы.
.last-name	Необязательно (в паре с .first-name): оборачивает фамилию, обрезая до её ведущей буквы.
.name	Optional: wrap the full name to clip it to a single leading letter without data-initials or JS.

Псевдоэлементы

Псевдоэлемент	Описание
::before	—

Использованные токены

Token	Тип	Значение
--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

Связанные

• byline — Может содержать аватар как ведущую иллюстрацию.