تخطَّ إلى المحتوى
قَطّ

إطار القوس

إطارٌ يحتضن صورةً أو محتوى بارزًا.

إطارٌ يحتضن صورةً أو محتوى بارزًا. هيئته الافتراضية كوّةٌ مستطيلة يحيط بها إطارٌ من خطوطٍ ملوّنة متداخلة كما تُؤطَّر الأبواب والنوافذ في القطّ، وله قاعدةٌ من شريط «الكفّ» وختمتان في زاويتيها. ويمكن أن يكون قوسًا مستلهمًا من نقش «المحاريب» وأقواسه المتداخلة.

نسمّيه في الواجهة «إطار القوس»، فهو مكوّن واجهةٍ عام. وهيئته الافتراضية اليوم الكوّة المستطيلة، والقوس هيئةٌ تختارونها.

Open in v0

يعرض v0 بنية المكوّن فقط، من دون ألوان قَطّ وخطوطه ونقوشه.

التثبيت

مدير الحزم

@qatt

pnpm dlx shadcn@latest add @qatt/qatt-frame

URL

pnpm dlx shadcn@latest add https://asiri-qatt.rifan.xyz/r/qatt-frame.json

الاستخدام

ضعوا فيه صورةً لها نصٌّ بديل، أو محتوىً قصيرًا. في هيئة الكوّة يُقصّ المحتوى على المستطيل الداخلي، وفي هيئات القوس على القوس الداخلي. واجعلوا outline=\{3\} لثلاثة أقواسٍ متداخلة على طريقة «سنكرولي». والهيئة stepped إضافةٌ من المشروع، فاذكروا ذلك حيث تعرضونها.

import { QattFrame } from "@/components/ui/qatt-frame"

<QattFrame caption="…">
  <img src="…" alt="…" />
</QattFrame>

الخصائص

الخاصيةالنوعالافتراضيالوصف
shape"niche" | "pointed" | "round" | "stepped""niche"الهيئة: niche الكوّة المستطيلة (الافتراضي)، أو قوسٌ pointed مدبَّب، أو round مستدير، أو stepped مدرّج، وهو إضافةٌ من المشروع.
outline1 | 2 | 32عدد الأقواس المتداخلة: 1 أو 2 (الافتراضي) أو 3.
colorsQattColor[]["red", "ink", "yellow"]الألوان بالترتيب: القوس الخارجي، فالداخلي، فالقاعدة.
baseMotifId | false"kaff"نقش القاعدة، والافتراضي kaff. واجعلوه false لإطارٍ بلا قاعدة.
capsbooleantrueيضع «الختمة» في زاويتَي القاعدة. والافتراضي true.
rationumber3/4نسبة عرض المحتوى إلى ارتفاعه. والافتراضي 3/4.
captionReactNode—شرحٌ يُعرض في figcaption تحت الإطار.
animatebooleanfalseيرسم خطّ القوس تدريجيًا عند ظهوره، ويتوقّف عند تفعيل تقليل الحركة.
surface"default" | "gypsum""default"القيمة gypsum تعرض الزخرفة على أرضيةٍ بيضاء كالجصّ بألوانها الفاتحة في الوضعين. وهي لازمةٌ في الصفحات التي تعرض التراث نفسه.

ملاحظات الاتجاه

الإطار متناظر، فلا شيء فيه ينقلب.

سهولة الوصول

يُبنى على figure وfigcaption، ورسم الإطار مخفيٌّ عن التقنيات المساعدة. أعطوا كلّ صورةٍ نصًّا بديلًا في alt، وضعوا الشرح في caption لا داخل الصورة.

في هذه الصفحة