انتقل إلى المحتوى

أداة تحديد العناصر

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

التفعيل

يتطلب تشغيل أداة تحديد العناصر وجود معلمة استعلام. أضف ?blockstudio-devtools إلى أي URL للواجهة الأمامية لتفعيلها:

الكود
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

من دون معلمة الاستعلام، لن يُحمّل أي نص برمجي أو سمات بيانات.

الإعدادات

فعّل أداة تحديد العناصر في blockstudio.json الخاص بقالبك:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
الخاصية النوع الافتراضي الوصف
enabled boolean false تفعيل أداة تحديد العناصر.

يتوفر الإعداد أيضًا كمرشح:

PHP
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');

الاستخدام

  1. انتقل إلى أي صفحة على الواجهة الأمامية مع ?blockstudio-devtools أثناء تسجيل الدخول كمستخدم لديه صلاحية edit_posts.
  2. اضغط مطولًا على Cmd+C (Mac) أو Ctrl+C (Windows) لمدة 100ms لتفعيل أداة التحديد.
  3. يُفعّل مُحدِّد بمؤشر تصويب مع طبقة Canvas تبرز كتل Blockstudio أثناء تمرير المؤشر.
  4. تظهر تسميتان: إحداهما تعرض مسار ملف قالب الكتلة، والأخرى تعرض اسم وسم عنصر HTML.
  5. انقر عنصرًا لنسخ سياقه إلى الحافظة.
  6. ألصق النتيجة في أداة البرمجة بالذكاء الاصطناعي.

اضغط Escape أو Cmd+C مجددًا لإلغاء التفعيل دون نسخ. إذا رفعت إصبعك عن Cmd+C قبل مرور 100ms، فسيظل سلوك النسخ المعتاد كما هو.

تنسيق الحافظة

يؤدي النقر على عنصر إلى نسخ سلسلة سياق غنية مصممة لمساعدي البرمجة بالذكاء الاصطناعي:

الكود
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

يتضمن ذلك اسم وسم العنصر، ومعاينة HTML بسماتها ومحتواها، ومسار ملف القالب.

التفاصيل الداخلية

يضيف Blockstudio سمة data-blockstudio-path إلى كل عنصر غلاف لكتلة يستخدم useBlockProps على الواجهة الأمامية. وتحتوي هذه السمة على المسار المطلق لملف القالب الذي يعرض الكتلة.

تُضاف وحدة TypeScript خفيفة مكتوبة بـvanilla (دون اعتماد على React أو WordPress) إلى الواجهة الأمامية للمحررين المسجلين. تستخدم document.elementsFromPoint() لاكتشاف عنصر HTML المحدد تحت المؤشر وكتلة Blockstudio الأصل، وترسم تمييزًا منفصلًا لكل منهما.

الأمان

لا تُعرض سمة data-blockstudio-path والنص البرمجي لأداة التحديد إلا عند استيفاء جميع الشروط:

  • وجود معلمة الاستعلام ?blockstudio-devtools.
  • ضبط الإعداد dev.grab.enabled على true.
  • امتلاك المستخدم الحالي صلاحية edit_posts.

لا يرى الزوار العموميون مسارات الملفات أو النص البرمجي لأداة التحديد مطلقًا.