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) را به حروف پیش‌کوتاه‌شده ترجیح دهید تا فناوری‌های کمکی نام واقعی را اعلام کنند.

نحوه استفاده ​

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">دکتر Nguyen Van Thoc</span>
<span class="instui-avatar"><span class="name">میگل سانچز</span></span>
<span class="instui-avatar"><span class="first-name">میگل</span> <span class="last-name">سانچز</span></span>

ساختار ​

آواتار یکی از موارد زیر را نمایش می‌دهد: یک <img>، متن خالص/data-initials، یک عنصر .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منسوخ — use .-color-grey.
.-color-blueرنگ پالت آبی.
.-color-greenرنگ پالت سبز.
.-color-greyرنگ پالت خاکستری.
.-color-orangeرنگ پالت نارنجی.
.-color-redرنگ پالت قرمز.
.-has-inverse-colorاز رنگ متن معکوس (برای پس‌زمینهٔ تیره) استفاده کنید.
.-shape-rectangleشکل مربعی (مستطیلی) به‌جای دایره.
.-show-borderAlias — 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): نام خانوادگی را می‌پوشاند، که به حرف ابتدایی آن بریده شده است.
.nameOptional: wrap the full name to clip it to a single leading letter without data-initials or JS.

نیمه‌عناصر (Pseudo-elements) ​

نیمه‌عنصرتوضیحات
::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.25rem
--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(#B23F01, #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 — می‌تواند یک آواتار را به‌عنوان تصویر راهبر پیشرو میزبانی کند.