# صورة البانر تنجح أفقياً وتفقد موضوعها على الهاتف: احسب قص cover أولاً

> **الرابط:** https://aiseza.com/524/css-cover-crop-generated-banner-safe-area/
> **الكاتب:** INESSE MOUSBIR
> **النشر:** 2026-11-02
> **آخر تحديث:** 2026-11-02

## الإجابة المختصرة

قد تمتلئ مساحة البانر بالصورة بينما يختفي جزء من موضوعها بسبب اختلاف النسبة. يحسب المثال نافذة cover وموضعها بأعداد كسرية، ويختبر مستطيلاً افتراضياً؛ لا يكتشف الإبريق آلياً ولا يقيس قابلية قراءة العنوان في متصفح. الصورة الأصلية توضح قرار ترك مساحة فارغة قبل تصميم الواجهة.

تُظهر الصورة الأصلية إبريقاً فخارياً برتقالياً في الجهة اليسرى وغصن زيتون يصل إلى حافة الصورة اليسرى، مع حائط فاتح واسع في اليمين. اخترنا هذا التكوين لشرح قرار ترك مساحة لعنوان يضاف في واجهة مستقلة، لا لإثبات أن العنوان عُرض أو قُرئ في هاتف. الملف المحفوظ مقاسه 1536×1024 بكسلاً ولا يحمل حروفاً داخل الصورة. لم يتحقق طلب احتواء الغصن كاملاً داخل الإطار، ولذلك نسجل ما ظهر فعلاً بدلاً من تحويل صياغة الطلب إلى وصف مضمون للمخرج. السؤال العملي التالي هو ما الذي يبقى مرئياً إذا فُرضت على هذا الأصل حاوية بنسبة مختلفة.

## ابدأ بالصورة الأصلية وحدد وظيفة المساحة الفارغة

يعتمد تصميم واجهات الويب في كثير من الحالات على مبدأ تخصيص مساحة سلبية متعمدة لتركيب النصوص البرمجية فوقها لاحقاً عبر طبقات تنسيق مستقلة. حين يُطلب من أداة التوليد إنتاج مشهد يحتوي على فراغ بصري في جانب معين، فإن الهدف الهندسي ليس مجرد إفراغ المساحة من التفاصيل، بل تجهيز منطقة هادئة بصرياً تقل فيها التباينات العالية والظلال المعقدة، لتستقبل تراكيب العناوين دون الحاجة إلى تشويه الصورة الأصلية أو اللجوء إلى معالجات لونية مفرطة. إن ترك النصف الأيمن خالياً كان قراراً تخطيطياً مدروساً لتسهيل وضع عناصر واجهة المستخدم المستقبلية، غير أن هذا الفراغ ذاته يتحول إلى مصدر ارتباك عندما تتغير نسبة أبعاد الإطار الحاوي للصورة.

يستخدم الاختبار مستطيلاً افتراضياً حدوده (120,220,500,900): تبدأ الزاوية عند x=120 وy=220، وتنتهي عند x=500 وy=900. يبلغ عرضه 380 وارتفاعه 680، لأن القيمتين الأخيرتين إحداثيا نهاية وليستا عرضاً وارتفاعاً. لم تُستخرج هذه الحدود من الإبريق، ولا توجد دالة تعرف بصري في المشروع. فائدتها هي إعطاء fully_visible منطقة محددة يمكن مقارنة أطرافها بنافذة القص. يستطيع المطور استبدالها لاحقاً بحدود راجعها لموضوعه الفعلي، لكن نجاح هذا المستطيل في اختبار حسابي لا يتحول تلقائياً إلى قبول للصورة المولدة أو موضع عنوان فوقها.

تنشأ الفجوة الإجرائية الشائعة عندما يتعامل فريق العمل مع الصورة المولدة كلوحة مصمتة جاهزة للاستخدام دون تفكيك علاقتها بإطار العرض النهائي. فالمساحة الفارغة التي تنجح في دعم العنوان العريض على الشاشات العريضة تصبح عبئاً هندسياً حين يُعاد احتساب الإحداثيات لشاشات الهواتف المحمولة الرأسية. إدراك الفارق بين الصورة كما خرجت من أداة التوليد، وبين وظيفتها المتوقعة داخل طبقات العرض المتعددة، يمنع التسرع في افتراض أن ما يبدو متزناً على المستوى الجمالي المجرد سيحافظ تلقائياً على وظيفته عند تغيير نافذة الرؤية أو إعادة توزيع محاور الارتكاز التلقائية.

## افصل عقد أبعاد الأصل عن إطار العرض

يرتكز التعامل الهندسي السليم مع وسائط الويب على التفريق الدقيق بين الخصائص الجوهرية للملف الأصلي والقيود الهيكلية التي يفرضها إطار العرض داخل صفحة الموقع. تمتلك الصورة الأصلية الناتجة عن أداة التوليد أبعاداً ثابتة تبلغ ألفاً وخمسمئة وستة وثلاثين بكسلاً في العرض مقابل ألف وأربعة وعشرين بكسلاً في الارتفاع، بنسبة أبعاد محددة رياضياً بالقيمة ثلاثة إلى اثنين. هذا التكوين البكسلي يمثل عقداً مستقلاً ينتمي حصرياً للملف البياني، حيث تظل وحدات البكسل ثابتة في مواقعها النسبية دون أي اعتبار لنوع الجهاز أو وسيلة الاستعراض المستخدمة لقراءتها. في المقابل، يمثل إطار العرض حاوية تصميم متغيرة تُحدد أبعادها عبر قواعد تنسيق الأنماط المتجاوبة واحتياجات التخطيط العامة للصفحة، وهي مساحة ديناميكية تتبدل قيمها بتغير شاشة المستخدم وظروف التصفح.

تحافظ cover على نسبة أبعاد المحتوى وتملأ إطار العنصر؛ قد يُقص جزء من الصورة عند اختلاف النسبة. [MDN: object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/object-fit)

تظهر المشكلة التقنية عندما يفترض المطور أو المصمم أن العلاقة بين الصورة وإطارها تعتمد على القياس المباشر أو التطابق الهندسي الثابت. فحين يُسند إلى العنصر نمط التغطية عبر خاصية ملء المساحة مع الحفاظ على النسبة، يتحول سلوك العرض إلى معادلة رياضية تبحث عن معامل التكبير الأكبر بين محوري العرض والارتفاع لضمان عدم ترك أي فراغ داخل الإطار النهائي. في هذه اللحظة، لا يكترث الإطار بمحتويات الصورة أو بمكان تموضع الكتلة الفخارية أو المساحة الفارغة؛ بل يكتفي بمطابقة أحد البُعدين وتمديده حتى يمتلئ الحيز تماماً، مما يترتب عليه حتماً خروج الأجزاء الزائدة من البُعد الآخر خارج حدود الرؤية إذا لم تتطابق نسبة أبعاد الحاوية مع نسبة ثلاثة إلى اثنين الخاصة بالأصل.

يظل [الحفاظ على الصفر في الإعدادات](https://aiseza.com/497/python-config-merge-false-zero/) مهماً هنا: الموضع الأفقي 0 اختيار صريح لجهة اليسار، وليس قيمة مفقودة تستبدلها تلقائياً بمنتصف الصورة. صحح نقل الخيار من واجهة المشروع قبل الحكم على معادلة القص.

إن خلط هذا العقد بين معطيات الأصل وحدود الإطار يؤدي إلى تعامل برمجي معيب يُعامل الصورة كأنها تتمدد وتتقلص كوحدة واحدة تضمن بقاء كامل محتواها الداخلي مرئياً. فبينما يرى التخطيط المكتبي مساحة واسعة تسمح بعرض الصورة بكامل اتساعها، فإن تقليص عرض الإطار في الشاشات الضيقة أو تغييره إلى نسب رأسية يغير محور الحساب تماماً. تصبح النسبة الحاكمة للتكبير مرتبطة بارتفاع الحاوية بدلاً من عرضها، وتتحول المساحة المرئية الفعلية إلى نافذة اقتطاع ضيقة تتحرك عبر اللوحة العريضة للأصل، متجاهلة أي ترتيب بصري كان يبدو متوازناً ومستقراً في وضع الشاشة الكاملة على الحاسوب المكتبي.

يتطلب الفصل المنهجي بين العقدين تعريفاً مستقلاً لحدود الملف ولواجهات التنسيق في بيئة العمل. يُوثق الأصل بوصفه قالباً ثابتاً له نسبة مقيدة لا تقبل التفاوض التلقائي، بينما يُعامل إطار الواجهة بوصفه نافذة اقتطاع مشروطة تتطلب احتساباً هندسياً مسبقاً قبل كتابة قواعد التنسيق. هذا التمييز يمنع التعامل مع الاقتطاع كأنه عيب مفاجئ في العرض أو خلل في المتصفح، ويضعه في مكانه الصحيح كنتيجة رياضية حتمية لفرض إطار يختلف في نسبته عن الأصل. بناء هذا العقد المنفصل يمنح الفريق التقني القدرة على توقع المساحات المستبعدة واختبار سلوك النوافذ قبل اتخاذ قرارات التوزيع اللوني وتحديد مناطق وضع النصوص.

### cover_crop.py

```
from fractions import Fraction
from math import isfinite

def cover_window(source, box, position=(0.5, 0.5)):
    if any(not isinstance(v, tuple) or len(v) != 2 for v in (source, box, position)):
        raise ValueError('Expected pairs')
    if any(type(v) is not int or v <= 0 for v in (*source, *box)):
        raise ValueError('Expected positive integer dimensions')
    if any(type(p) not in (int, float) or not isfinite(p) or not 0 <= p <= 1 for p in position):
        raise ValueError('Expected normalized finite positions')
    sw, sh = source; bw, bh = box
    scale = max(Fraction(bw, sw), Fraction(bh, sh))
    width, height = bw / scale, bh / scale
    left = (sw-width) * Fraction(str(position[0]))
    top = (sh-height) * Fraction(str(position[1]))
    return left, top, left+width, top+height

def fully_visible(window, subject):
    left, top, right, bottom = window
    x0, y0, x1, y1 = subject
    return left <= x0 < x1 <= right and top <= y0 < y1 <= bottom

def broken_visible(source, subject):
    # Incorrect application assumption: the entire source always survives cover.
    return fully_visible((0, 0, *source), subject)
```

نطاق التحقق المحلي: تسع طرائق unittest لحساب نافذة cover بمستطيلات اصطناعية وكسور دقيقة. فُحصت النسبة المتساوية وإطار أفقي وإطار هاتف وافتراض الظهور الكامل والموضعان الأيسر والأيمن، مع صفر وقيمة منطقية في الأبعاد وثلاثة مدخلات موضع غير صالحة. لا يشمل الفحص متصفحاً أو CSS فعلياً أو كشف عناصر أو تباين نص أو أداء نموذج. مستطيل الموضوع افتراضي؛ البيئة Python 3.12.3 على Windows.

## تتبع النافذة الأفقية ثم نافذة الهاتف بالأرقام

في الحالة الأفقية يكون الأصل 1536×1024 والإطار 1200×400. يختار الكود القيمة الأكبر بين 1200/1536 و400/1024 لمعامل القياس، فتكون 25/32. وبالرجوع إلى إحداثيات الأصل، تظهر نافذة بعرض 1536 وارتفاع 512. عند التمركز الرأسي يبقى هامش مقداره 256 فوق النافذة ومثله تحتها؛ لذلك تصبح الحدود (0,256,1536,768). يحافظ هذا المثال على العرض كاملاً لكنه يقص أعلى الأصل وأسفله. لا يعني ذلك أن موضوعاً بعينه يظل كاملاً: إذا امتد خارج المجال الرأسي المحدد، فسوف ينقطع ولو لم يُقص أي جزء من عرض الصورة.

في إطار الهاتف الافتراضي 360×640 يصبح معامل القياس 5/8، لأن نسبة الارتفاع هي الأكبر. تظهر نافذة من الأصل عرضها 576 وارتفاعها 1024. يبقى فرق أفقي مقداره 960 بين عرض الأصل وعرض النافذة؛ وعند الموضع 0.5 يوزع الفرق بالتساوي، فتبدأ النافذة عند 480 وتنتهي عند 1056. حدودها إذن (480,0,1056,1024)، كما يقارنها test_phone_center حرفياً. لا يغير هذا الحساب بايتات الصورة ولا يولد ملف هاتف جديداً؛ إنه نتيجة هندسية لإطار مفترض، تساعد على معرفة أي إحداثيات تستبعد قبل تنفيذ واجهة حقيقية.

تُظهر متابعة هذه الإحداثيات بالأرقام الدقيقة سبباً واضحاً لفقدان الموضوعات البصرية لتركيزها الأساسي عند تغيير الجهاز المستخدم لعرض الصفحة. إن افتراض بقاء العناصر المكونة للمشهد في مكانها الافتراضي بغض النظر عن تغير الأبعاد هو خطأ هندسي شائع في مرحلة التطوير البرمجي. لا يكفي الاعتماد على السلوك التلقائي لأوامر التنسيق المرن دون حساب مسبق لموضع المحور المركزي، لأن أي انحراف بسيط في نسبة العرض إلى الارتفاع يغير مساحة النافذة المقتطعة بشكل يجعلها تتجاوز نطاق العناصر الهامة. تتطلب معالجة هذا التفاوت إدراكاً رياضياً لكيفية تحرك نافذة العرض فوق الأصل، وتحديد ما إذا كان الهامش الفارغ الموجود في أحد الجانبين سيتحمل ضغط الاقصاص أو ما إذا كان سيتم توجيه المحور نحو نقطة اهتمام محددة.

تؤكد الحسابات الدقيقة المطبقة على هذه النماذج أن التعامل مع مقاسات الشاشات المختلفة ليس مجرد تعديل شكلي بسيط، بل هو إعادة هندسة لمسار الرؤية ضمن حدود الملف الأصلي. فعندما يتحرك إطار الهاتف ليمسح منطقة وسطية محددة، فإنه يعزل أجزاء مكانية معينة ويهمل أخرى كانت تملأ الفراغ في النسخة المكتبية العريضة. هذا التتبع الحسابي يمنح المطور القدرة على تقييم سلوك واجهة المستخدم مسبقاً، واكتشاف مناطق البتر المحتملة قبل رفع الملفات إلى بيئة التشغيل الفعلية، مما يقلل الاعتماد على التخمين البصري العشوائي ويضع قرار التصميم على أسس رقمية قابلة للاختبار والتحقق المستمر.

## حوّل اختيار الموضع إلى قرار محتوى واضح

عندما ينتقل المصمم من تثبيت نسبة العرض الافتراضية إلى تحديد إحداثيات الإزاحة الدقيقة عبر خصائص المحاذاة، فإنه يتجاوز مجرد الضبط التقني ليدخل في صميم صياغة المحتوى البصري. إن خاصية ضبط الموضع تحدد النقطة الارتكازية التي تدور حولها عملية الاقتصاص، مما يجعلها أداة توجيه استراتيجية وليست مجرد قيمة رقمية عشوائية. إذا ترك المطور الإعدادات على حالتها الافتراضية المركزية، فإن نافذة العرض الضيقة ستقتطع أطراف الصورة بشكل متساوٍ من الجانبين، وهو ما قد يؤدي إلى ضياع التركيز الأساسي للمشهد إذا كان الموضوع يقع في أحد الأجزاء الجانبية من الملف الأصلي.

لا يضمن تحريك الموضع الاحتفاظ بأي موضوع وفي كل نسبة. في مثالنا يستطيع مستطيل عرضه 380 أن يقع داخل نافذة الهاتف البالغ عرضها 576، لكن ذلك يعتمد أيضاً على موضعه الرأسي والأفقي. عند اختيار اليسار تصبح النافذة (0,0,576,1024)، فيقع المستطيل الافتراضي بكامله داخلها. أما مستطيل أعرض من النافذة فلن يصبح مرئياً كاملاً بمجرد تغيير الموضع. ولهذا ينبغي استعمال نتيجة المقارنة كشرط هندسي محدود، ثم اتخاذ قرار منفصل بشأن التكوين والعنوان، بدلاً من وصف قيمة موضع واحدة بأنها حل شامل لكل صورة.

تُظهر الحسابات البرمجية لتحديد النطاق أن تغيير القيمة النسبية للموضع من المنتصف إلى الحافة يزيح نافذة العرض بكامل مساحتها نحو الاتجاه المحدد، مما يغير بشكل كامل الأجزاء التي تظهر للمستخدم على الشاشات الصغيرة. على سبيل المثال، عندما تُضبط الإحداثيات على القيمة الصفرية للأفق، فإن النافذة تستقر في أقصى اليسار، محتفظة بما يقع في تلك المنطقة ومستغنية تماماً عن المساحات الفارغة الموجودة في اليمين. هذا السلوك يبرز أهمية اتخاذ قرار واعٍ بشأن مكان تركيز العين، بدلاً من ترك الأمر للبرمجيات التلقائية التي قد تختار عشوائياً أجزاء تفقد الصورة دلالتها.

يوضح الاختيار المقابل، أي الموضع الأفقي 1، حدود الموازنة: تصبح نافذة الهاتف (960,0,1536,1024). إنها نافذة مختلفة فعلاً عن نافذة اليسار، وليست نسخة أخرى من المخرج نفسه. إذا كان الموضوع قرب اليسار فقد تحافظ هذه النافذة على منطقة فارغة وتستبعد الموضوع بدلاً من ذلك. وإذا كان العنوان خارج الصورة فلا يمكن حساب تداخله من هذه الأرقام وحدها، لأن الكود لا يستقبل مستطيل النص. القرار المقترح في مثل هذه الحالة هو اختبار توزيع العنوان أسفل الصورة أو تغيير الإطار؛ لم ينفذ المشروع تخطيطاً مرئياً يثبت أحد الخيارين.

## اقرأ الاختبارات التسعة وحدود المستطيل الافتراضي

تعتمد عملية التحقق البرمجي على مجموعة محددة من الاختبارات الوحدية التي تقيس أبعاد النوافذ الناتجة بدقة متناهية، دون أن تمتد لتشمل تقييم الجوانب البصرية الشاملة مثل التباين اللوني أو سهولة قراءة العناوين داخل المتصفحات الحقيقية. يتكون هذا الإطار الاختباري من تسع طرائق برمجية تستخدم حسابات الكسور الرياضية الدقيقة لتحديد إحداثيات الاقتصاص، مما يضمن خلو النتائج الحسابية من أخطاء التقريب الناتجة عن الأعداد العشارية العادية. يتمثل الدور الأساسي لهذه الاختبارات في التأكد من صحة التعامل مع مختلف نسب الأبعاد بين الأصل والعرض، مع فرض شروط صارمة على القيم المدخلة لضمان استقرار الخوارزمية البرمجية في معالجة المدخلات الرقمية الصحيحة حصراً.

يعمل الاختبار الأول على مطابقة الأبعاد الأصلية مع إطار العرض بنفس النسبة، مما يثبت أن الخوارزمية تحافظ على الأبعاد دون أي تعديل أو تحريف يذكر، حيث تعود النتيجة مطابقة تماماً للمقاسات الأصلية للصورة. في المقابل، تختبر الحالات الأخرى نوافذ عرض مختلفة مثل الشاشات الأفقية الواسعة وشاشات الهواتف المحمولة ذات النسبة العمودية الضيقة. عند تطبيق مقاس الهاتف الافتراضي على الصورة ذات الأبعاد العريضة، تتطلب عملية التعبئة الكاملة قص أجزاء كبيرة من الجانبين، وهنا يتضح الفارق الجذري بين الافتراض الخاطئ ببقاء الصورة كاملة وبين الواقع الرياضي لعملية الاحتواء المعتمدة على اختيار القيمة الأكبر لمُعامل التحجيم.

يعرض test_broken_assumption الفرق المقصود بين النهجين. يفحص broken_visible المستطيل داخل حدود الأصل الكامل فيعيد True، بينما يفحصه النهج المصحح داخل نافذة الهاتف المركزية فيعيد False. ثم يثبت test_left_position أن الموضع الأيسر يبقي ذلك المستطيل الافتراضي المحدد كاملاً. لا تعني هذه النتيجة أن التطبيق اكتشف موضوع الصورة أو اختار موضعه الأمثل. إنها تمنع افتراضاً برمجياً واحداً: صلاحية المستطيل داخل الأصل لا تكفي لإثبات بقائه بعد cover. يستطيع مشروع آخر أن يستعمل المدخل نفسه مع إطار جديد ليتحقق من الشرط نفسه قبل اعتماد العرض.

توزع الاختبارات الأخيرة على مدخلات محددة. يرسل test_zero_dimension عرضاً صفرياً، ويرسل test_boolean_dimension القيمة True بدلاً من عرض صحيح، ويتوقع كلاهما ValueError. يجرب test_position_bounds ثلاثة أزواج تحتوي على 1.1 أو NaN أو قيمة منطقية. يفحص الكود شروطاً أخرى أيضاً، لكن وجود الشرط في المصدر لا يعني أن كل مدخل محتمل شُغل. كذلك لا تتحقق fully_visible من صحة كل مستطيل يصل إليها؛ نفترض هنا إحداثيات موثوقة ومرتبة. الفصل بين ما ترفضه الدالة وما غطته التأكيدات فعلاً يجعل توسيع مجموعة الفحص لاحقاً قراراً واضحاً.

يؤكد هذا التصميم الاختباري على أهمية الفصل التام بين الحسابات الرياضية البحتة والاعتبارات الجمالية أو التفسيرات البصرية للمحتوى. فعندما نختبر قيم الموضع الصفرية أو الكاملة، فإننا نحدد هندسياً مسار الإزاحة الأفقية والعمودية، لكننا لا نضمن بالضرورة أن يحقق هذا الموضع التوازن الفني المطلوب دون معاينة بصرية بشرية مستقلة. يساعد هذا الوضوح التقني فرق العمل على تحديد أدوار البرمجيات بكونها أدوات حسابية دقيقة لتنفيذ النطاقات، وليست بدائل لاتخاذ قرارات التصميم الإبداعي المتعلقة بمكان وضع العناصر وتوزيع المساحات الفارغة.

تتيح object-position اختيار موضع الصورة داخل إطارها، والقيمة الابتدائية هي 50% 50%. [MDN: object-position](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/object-position)

## صمم طبقة العنوان كواجهة مستقلة عن الصورة

اخترنا في هذا المشروع أن يبقى العنوان نصاً في الواجهة، لأن الهدف هو إمكان تغيير محاذاته وحجمه دون إعادة توليد الصورة أو إعادة كتابة الحروف داخلها. هذا اختيار يناسب البانر المقترح، وليس قاعدة تقول إن كل صورة تتضمن نصاً ستفشل على الشاشات. يمكن أن يكون النص المدمج مناسباً لمخرج آخر له قياسات ثابتة. أما هنا ففصل الطبقتين يتيح تجربة توزيع مستقل للنص مع إبقاء الإبريق والخلفية في ملفهما الأصلي. تظل صلاحية النتيجة مسألة تحتاج فحص التخطيط؛ فمجرد الفصل في المصدر لا يثبت أن العنوان لن يتداخل مع الصورة.

في تكامل مقترح يمكن تحديد عنصر حاوٍ للصورة وعنصر مستقل للعنوان، ثم اختيار هل يعلو النص الصورة أم يظهر بجانبها أو تحتها. عند عرض الهاتف لا ينبغي افتراض أن الفراغ الذي رأيناه في اليمين بقي موجوداً بعد القص، بل يعاد النظر في النافذة المحسوبة وفي مساحة النص الفعلية. يسمح النص الحقيقي بتغيير الخط واللغة والمحاذاة من الواجهة، لكن الكود المعروض لا يقيس تباين الألوان أو حجم الحروف أو قابليتها للنسخ أو القراءة بأداة مساعدة. تلك خصائص للواجهة المقترحة تتطلب اختبارات تخصها، وليست نتائج لاختبارات Fraction التسعة.

تظهر الحاجة الملحة لهذه الاستقلالية بوضوح عند تتبع سلوك العناصر في بيئات العمل الحقيقية، حيث تؤدي التغييرات المستمرة في دقة الشاشة إلى تحرك حدود الاقتصاص الخاصة بخاصية التغطية المتمثلة في التمدد والملء. إذا اعتمد المصمم على افتراض أن النص سيبقى دائماً في مكان محدد ضمن مساحة الصورة، فسوف تفشل هذه الفرضية بمجرد أن يتم تطبيق الاقتصاص الأفقي أو العمودي على الشاشات الأصغر حجماً، مما يبرز أهمية بناء طبقة النصوص ككائن برمجي مستقل يستجيب لخصائص التنسيق المرن بدلاً من اعتباره جزءاً ثابتاً لا يتجزأ من الملف البصري. يتيح هذا النهج للمطورين التحكم الكامل في محاذاة العناوين وتغيير أحجام خطوطها وفقاً لمقاييس نافذة العرض الفعلية، مع الحفاظ على سلامة الصورة الأصلية وخصائصها الهندسية دون تشويه أو فقدان للمعلومات البصرية الأساسية التي تتضمنها.

## اختر بين أصل إضافي وتغيير الإطار بدلاً من إعادة الطلب عشوائياً

يتطلب التعامل مع مشكلات قص الصور الناتجة عن اختلاف نسب الأبعاد بين الشاشات الكبيرة والهواتف المحمولة فهماً دقيقاً لطبيعة الموارد البصرية المستخدمة في الواجهات الرقمية. عندما تظهر نتائج غير متوقعة بسبب تطبيق قواعد التغطية، يميل البعض إلى محاولة تعديل الإعدادات البرمجية مراراً وتكراراً أو إعادة توليد الصورة الأصلية بشكل عشوائي للوصول إلى النتيجة المنشودة. غير أن هذا النهج العشوائي يؤدي غالباً إلى إهدار الوقت وإدخال تعديلات غير مستقرة لا تعالج الجذر الهندسي للمشكلة المتمثل في تباين نسب العرض والارتفاع بين الأصول البصرية ومساحات العرض المتاحة.

يمكن اقتراح أصل رأسي إضافي إذا كانت نسبة الهاتف ثابتة ومهمة للمشروع، أو تغيير الحاوية الحالية إذا كانت المحافظة على الصورة كاملة أولى من ملء المساحة. يختار الفريق بينهما وفق المهمة التي يريد إنجازها، لا وفق وعد بأن ملفاً رأسياً سيصلح لكل جهاز. لم نولد أصلاً ثانياً ولم نقارن نتائج تصميمين في متصفح. ما لدينا هو صورة أفقية فعلية وحساب لنوافذ محددة. قبل طلب صورة أخرى، اكتب القياس الذي تعذر فيه الجمع بين الموضوع والمساحة المطلوبة، حتى تكون المحاولة التالية استجابة لقيد معروف لا إعادة عشوائية للمشهد.

عند اتخاذ القرار بتغيير الإطار بدلاً من استبدال الأصل، يجب دراسة تأثير هذا التغيير على باقي مكونات الصفحة باستخدام النماذج الرياضية المعتمدة مثل الدوال التي تحسب حدود النوافذ والأبعاد النسبية. تتيح هذه الحسابات الدقيقة للمهندسين معرفة المساحات التي ستتعرض للاقتصاص الفعلي قبل كتابة أي كود برمجي نهائي، مما يقلل من احتمالية ظهور أخطاء بصرية مزعجة عند تشغيل الواجهة في بيئات حقيقية. إن الاعتماد على هذه الإجراءات الحسابية الثابتة يوفر أساساً موضوعياً لتقييم الأداء البصري بعيداً عن التخمين البصري البحت.

## احفظ عقد التسليم بين المصمم والمطور

يبدأ عقد التسليم المقترح بالحقائق المتاحة: ملف أصلي 1536×1024، وإطارات اختبار محددة، وقيمة موضع لكل إطار. يضاف قرار الواجهة الخاص بمكان العنوان، مع توضيح أن موضع الموضوع الحقيقي لم يُقس آلياً في المشروع. يستطيع المطور إعادة حساب النوافذ من هذه المدخلات، ويستطيع المصمم فحص ما إذا كان التكوين المقترح يحقق مهمته. لا يتضمن العقد وعداً بأن التوثيق سيمنع كل اختلاف؛ بل يتيح تفسير أي اختلاف يظهر لاحقاً دون الخلط بين بايتات المصدر وقرارات العرض.

اجعل عقد التسليم يتضمن أبعاد الأصل، والإطار المقصود لكل حالة، وقيم الموضع، وسبب اختيارها، وهل حدود الموضوع مقاسة فعلاً أم مفترضة. في هذا المثال يجب وسم المستطيل بأنه افتراضي، حتى لا يستعمله مطور لاحق كأنه كشف آلي للإبريق. ويحدد العقد أيضاً ما إذا كان العنوان سيبقى فوق الصورة أو ينتقل إلى حيز مستقل، وما الفحص المرئي المطلوب قبل الإطلاق. وجود هذه الحقول يساعد على مراجعة القرار، لكنه لا يضمن مطابقة كل شاشة لرؤية المصمم أو نجاح الأداء. تظل الواجهة النهائية غير منفذة ضمن هذا الاختبار الحسابي.

توصي إرشادات طلب الصور بتحديد الموضوع والتكوين والقيود وفحص المخرج بعد التوليد. [OpenAI official image prompting guidance](https://developers.openai.com/api/docs/guides/image-prompting)

## أعد تشغيل المثال مع الاختبارات الأصلية

احفظ وحدة الدوال والملف test_example.py في مجلد مشروع واحد، ثم شغّل unittest discover من بيئة Python التي تتضمن المكتبات المذكورة. الاختبارات أدناه هي المصدر الأصلي الذي شُغل في السجل المحلي، وتعرض المدخلات والتأكيدات بدلاً من مطالبتك بالثقة في وصف النتيجة وحده. المسارات التنفيذية تختلف من جهاز لآخر؛ المهم أن يستورد ملف الفحص وحدة الدوال المجاورة له. لا تنقل نسخة أخرى تحمل الاسم نفسه إلى مسار الاستيراد، حتى لا تقارن نتائج برنامج مختلف بالكود المعروض هنا.

```
import unittest
from fractions import Fraction
from cover_crop import cover_window,fully_visible,broken_visible
class CoverTests(unittest.TestCase):
 def test_same_ratio(self):self.assertEqual(cover_window((1536,1024),(768,512)),(0,0,1536,1024))
 def test_wide_center(self):self.assertEqual(cover_window((1536,1024),(1200,400)),(0,256,1536,768))
 def test_phone_center(self):self.assertEqual(cover_window((1536,1024),(360,640)),(480,0,1056,1024))
 def test_broken_assumption(self):
  subject=(120,220,500,900);self.assertTrue(broken_visible((1536,1024),subject));self.assertFalse(fully_visible(cover_window((1536,1024),(360,640)),subject))
 def test_left_position(self):self.assertTrue(fully_visible(cover_window((1536,1024),(360,640),(0,0.5)),(120,220,500,900)))
 def test_right_edge(self):self.assertEqual(cover_window((1536,1024),(360,640),(1,0.5)),(960,0,1536,1024))
 def test_zero_dimension(self):
  with self.assertRaises(ValueError):cover_window((0,1024),(360,640))
 def test_boolean_dimension(self):
  with self.assertRaises(ValueError):cover_window((True,1024),(360,640))
 def test_position_bounds(self):
  for position in [(1.1,0.5),(float('nan'),0.5),(True,0.5)]:
   with self.subTest(position=position),self.assertRaises(ValueError):cover_window((1536,1024),(360,640),position)
```

تعمل حالات الظهور على قيم إحداثية محددة داخل الملف، ولذلك اجعل أول إعادة تشغيل مقتصرة على البيانات المعروضة قبل تغيير الأبعاد. بعد الحصول على النتائج نفسها، يمكن اقتراح تغيير صندوق واحد وملاحظة أي تأكيد يحتاج إلى تحديث. لا تعدل القيمة المتوقعة فقط لإخفاء فشل: احسب معامل القياس ومقدار الجزء المرئي والفرق الذي توزعه قيمة الموضع أولاً. إذا كان المستطيل أكبر من النافذة في أحد المحورين، فلن ينجح شرط الاحتواء الكامل مهما بدا الموضع مناسباً. وإذا كانت النتيجة الحسابية صحيحة لكن المشهد غير صالح للعنوان، فقد انتقلت إلى سؤال التصميم الذي لا تجيب عنه هذه الدالة. هذا الفصل يجعل الفشل نفسه معلومة عن نوع العمل المطلوب، بدلاً من إعادة توليد الصورة على أمل تغير النتيجة الرياضية.

تعبر حدود النافذة في مخرجات الدالة عن إحداثيات داخل الأصل، لا عن مواضع نهائية لوحدات CSS داخل الشاشة. مثلاً، العدد 480 في نافذة الهاتف هو مقدار الجزء المستبعد من يسار المصدر قبل القياس. لا تنقله مباشرة إلى object-position بوصفه إزاحة 480px في الواجهة؛ فقيمة الموضع في مثالنا نسبة مطبعة بين صفر وواحد. عند تفسير النتيجة، سمّ مساحة الإحداثيات التي تستعملها: أبعاد ملف المصدر أم إطار العنصر بعد القياس. يساعد هذا التمييز على تجنب خطأ جديد يحدث إذا كانت معادلة القص صحيحة ثم استعملت أرقامها في طبقة أخرى بمعنى مختلف.

أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعات آلية. شُغلت الشيفرة الأصلية محلياً ضمن نطاق الاختبارات المسجل. الصورة الرئيسية توضيحية، وليست تصويراً ميدانياً أو لقطة لنتيجة اختبار في هاتف أو متصفح.

## المصادر

- [MDN: object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/object-fit)
- [MDN: object-position](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/object-position)
- [OpenAI official image prompting guidance](https://developers.openai.com/api/docs/guides/image-prompting)
