المكتبة التقنية ←

تحسين التنقل على الموبايل في APEX

English version

A side menu that stays open after navigation can make a small screen frustrating. Start by reproducing the behavior in the application's actual theme version and checking its built-in navigation behavior.

If custom handling is needed, scope it to the navigation region and the links that genuinely navigate. A document-wide handler for every anchor also catches dialog links, downloads, help links, and unrelated controls.

Use a stable, documented theme interaction where available. Treat internal element IDs and CSS classes as version-dependent assumptions, and record those assumptions beside the code. Avoid logging complete link URLs when they may contain identifiers or session information.

Test touch and keyboard navigation, focus after the menu closes, back navigation, and narrow and wide layouts. Check that activating a dialog does not unexpectedly move focus or dismiss the wrong interface.

A small improvement becomes reusable when its scope and failure cases are clear.

النسخة العربية

القائمة الجانبية اللي تفضل مفتوحة بعد التنقل ممكن تضايق المستخدم على الموبايل. ابدأ بإعادة المشكلة على إصدار الـTheme المستخدم فعلًا، وراجع سلوك التنقل المدمج.

لو محتاج معالجة مخصصة، حددها في منطقة القائمة والروابط اللي بتنقل فعلًا. مراقبة كل عناصر الروابط في الصفحة تمسك كمان الـDialogs والتنزيلات والمساعدة وعناصر ملهاش علاقة بالقائمة.

استخدم تفاعل موثق وثابت من الـTheme لو متاح. اعتبر الـIDs والكلاسات الداخلية تفاصيل مرتبطة بالإصدار، وسجل الافتراضات جنب الكود. تجنب تسجيل الرابط الكامل لو فيه معرفات أو بيانات جلسة.

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

التفصيلة الصغيرة تبقى قابلة لإعادة الاستخدام لما تحدد نطاقها وحالات فشلها.