دليل بناء موقع
كيف بنينا تصوّر موقع أنكل أوساكا
من خبّازين مرسومين لقطعة تشيز كيك مختومة. رح تشوف كيف ربطنا الحركة بالتمرير، وكيف تقدر تطبّق الفكرة على موقعك.
أحمد رصاص · المشروع تصوّر مستقل باللغتين. خطوات الطلب فيه للعرض.
حمّل الدليل بالعربي (PDF) شوف دراسة المشروع
جرّب الكشف خطوة بخطوة
حرّك المؤشر من 0% لـ100% وبعدين رجّعه. نفس الرقم بيرسم نفس الحالة بكل اتجاه. افتح المثال حتى تجرّب الفكرة بتمرير الصفحة وتعدّل الملف بنفسك.
رتّب رحلة الصفحة قبل الحركة
رسمنا مسار الصفحة قبل ما نبني المشهد. الزائر بشوف الهوية، بعدها المنتج، وبعدين بصير يقدر يتصفّح المنيو.

- مخطّط الصفحة
- بلّش بمشهد الخبّازين، وبعده التشيز كيك. خصّص مشاهد للماتشا والقهوة والبوبا، وخلي البطاقات والمنيو تفاصيل يقدر الزائر يوصل إلها بسرعة.
- المشهد والبيانات
- ملف src/chapters.js بجمع تعريف الفصول وترتيبها. ملف src/data.js فيه بيانات المنيو. ملف src/home.js بركّب الصفحة. هيك بتقدر تغيّر عرض الفصل والمنتجات كل واحد من مكانه.
- طبّقها على موقعك
- ارسم أربع خانات: أول مشهد، أول منتج، طريقة التصفّح، والخطوة الأخيرة. اكتب تحت كل خانة شو لازم يقدر الزائر يفهم أو يعمل فيها.
قبل ما تضيف حركة، جرّب توصل للمنيو من رابط مباشر بالكيبورد.
افصل الرسمة عن طبقة المنتج
الرسمة ما كانت فيديو جاهز. المشهد فيه خلفية، حركة منفصلة للأذرع والأصابع، وصورة للتشيز كيك بتظهر من تحت القناع.


- تحضير الطبقات
- حضّر الخلفية وطبقة المنتج بنفس النسبة، وخلي العناصر اللي لازم تتحرّك منفصلة. جهّز لكل مشهد صورة ثابتة بتركيب واضح.
- توقيت الكشف
- إيدين الخبّازين بقرّبوا، والضو بتتبّع نقطة التقاء الأصابع. فتحة بحواف غير منتظمة بتكبر من نقطة الالتقاء، وبتفرجي الكيك من الطبقة اللي تحت.
- أين بتلاقي المنطق
- في المشروع الفعلي، src/scene.js بيجمع مشهد Three.js. ملفات hero-hand-rig.js وhero-relief.js وhero-reveal.js بتوزّع شغل حركة الإيدين، وبناء المجسّم، وطبقة الكشف.
افحص ثلاث صور ثابتة للمشهد. البداية، نقطة التقاء الأصابع، والمنتج بعد الكشف. لازم عينك تعرف وين تروح بكل واحدة.
اربط الحركة برقم بين 0 و1
المشهد بيقرأ موقعه أثناء التمرير. إذا رجعت لنفس النقطة بالصفحة، بترجع لنفس وضعية المشهد.
- احسب المسافة
- مسافة التمرير داخل الفصل تساوي ارتفاع الفصل ناقص ارتفاع المشهد المثبّت. اقسم المسافة اللي مشيتها عليها، واحصر النتيجة بين صفر وواحد.
- حدّد مجال الكشف
- في التمرين بيبلّش القناع بعد 35% وبيكتمل عند 85%. جرّب تغيّر الأرقام وشوف كيف بتتغيّر مدة الكشف.
- سكّرول المتصفّح
- خلي الصفحة تستقبل تمريرها العادي. المثال بيجمع تحديثات التمرير بإطار رسم واحد. بالدليل الأصلي للمشروع، scroll-controller.js بينظّم التنقّل والانتقال للفصول.
const clamp = n => Math.max(0, Math.min(1, n));
const distance = chapter.offsetHeight - stage.offsetHeight;
const travelled = -chapter.getBoundingClientRect().top;
const progress = clamp(travelled / Math.max(1, distance));
const reveal = clamp((progress - .35) / .5);
stage.style.setProperty('--radius', reveal * 115 + '%');ارجع من آخر الفصل لأولّه. لازم كل حالة تنعكس، وتقدر توقف بأي نقطة من غير ما المشهد يكمّل لحاله.
من مشهد المنتج للمنيو
المشهد بعرّفك على فئة الحلويات أو المشروبات. بطاقات المنيو بعدها بتسهّل عليك تلاقي الصنف وتقرأ تفاصيله.


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

- نقطة التركيز
- راجع الكادر قبل الحركة، عند التقاء الأصابع، وبعد الكشف. جرّب عرض 320 و390 بكسل وتأكد إن العناصر المهمة ظاهرة، مع الاتجاه من اليمين لليسار.
- الصورة الثابتة أولاً
- اعرض صورة بديلة إذا تأخّر تجهيز المشهد. حمّل المشهد القريب باتجاه التمرير، واختبر الرجعة كمان حتى ما تظهر ومضة أو صفحة فاضية.
- وضع تقليل الحركة
- احترم prefers-reduced-motion. خلّي صورة المنتج وعناوين الفصول وروابط المنيو واضحة من أول تحميل حتى بدون حركة أو WebGL.
جرّب اتصال بطيء، وبعدين انزل واطلع بسرعة. راقب إذا ظهر فراغ أو انقصّ عنوان أو تعلّق التمرير.
نفّذ نسخة اختبار خاصة فيك
ابدأ بملف المثال وافتحه بالمتصفّح. لما تشتغل الحركة على فصل واحد، ضيف محتوى ومنيو تدريجياً.
- ابنِ تجربة قصيرة
- بدّل الرسم وصورة المنتج بمواد عندك حق استخدامها. جرّب تحرّك نقطة الكشف مع تغيير أحجام الشاشة. اكتب تحت المشهد وصف للمنتج ورابط للفصل اللي بعده.
- افحص الأداء والوصول
- جرّب تمرير سريع، تمرير عكسي، تكبير 200%، تنقّل بالكيبورد، وتقليل الحركة. سكّر JavaScript مؤقتاً وشوف إذا المعلومات والروابط بعدها موجودة.
- راجع النسخة قبل المشاركة
- قارن اللابتوب والموبايل، العربي والإنجليزي. افحص وضوح النص وتباين الألوان وظهور أول صورة. إذا عندك طلب تجريبي، وضّح هالشي عند الزر.
مقياس إنك خلصت: زائر بيقدر يشوف المنتج ويفتح تفاصيله ويعرف الخطوة الجاية حتى لو كانت الحركة مطفّية.