Testimonialv1.0.0
کارتِ نظرِ مشتری برای صفحات فرود: نقلقول، نویسنده (با آواتار) و امتیازِ اختیاری. Card و Avatar از قبل بودند؛ این کامپوننت همان ترکیبِ آمادهٔ نقلقول را با علامتِ گیومهٔ بزرگ و چیدمانِ درستِ نویسنده در پایینِ کارت میدهد.
این کامپوننت فعلاً برای ۱ فریمورک از ۴ فریمورک آماده است.
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
نصب
با CLI اختصاصی digdesign کامپوننت را از رجیستری دیگ نصب کنید؛ وابستگیها و فایلها خودکار اضافه میشوند.
npx digdesign@latest add https://docs.digdesign.ir/r/testimonial.jsonpnpm dlx digdesign@latest add https://docs.digdesign.ir/r/testimonial.jsonyarn dlx digdesign@latest add https://docs.digdesign.ir/r/testimonial.jsonbunx --bun digdesign@latest add https://docs.digdesign.ir/r/testimonial.jsonاین کامپوننت هنوز برای Vue پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Svelte پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Angular پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
استفاده
import {
Testimonial,
TestimonialQuoteMark,
TestimonialQuote,
TestimonialAuthor,
TestimonialAuthorAvatar,
TestimonialAuthorName,
TestimonialAuthorRole,
} from "@/components/ui/testimonial"
import { Avatar } from "@/components/ui/avatar"این کامپوننت هنوز برای Vue پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Svelte پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Angular پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
ترکیب اجزا
Testimonial یک figure با flex-col است؛ TestimonialAuthor با mt-auto همیشه به پایینِ کارت میچسبد، حتی اگر نقلقولها در یک ردیفِ گرید طولهای متفاوت داشته باشند.
آواتار خودِ کامپوننتِ Avatar است؛ TestimonialAuthorAvatar فقط یک ظرفِ کوچک برای جلوگیری از فشردهشدنِ آن در چیدمانِ flex است.
دسترسپذیری
- ریشه یک تگ figure است و TestimonialAuthor از figcaption استفاده میکند؛ این جفت بهطور معنایی نقلقول را به منبعش وصل میکند.
- TestimonialRating با role="img" و aria-label یک خلاصهٔ متنی از امتیاز میدهد؛ صفحهخوان مجبور نیست ستارهها را یکییکی بشمارد.
مرجع API
Testimonial
| ویژگی | نوع | پیشفرض | توضیح |
|---|---|---|---|
| variant | "elevated" | "bordered" | "flat" | "elevated" | سطح ظاهریِ کارت. |
TestimonialRating
| ویژگی | نوع | پیشفرض | توضیح |
|---|---|---|---|
| rating | number | — | امتیازِ فعلی؛ به نزدیکترین عددِ صحیح گرد میشود. |
| max | number | 5 | بیشینهٔ امتیاز (تعداد ستارهها). |
این کامپوننت هنوز برای Vue پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Svelte پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Angular پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
نمونهها
با امتیاز
TestimonialRating را قبل یا بعد از نقلقول بگذارید؛ برای نظراتِ فروشگاهی/مارکتپلیس مناسبتر از گیومهٔ تزئینی است.
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
تصویر واقعی بهجای حروف اول
Avatar با src کار میکند؛ اگر تصویر لود نشود، خودکار به حروفِ اول برمیگردد.
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
Variants
elevated (پیشفرض، سایهدار)، bordered (فقط حاشیه، برای گذاشتن روی پسزمینهٔ رنگی) و flat (پسزمینهٔ ملایم).
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
گرید سهستونه
چون TestimonialAuthor با mt-auto به پایین میچسبد، کارتها در یک ردیفِ گرید همارتفاع میمانند حتی با طولِ نقلقولِ متفاوت.
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
کدام نمونه برای کدام موقعیت
| نمونه | کجا به کار میآید |
|---|---|
| با امتیاز | TestimonialRating را قبل یا بعد از نقلقول بگذارید؛ برای نظراتِ فروشگاهی/مارکتپلیس مناسبتر از گیومهٔ تزئینی است. |
| تصویر واقعی بهجای حروف اول | Avatar با src کار میکند؛ اگر تصویر لود نشود، خودکار به حروفِ اول برمیگردد. |
| Variants | elevated (پیشفرض، سایهدار)، bordered (فقط حاشیه، برای گذاشتن روی پسزمینهٔ رنگی) و flat (پسزمینهٔ ملایم). |
| گرید سهستونه | بخشِ «مشتریان ما میگویند» در صفحهٔ فرود |
دستورالعمل استفاده
نقلقول واقعی و قابل استناد
«پشتیبانیشان در کمتر از یک ساعت جواب داد.»
انجام بده
نام، نقش و در صورت امکان تصویر واقعیِ مشتری را بگذارید؛ اعتبار نقلقول از همین جزئیات میآید.
«محصول خیلی خوبیه، پیشنهاد میکنم.»
انجام نده
نقلقولِ بدونِ نام یا با نامِ مستعارِ نامشخص («کاربرِ راضی») اعتماد نمیسازد، حتی اگر متنش خوب باشد.