
كيف بنينا موقع
من شبّاك عمّان؟
دليل عملي لبناء موقع عربي بيتحرّك مع التمرير. جرّب كيف بنطلع من الشبّاك وكيف بتظهر خزنة البترا، وشوف ليش البطاقات لحالها بتمشي بالعرض.

ابنِ الحكاية قبل الحركة
بلّش بخطّ الرحلة: عمّان، جرش، البحر الميت، البترا، وادي رم، والعقبة. الشبّاك بداية الحكاية، وصحن المنسف نهايتها. جهّز لكل محطة مشهد، وقصّة قصيرة، وبطاقات قبل ما تحرّك أي إشي.
الموقع مبني بـVite وJavaScript. الأوامر تحت بتجهّز صفحة فاضية على نسخة مدعومة من Node.js. استخدم خريطة الملفات عشان تكملها، أو شغّل npm ci إذا ملفات المشروع عندك. بالموقع الأصلي، src/render.js بركّب بيانات المحطات بصفحة HTML.
حدّد لغة الصفحة واتجاهها بـlang="ar" dir="rtl". خلّي النص العربي بالصفحة والشعار SVG، واستخدم Alexandria للقراءة وAref Ruqaa للملاحظات المكتوبة بخط اليد. صدّر المشاهد بطبقات WebP منفصلة.

# Starting from an empty folder
npm create vite@latest amman-scroll -- --template vanilla
cd amman-scroll
npm install
npm install gsap lenis @fontsource/alexandria @fontsource/aref-ruqaa
npm run dev
# Project layout
# index.html — intro, hero, navigation
# src/content.js — chapter data
# src/render.js — chapter markup
# src/intro.js — window canvas
# src/main.js — motion and navigation
# src/style.css — layers and transitions
# public/img/ — original visual layersطلّع القارئ من الشبّاك
القسم طويل عشان يعطي اللقطة مجال تتحرّك، والمشهد ثابت من جوّاه بارتفاع الشاشة. طبقة Canvas بترسم السما والتلال والغيم والتكسي. فوقها طبقة ثانية بترسم الغرفة والإطار. مكان الزجاج بالصورة شفّاف عشان تشوف العالم اللي وراه.
حوّل مسافة التمرير جوّا القسم لقيمة من صفر لواحد. كبّر باتجاه الزجاج تكبير أُسّي، وخلّي كل طبقة تتحرّك بسرعة، وبعدين خفّف ظهور الغرفة والإطار. آخر لون بالسما بقابل ألوان مشهد عمّان بالليل، فبتكمل اللقطة بدون قطْعة واضحة.
جرّب الطبقات والحركة الفعليّة تحت. هون المؤشّر بتحكّم بنفس قيمة التقدّم اللي التمرير بتحكّم فيها بالموقع الأصلي.
// Abridged from src/intro.js
const span = sectionHeight - stageHeight;
const p = span > 0
? Math.min(1, Math.max(0, (scrollY - sectionTop) / span))
: 0;
const r = ease(clamp((p - 0.02) / 0.58));
const zoom = Math.exp(Math.log(zMax) * r);
const scale = base * zoom;اعطِ كل محطة مشهدها
خلّي الحركة على ساعة واحدة: GSAP بشغّل Lenis ورسم الشبّاك، وLenis بمرّر تحديثات التمرير لـScrollTrigger. ركّب تثبيت المشاهد بترتيب ظهورها عشان تضل مسافات التمرير محسوبة صح.
بالبترَا، المشهد بثبت لمسافة حوالي ١٫٦ من ارتفاع الشاشة. صخور السيق بتفتح يمين وشمال، والخزنة بتكبر من ٤٢٪ لـ١٠٠٪. بالعقبة، سطح الميّ بطلع من المشهد بسرعة، والشعاب والسمك بتحرّكوا كل واحد بإيقاعه.
راجع الوصلات بين المشاهد لحالها. وحّد لون الحافتين وخفّف ظهور الطبقة اللي عاملة فرق واضح. ظلّ مشهد الفجر منفصل، بس حافة الصورة بتذوب بسما عمّان. وآخر العقبة بسلّم المشهد للمنسف بنفس لون الورق.
// From src/main.js, after Lenis and intro are initialized
lenis.on('scroll', ScrollTrigger.update);
gsap.ticker.add((t) => {
lenis.raf(t * 1000);
intro.tick();
});مرّر لتحت، والبطاقات بتروح بالعرض
ثبّت قسم البطاقات تحت شريط التنقّل. احسب طول المسار بطرح عرض المنطقة الظاهرة من عرض المسار كامل: scrollWidth - clientWidth. باتجاه اليمين للشمال، الصفر عند أول بطاقة عاليمين، والقيمة السالبة بتوصّلك لآخر بطاقة.
خلّي التثبيت ينتهي بنفس المسافة، وحدّث الحساب لما يتغيّر حجم الشاشة. باقي الصفحة بكمل نزول عادي. وللي مفعّل تقليل الحركة، خلّي البطاقات تنسحب بالعرض بالطريقة الأصلية للمتصفّح.
مرّر لتحت عشان تشوف البطاقات. هالصف لحاله بمشي بالعرض.


بلّورات الملح

الطفو عالمَيّ
// Abridged from src/main.js; rail has dir="rtl"
const distance = () => rail.scrollWidth - rail.clientWidth;
gsap.fromTo(rail, { scrollLeft: 0 }, {
scrollLeft: () => -distance(),
ease: 'none',
scrollTrigger: {
trigger: gallery,
start: () => `top ${header.offsetHeight + 8}`,
end: () => `+=${Math.max(1, distance())}`,
pin: true, scrub: true, invalidateOnRefresh: true,
},
});افحص الرحلة وانشرها
جرّب زر تخطّي المقدّمة، وروابط المحطّات الست، والتنقّل للخلف وللأمام، وافتح الموقع مباشرة من رابط #petra. بالموقع الأصلي، رابط المحطّة بحدّث عنوان الصفحة وبينقل التركيز للمشهد بدون قفزة تمرير ثانية. زر Escape بسكّر قائمة الموبايل وبرجّع التركيز لزرّها.
جرّب البطاقات لقدّام ولورا عالموبايل والكمبيوتر. تأكّد إنّ آخر بطاقة مبينة كاملة وبعدها الصفحة بتكمل للمشهد اللي بعده. فعّل خيار تقليل الحركة وتأكد إنّ المقدّمة والتثبيت بتخطّاهم المتصفّح وبتضل البطاقات قابلة للاستخدام.
ابنِ مجلّد dist/ وافحصه بالمعاينة. ارفع نفس المجلّد على مشروع Cloudflare Pages تبعك، وارجع افحص الصور والروابط بالنسخة المنشورة.
npm run build
npm run preview
# Update an existing Cloudflare Pages project.
# Replace my-pages-project with your project name.
npx wrangler pages deploy dist \
--project-name my-pages-project --branch main

