玻璃头像

avatar · glass-apple · 灵感来源:iOS 联系人头像 / Linear 成员头像(图 + 首字母回落 + 状态点)

三档尺寸(无图时取名字)

张三李四王小明

状态点:颜色之外还有读屏文案

Ada Lovelace在线Alan Turing忙碌Grace Hopper离线

图片加载失败回落首字母

Lin

复用卡

Avatar with fallback · 玻璃头像 · 头像 / Glass

规格 · 术语提示词(给 AI 用)

做一个 Avatar with fallback(玻璃头像):
- 无图或 onError 回落首字母:中文取前两字,西文取首字母缩写,不重试加载
- size 三档 sm 24 / md 32 / lg 44,字号随档位变化
- status 画 2px 圆点,另有 sr-only 文案(在线 / 忙碌 / 离线)
- 头像本身不可聚焦;可点入口由消费方包链接并把焦点环加在外框
用这些 CSS 变量:--color-success-fg --color-surface --color-text-muted --color-text-subtle --color-warning-fg --glass-bg --glass-border --text-2xs --text-xs
灵感参考:iOS 联系人头像 / Linear 成员头像(图 + 首字母回落 + 状态点)

参数(CSS 变量)

--color-success-fg --color-surface --color-text-muted --color-text-subtle --color-warning-fg --glass-bg --glass-border --text-2xs --text-xs

必缺状态

(无必缺状态)

整页场景

安装(一条链接)

调研笔记

玻璃头像

  • 无图或图片加载失败时回落首字母:中文取前两字,西文取首字母缩写;图片 onError 置位,不重试
  • size 三档(sm 24 / md 32 / lg 44)由外框尺寸决定,字号随档位走——头像不会因为字号自适应而变形
  • status 只画 2px 圆点,另有 sr-only 文案(在线 / 忙碌 / 离线):颜色不是唯一信息通道
  • 玻璃材质只改外框:半透明底 + 发丝边 + 模糊;图片本身不套滤镜,保持原图色彩
  • 头像不可点;可点的成员入口由消费方包一层链接,并把焦点环加在外框上

实现

avatar/glass-apple
import { useState } from 'react';

interface Props {
  name: string;
  src?: string;
  size?: 'sm' | 'md' | 'lg';
  status?: 'online' | 'busy' | 'offline';
  className?: string;
}

const SIZE = {
  sm: 'size-6 text-[length:var(--text-2xs)]',
  md: 'size-8 text-[length:var(--text-xs)]',
  lg: 'size-11 text-sm',
};

const STATUS = {
  online: 'bg-[var(--color-success-fg)]',
  busy: 'bg-[var(--color-warning-fg)]',
  offline: 'bg-[var(--color-text-subtle)]',
};

const STATUS_LABEL = {
  online: '在线',
  busy: '忙碌',
  offline: '离线',
};

/** 中文在小尺寸只留姓,lg 才放两个字;西文取首字母缩写 */
function initials(name: string, size: 'sm' | 'md' | 'lg') {
  const parts = name.trim().split(/\s+/);
  if (parts.length > 1) return (parts[0][0] + parts[1][0]).toUpperCase();
  if (/[\u4e00-\u9fa5]/.test(name)) return size === 'lg' ? name.slice(0, 2) : name.slice(0, 1);
  return name.slice(0, 2).toUpperCase();
}

export function GlassAppleAvatar({ name, src, size = 'md', status, className = '' }: Props) {
  const [broken, setBroken] = useState(false);
  const showImage = src && !broken;

  return (
    <span className={`relative inline-flex shrink-0 ${className}`}>
      <span
        className={`
          ${SIZE[size]} rounded-full overflow-hidden relative
          inline-flex items-center justify-center
          bg-[var(--glass-bg)] border border-[var(--glass-border)] backdrop-blur-xl
          text-[var(--color-text-muted)] font-medium
        `}
      >
        <span aria-hidden="true" className="absolute inset-0 grid place-items-center">
          {initials(name, size)}
        </span>
        {showImage && (
          <img
            src={src}
            alt=""
            className="absolute inset-0 size-full object-cover"
            onError={() => setBroken(true)}
          />
        )}
        <span className="sr-only">{name}</span>
      </span>

      {status && (
        <>
          <span
            className={`
              absolute -bottom-0 -right-0 size-2 rounded-full
              ring-2 ring-[var(--color-surface)]
              ${STATUS[status]}
            `}
            aria-hidden="true"
          />
          <span className="sr-only">{STATUS_LABEL[status]}</span>
        </>
      )}
    </span>
  );
}

元信息

标识
avatar/glass-apple
状态
done
最后提交
2026-11-01
风格轴
glass-apple
依赖 token
--color-success-fg --color-surface --color-text-muted --color-text-subtle --color-warning-fg --glass-bg --glass-border --text-2xs --text-xs
在工作台打开 源码与 notes 都在 src/components/avatar/glass-apple/