إطار القوس
إطارٌ يحتضن صورةً أو محتوى بارزًا.
إطارٌ يحتضن صورةً أو محتوى بارزًا. هيئته الافتراضية كوّةٌ مستطيلة يحيط بها إطارٌ من خطوطٍ ملوّنة متداخلة كما تُؤطَّر الأبواب والنوافذ في القطّ، وله قاعدةٌ من شريط «الكفّ» وختمتان في زاويتيها. ويمكن أن يكون قوسًا مستلهمًا من نقش «المحاريب» وأقواسه المتداخلة.
نسمّيه في الواجهة «إطار القوس»، فهو مكوّن واجهةٍ عام. وهيئته الافتراضية اليوم الكوّة المستطيلة، والقوس هيئةٌ تختارونها.
يعرض v0 بنية المكوّن فقط، من دون ألوان قَطّ وخطوطه ونقوشه.
التثبيت
@qatt
pnpm dlx shadcn@latest add @qatt/qatt-frameURL
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 مدرّج، وهو إضافةٌ من المشروع. |
outline | 1 | 2 | 3 | 2 | عدد الأقواس المتداخلة: 1 أو 2 (الافتراضي) أو 3. |
colors | QattColor[] | ["red", "ink", "yellow"] | الألوان بالترتيب: القوس الخارجي، فالداخلي، فالقاعدة. |
base | MotifId | false | "kaff" | نقش القاعدة، والافتراضي kaff. واجعلوه false لإطارٍ بلا قاعدة. |
caps | boolean | true | يضع «الختمة» في زاويتَي القاعدة. والافتراضي true. |
ratio | number | 3/4 | نسبة عرض المحتوى إلى ارتفاعه. والافتراضي 3/4. |
caption | ReactNode | — | شرحٌ يُعرض في figcaption تحت الإطار. |
animate | boolean | false | يرسم خطّ القوس تدريجيًا عند ظهوره، ويتوقّف عند تفعيل تقليل الحركة. |
surface | "default" | "gypsum" | "default" | القيمة gypsum تعرض الزخرفة على أرضيةٍ بيضاء كالجصّ بألوانها الفاتحة في الوضعين. وهي لازمةٌ في الصفحات التي تعرض التراث نفسه. |
ملاحظات الاتجاه
الإطار متناظر، فلا شيء فيه ينقلب.
سهولة الوصول
يُبنى على figure وfigcaption، ورسم الإطار مخفيٌّ عن التقنيات المساعدة. أعطوا كلّ صورةٍ نصًّا بديلًا في alt، وضعوا الشرح في caption لا داخل الصورة.