إطار مُزخرف
حدٌّ زخرفي يحيط بالعناصر، بمثلثاته وخطوطه المتوازية.
حدٌّ زخرفي يحيط بالمحتوى من جهةٍ أو أكثر، بشريطٍ من النقوش ينتهي إن شئتم بـ«الختمة» في طرفيه، كما تُختم الأشرطة على الجدار.
يعرض v0 بنية المكوّن فقط، من دون ألوان قَطّ وخطوطه ونقوشه.
التثبيت
مدير الحزم
@qatt
pnpm dlx shadcn@latest add @qatt/qatt-borderURL
pnpm dlx shadcn@latest add https://asiri-qatt.rifan.xyz/r/qatt-border.jsonالاستخدام
حدّدوا الجهة بالخاصية side. يُرسم الشريط العلوي قائمًا، والسفلي مقلوبًا فتتّجه رؤوس المثلثات نحو المحتوى. واتركوا بين الشريط ومحتوى العنصر مسافةً لا تقلّ عن سماكة الشريط وزيادة 8px.
import { QattBorder } from "@/components/ui/qatt-border"
<QattBorder side="block" caps>
…
</QattBorder>الخصائص
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
side | "top" | "bottom" | "block" | "inline" | "all" | "block" | الجهة: top أو bottom أو block (أعلى وأسفل) أو inline (الجانبان) أو all. والافتراضي block. |
motif | MotifId | "rukun" | نقش الشريط. والافتراضي rukun. |
variant | MotifVariant | — | شكلٌ بديل للنقش إن وُجد: 5 أو alternate أو lattice أو wave. |
colors | QattColor[] | — | ألوان خانات النقش بالترتيب، بأسماء الأصباغ (red وyellow وink…) أو بأيّ لونٍ في CSS. والافتراضي ألوان النقش في motifs.json. |
thickness | "sm" | "md" | "lg" | number | "md" | ارتفاع الشريط: sm بارتفاع 12px، وmd بارتفاع 24px (الافتراضي)، وlg بارتفاع 40px، أو رقم. |
caps | boolean | false | يضع «الختمة» في طرفَي كلّ شريط. والافتراضي false. |
inset | boolean | true | يرسم الشريط داخل العنصر (الافتراضي)، أو خارجه حين يكون false. |
animate | boolean | false | رسمٌ متدرّج للزخرفة عند ظهورها، يبدأ من بداية السطر. ويتوقّف عند تفعيل تقليل الحركة. |
surface | "default" | "gypsum" | "default" | القيمة gypsum تعرض الزخرفة على أرضيةٍ بيضاء كالجصّ بألوانها الفاتحة في الوضعين. وهي لازمةٌ في الصفحات التي تعرض التراث نفسه. |
ملاحظات الاتجاه
الجهات المنطقية والختمات في الطرفين وحركة الرسم كلّها تتبع اتجاه الصفحة. أما رسم النقش نفسه فلا ينقلب.
سهولة الوصول
زخرفةٌ خالصة مخفيّة عن التقنيات المساعدة. والمسافة الداخلية تمنع الشريط من تغطية إطار التركيز للعناصر داخله.