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 配对可添加交互行为。参见下方的 modifier table。

无障碍

为图片头像提供有意义的 alt（该人的姓名），而非通用“avatar”；仅首字母的头像应优先使用真实姓名内容（纯文本、data-initials、.name 或 .first-name/.last-name），以便辅助技术能朗读真实姓名，而不是预先缩写的字母。

用法

css

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

示例

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>

结构

头像可显示以下之一：<img>、纯文本/数据首字母、.name 包裹，或 .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;

修饰符

修饰符	描述
`.-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`	蓝色调色板颜色。
`.-color-green`	绿色调色板颜色。
`.-color-grey`	灰色调色板颜色。
`.-color-orange`	橙色调色板颜色。
`.-color-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`	Large。`-size-lg` 的长形式别名。
`.-size-lg`	Large。
`.-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>`	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`

tools

ai

platforms

renderers

packages

formats

design

bundlers

plugins

pantoken

postcss

typedoc

vite

组件

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

side-nav-bar

table

tabs

实用工具

规则

Plugins

layout

CSS: avatar

无障碍

用法

示例

结构

修饰符

部件

伪元素

消耗代币

相关

pantoken

postcss

typedoc

vite

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

side-nav-bar

table

tabs

CSS: avatar ​

无障碍 ​

用法 ​

示例 ​

结构 ​

修饰符 ​

部件 ​

伪元素 ​

消耗代币 ​

相关 ​

CSS: avatar

无障碍

用法

示例

结构

修饰符

部件

伪元素

消耗代币

相关