مخفي

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

حتى الحقل المخفي يدعم شروط، وتطبع قيمته المخزنة من خلال محرك قالب بناء جملة الغصين مثل أي رمز آخر، حتى تتمكن من الرجوع إليه {% if %} الشيكات عبر القالب الخاص بك. كلا الدليلين يغطيان التفاصيل.

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

ماذا يفعل الحقل المخفي #

• يخزن قيمة سلسلة ثابتة محددة في أداة الإنشاء، مع عدم وجود تحكم مرئي في Elementor.
• يطبع تلك القيمة في أي مكان في لوحة HTML أو CSS أو JS الخاصة بالعنصر واجهة المستخدم من خلاله {{ your_field_name }}.
• يبقي ثوابت التكوين خارج واجهة مستخدم التحرير، لذلك لا يمكن تغييرها في كل صفحة.
• يتصرف كقيمة نصية في منطق القالب، لذا فإن الشروط الشرطية مثل {% if mode == 'embed' %} عمل.

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

قبل أن تبدأ #

• ووردبريس مع العنصر مثبتة ونشطة.
• الإضافات الرئيسية للعنصر مثبت ونشط. جديد في البرنامج المساعد؟ انظر دليل التثبيت.
• أداة مخصصة مفتوحة في محرر Widget Builder. مثالنا هو أداة تضمين الخريطة حيث يتم تسمية الحقل المخفي map_style_key يحمل معرف نمط الخريطة الثابت الذي يتوقعه البرنامج النصي المضمن.

كيفية إضافة حقل مخفي #

اسحب مخفي الحقل من لوحة الحقول إلى أي قسم. علامة التبويب لا تهم هنا، حيث لا يوجد شيء يظهر في اللوحة في أي من الاتجاهين. تفتح خياراتها على اليسار بمجرد هبوطها.

شرح خيارات المجال المخفي #

قائمة الخيارات قصيرة حسب التصميم:

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

قم بتوصيل الحقل المخفي بالرمز المميز الخاص به #

الحقل المخفي هو حقل رمز مميز. اطبعها تمامًا كقيمة نصية، في أي من اللوحات الثلاث

<!-- HTML panel -->
<div class="ma-map" data-style="{{ map_style_key }}"></div>

// JS panel
var styleKey = "{{ map_style_key }}";
initMap(styleKey);

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

{% if widget_mode == 'compact' %}
<div class="ma-map ma-map--compact"></div>
{% else %}
<div class="ma-map ma-map--full"></div>
{% endif %}

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

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

استخدم الحقل المخفي في Elementor #

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

حالات الاستخدام الشائعة #

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

نصائح للعمل مع الحقل المخفي #

• سمها مثل الثابت. map_style_key يخبر المشرف التالي بما يعنيه الرمز المميز؛ hidden_1 لا.
• قم بتعيين الافتراضي قبل الحفظ. لا توجد فرصة ثانية من جانب العنصر؛ يعرض الإعداد الافتراضي الفارغ سلسلة فارغة في كل مكان يظهر فيه الرمز المميز.
• اقتبسها في شبيبة. القيمة عبارة عن سلسلة، لذا اكتب var key = "{{ map_style_key }}"; مع اقتباسات.
• تفضل حقلاً مرئيًا بمجرد أن يحتاج المستخدمون إلى التحكم. في اللحظة التي يجب أن تختلف فيها القيمة لكل صفحة، قم بتبديل الحقل المخفي بـ نص أو يختار الحقل بدلاً من مطالبة المستخدمين بتحرير الأجزاء الداخلية لعناصر واجهة المستخدم.
• لا أسرار. تنتهي القيمة في مخرجات الصفحة العامة، لذا تعامل معها على أنها مرئية لأي شخص يقرأ المصدر.

الأسئلة المتداولة #

إلتحاق بالركب #

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