Recommendation Cardv1.0.0
پیش از اجرایِ یک اقدامِ واقعی، عامل پیشنهادش را با میزانِ اطمینانِ خودش نشان میدهد. فهرستِ گزینههایِ جایگزین پیشفرض بسته است تا توجهِ کاربر اول روی پیشنهادِ اصلی بماند.
این کامپوننت فعلاً برای ۱ فریمورک از ۴ فریمورک آماده است.
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
نصب
با CLI اختصاصی digdesign کامپوننت را از رجیستری دیگ نصب کنید؛ وابستگیها و فایلها خودکار اضافه میشوند.
npx digdesign@latest add https://docs.digdesign.ir/r/recommendation-card.jsonpnpm dlx digdesign@latest add https://docs.digdesign.ir/r/recommendation-card.jsonyarn dlx digdesign@latest add https://docs.digdesign.ir/r/recommendation-card.jsonbunx --bun digdesign@latest add https://docs.digdesign.ir/r/recommendation-card.jsonاین کامپوننت هنوز برای Vue پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Svelte پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Angular پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
استفاده
import {
RecommendationCard,
RecommendationCardActions,
RecommendationCardConfidence,
RecommendationCardPrimary,
RecommendationCardQuestion,
} from "@/components/ui/recommendation-card"این کامپوننت هنوز برای Vue پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Svelte پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Angular پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
ترکیب اجزا
RecommendationCardConfidence یک Meter است با رنگِ خودکار بر اساسِ مقدار (بالایِ ۷۰ سبز، بینِ ۴۰ تا ۷۰ زرد، پایینتر قرمز). RecommendationCardAlternatives صرفاً یک ظرف است؛ نمایش/عدمنمایشش (toggle) با state خودِ صفحه کنترل میشود، نه با پراپی داخلِ خودِ کامپوننت.
دسترسپذیری
- Meter زیرِ RecommendationCardConfidence خودش role="meter" و aria-valuenow دارد.
- دکمهٔ قبول بهطور پیشفرض type="button" است؛ اگر این کارت داخلِ یک form قرار گرفت، submit ناخواسته اتفاق نمیافتد.
مرجع API
RecommendationCardConfidence
| ویژگی | نوع | پیشفرض | توضیح |
|---|---|---|---|
| value | number | — | عددِ ۰ تا ۱۰۰؛ رنگ بر اساسِ آن انتخاب میشود. |
| label | string | "میزانِ اطمینان" | برچسبِ بالایِ نوار. |
RecommendationCardAlternative
| ویژگی | نوع | پیشفرض | توضیح |
|---|---|---|---|
| title | ReactNode | — | عنوانِ گزینه. |
| note | ReactNode | — | نشانِ کوچکِ سمتِ راست (مثلاً «نیازِ به بررسی»). |
| noteTone | "muted" | "warning" | "muted" | رنگِ نشان. |
RecommendationCardActions
| ویژگی | نوع | پیشفرض | توضیح |
|---|---|---|---|
| onAccept | () => void | — | کلیکِ دکمهٔ اصلی. |
| showAlternatives / onToggleAlternatives | boolean / () => void | — | نبودنِ onToggleAlternatives یعنی دکمهٔ «گزینههای دیگر» نمایش داده نمیشود. |
این کامپوننت هنوز برای Vue پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Svelte پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
این کامپوننت هنوز برای Angular پورت نشده است.
نسخهٔ ریاکت آماده است؛ پورت این فریمورک در دست کار است.
نمونهها
Low Confidence
با value کمتر از ۴۰، Meter رنگِ قرمز میگیرد تا هشدارِ بصری بدهد.
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
Without Alternatives
با ندادنِ onToggleAlternatives به RecommendationCardActions، دکمهٔ «گزینههای دیگر» نمایش داده نمیشود.
این نمونه هنوز برای Vue پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Svelte پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
این نمونه هنوز برای Angular پورت نشده است؛ آنچه میبینید نسخهٔ ریاکت است.
کدام نمونه برای کدام موقعیت
| نمونه | کجا به کار میآید |
|---|---|
| Low Confidence | پیشنهادی که عامل نسبت به آن مطمئن نیست |
| Without Alternatives | پیشنهادی که جایگزینِ معناداری ندارد |
دستورالعمل استفاده
میزانِ اطمینانِ پایین را با گزینهٔ جایگزین همراه کن
میخواهی این سفارش را ثبت کنم؟
انجام بده
وقتی اطمینان پایین است، دادنِ گزینهٔ جایگزین به کاربر کمک میکند تصمیمِ بهتری بگیرد.
میخواهی این سفارش را ثبت کنم؟
انجام نده
پیشنهادِ کماطمینان بدونِ هیچ جایگزینی، کاربر را بینِ قبولکردنِ کورکورانه یا ردِ کاملِ پیشنهاد گیر میاندازد.
پیشنهادِ اصلی را یک جمله نگه دار
میخواهی این سفارش را ثبت کنم؟
انجام بده
RecommendationCardPrimary باید در یک نگاه خوانده شود؛ جزئیاتِ بیشتر را در alternatives یا جای دیگر بگذارید.
میخواهی این سفارش را ثبت کنم؟
انجام نده
پاراگرافِ بلند داخلِ کادرِ اصلی، پیام را از حالتِ «یک پیشنهادِ روشن» به یک متنِ گزارش تبدیل میکند.