تحديث سريع لنسختي من “F-NAV for Mobile” مع زر الرجوع، وقائمة فرعية مخصصة، وعناصر تحكم في الرؤية
لماذا هذه النسخة؟
- توفير زر “رجوع” في رأس الصفحة على صفحات المواضيع يعكس تجربة المستخدم الشائعة في تطبيقات الهاتف المحمول
- تقديم نوع علامة تبويب “customMenu” يفتح قائمة فرعية قابلة للتكوين (مثالي للربط بوجهات متعددة؛ نستخدمه لإضافة روابط “موضوع جديد” مسبقة التعبئة مخصصة)
- إضافة رؤية تعتمد على المجموعات لعلامات التبويب وعناصر القائمة، بحيث يمكنك إظهار عناصر معينة للموظفين فقط، وما إلى ذلك.
- إصلاحات صغيرة مع بعض الإهمالات وصقل الأنماط/إمكانية الوصول
ملخص حول الميزات المضافة حديثًا
- أيقونة الرجوع في الرأس (اختياري)
- يستبدل شعار الصفحة الرئيسية في الرأس بسهم رجوع على صفحات المواضيع
- السلوك: الرجوع إذا كان هناك سجل، وإلا يتم التوجيه إلى “/”
- التبديل باستخدام الإعداد:
header_back_icon_enabled
- نوع علامة التبويب قائمة فرعية مخصصة
- وظيفة جديدة لـ f_nav_tabs: customMenu
- إعداد جديد: f_nav_submenu_items
- تكوين عناصر القائمة مع التسمية وعنوان URL (أيقونة اختيارية)
- رائع للوصول السريع إلى صفحات متعددة من علامة تبويب واحدة
- عناصر تحكم الرؤية المستندة إلى المجموعات
- يمكن تحديد علامات التبويب وعناصر القائمة الفرعية وعناصر profile_extra_items لمجموعات محددة
- السلوك:
- مجموعات فارغة => مرئية للجميع
- إذا تم تعيين المجموعات => يمكن فقط للأعضاء في مجموعة واحدة محددة على الأقل رؤيتها
- لا يمكن للمستخدمين المجهولين رؤية العناصر المقيدة
- اختياري: إخفاء شريط التنقل على صفحات المواضيع
- التبديل باستخدام الإعداد: hide_nav_in_topic
- ملفات “build” مضغوطة ووثائق اختبار
- ملفات بناء ملائمة (v1–v5) تحت builds/
- TESTING_GUIDE.md و TEST_RESULTS.md توثق التحقق اليدوي
تحسينات على الميزات الحالية
- عناصر وعلامات تبويب F-NAV
- يضيف getter visibleTabs لاحترام رؤية المجموعة
- يدمج مكون CustomSubmenu الجديد في تدفق FNavItem
- قائمة الأفاتار/الملف الشخصي في الرأس
- تم نقل اكتشاف عرض الهاتف المحمول إلى المكون، مما يحسن السلوك ويحل التحذيرات
- تدعم عناصر الملف الشخصي الإضافية الآن الرؤية المستندة إلى المجموعات
- التصميم وإمكانية الوصول
- SCSS جديد للقائمة الفرعية المخصصة وأيقونة الرجوع
- حالات التفاعل المتسقة عند التحويم/النشط/التركيز المرئي
- شعاع حدود متسق مع المتغيرات الأساسية؛ تم تحسين الحشو/التباعد (على سبيل المثال، تم تعيين حشو زر الرجوع إلى 0)
إصلاحات الأخطاء والصيانة
- حل تحذيرات إهمال site.mobileView عن طريق نقل الفحوصات من المبدئات إلى عرض المكون
- إصلاح حالة حافة عرض عن طريق نقل وظيفة خارج كتلة
- صقل طفيف لمطابقة سلوكيات رأس Discourse (حالات التحويم/النشط، انتقالات الشفافية)
- تنظيفات CSS صغيرة (على سبيل المثال، التأكد من أن حشو زر الرجوع صفر، ومنع تغييرات الحجم العرضية)
مقارنة عالية المستوى (الفرع الأصلي مقابل الفرع المنسوخ)
- الأصلي (main): علامات تبويب F-NAV للجوال + استيراد دردشة اختياري؛ لا يوجد زر رجوع أو قائمة فرعية مخصصة
- النسخة (feat/home-logo-arrow-back):
- يضيف ميزة أيقونة الرجوع في الرأس مع خيار احتياطي للتوجيه
- يقدم وظيفة علامة التبويب “customMenu” مع عناصر قائمة فرعية قابلة للتكوين
- يضيف رؤية مقيدة بالمجموعات لعلامات التبويب وعناصر القائمة الفرعية وعناصر الملف الشخصي
- يخفي اختياريًا F-NAV على صفحات المواضيع
- يحسن إمكانية الوصول واتساق حالات التفاعل
- يوفر وثائق اختبار وبناءات مجمعة
ملاحظات:
- يستهدف هذا المكون إصدارات Discourse الحديثة التي تدعم مستوى واجهة برمجة تطبيقات المكونات الإضافية Discourse 1.14+ (كما هو موضح في المبدئات)
- إذا كنت تعتمد على الرؤية المستندة إلى المجموعات، فتأكد من تكوين مجموعاتك وعضوياتك أولاً
كلمة تحذير: يرجى الاختبار بحذر لأنني لست مبرمجًا، وتم إنشاء واختبار TC بالكامل بواسطة الذكاء الاصطناعي. يعمل بشكل أفضل مع 3.6beta1.
تحية كبيرة لـ Don على هذا المكون الرائع؛ إنه إضافة رائعة! 