Μετάβαση στο περιεχόμενο

Επιλογέας στοιχείων

Όταν εργάζεστε με βοηθούς προγραμματισμού τεχνητής νοημοσύνης, συχνά χρειάζεται να τους υποδείξετε ποιο αρχείο προτύπου αποδίδει ένα συγκεκριμένο στοιχείο της σελίδας. Ο επιλογέας στοιχείων παρέχει έναν επιλογέα τύπου σταυρονήματος που αντιγράφει στο πρόχειρο πλούσιο πλαίσιο πληροφοριών για το στοιχείο με μία μόνο κίνηση.

Ενεργοποίηση

Η λειτουργία λήψης στοιχείων είναι διαθέσιμη μέσω μιας παραμέτρου ερωτήματος. Προσθέστε το ?blockstudio-devtools σε οποιοδήποτε frontend URL για να την ενεργοποιήσετε:

Κώδικας
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

Χωρίς την παράμετρο ερωτήματος, δεν φορτώνονται script ή χαρακτηριστικά δεδομένων.

Ρυθμίσεις

Ενεργοποιήστε τον επιλογέα στοιχείων στο blockstudio.json του θέματος:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Ιδιότητα Τύπος Προεπιλογή Περιγραφή
enabled boolean false Ενεργοποίηση του επιλογέα στοιχείων.

Η ρύθμιση είναι επίσης διαθέσιμη ως φίλτρο:

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

Χρήση

  1. Επισκεφτείτε οποιαδήποτε σελίδα frontend με το ?blockstudio-devtools ενώ είστε συνδεδεμένοι ως χρήστης με δυνατότητα edit_posts.
  2. Κρατήστε πατημένα τα Cmd+C (Mac) ή Ctrl+C (Windows) για 100ms για να ενεργοποιήσετε τον επιλογέα.
  3. Ενεργοποιείται ένας επιλογέας τύπου σταυρονήματος με επικάλυψη καμβά που επισημαίνει τα μπλοκ Blockstudio καθώς περνάτε τον δείκτη από πάνω τους.
  4. Εμφανίζονται δύο ετικέτες: μία με τη διαδρομή αρχείου προτύπου του μπλοκ και μία με το όνομα ετικέτας του στοιχείου HTML.
  5. Κάντε κλικ σε ένα στοιχείο για να αντιγράψετε το πλαίσιο πληροφοριών του στο πρόχειρο.
  6. Επικολλήστε το αποτέλεσμα στο εργαλείο προγραμματισμού τεχνητής νοημοσύνης σας.

Πατήστε ξανά Escape ή Cmd+C για απενεργοποίηση χωρίς αντιγραφή. Αν αφήσετε το Cmd+C πριν από τα 100ms, διατηρείται η κανονική λειτουργία αντιγραφής.

Μορφή πρόχειρου

Κάνοντας κλικ σε ένα στοιχείο αντιγράφεται μια συμβολοσειρά εμπλουτισμένου περιεχομένου, σχεδιασμένη για βοηθούς προγραμματισμού με AI:

Κώδικας
@<div>

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

Περιλαμβάνει την ετικέτα του στοιχείου, μια προεπισκόπηση HTML με γνωρίσματα και περιεχόμενο, καθώς και τη διαδρομή του αρχείου προτύπου.

Εσωτερικά

Το Blockstudio προσθέτει ένα γνώρισμα data-blockstudio-path σε κάθε στοιχείο wrapper block που χρησιμοποιεί useBlockProps στο frontend. Αυτό το γνώρισμα περιέχει την απόλυτη διαδρομή προς το αρχείο προτύπου που αποδίδει το block.

Στο frontend, για συνδεδεμένους συντάκτες, φορτώνεται μια ελαφριά vanilla ενότητα TypeScript (χωρίς εξαρτήσεις React ή WordPress). Χρησιμοποιεί το document.elementsFromPoint() για να εντοπίσει τόσο το συγκεκριμένο στοιχείο HTML κάτω από τον δείκτη όσο και το γονικό του block Blockstudio, επισημαίνοντάς τα ξεχωριστά.

Ασφάλεια

Το γνώρισμα data-blockstudio-path και το script grabber αποδίδονται μόνο όταν πληρούνται όλες οι προϋποθέσεις:

  • Υπάρχει η παράμετρος ερωτήματος ?blockstudio-devtools.
  • Η ρύθμιση dev.grab.enabled είναι true.
  • Ο τρέχων χρήστης έχει τη δυνατότητα edit_posts.

Οι δημόσιοι επισκέπτες δεν βλέπουν ποτέ διαδρομές αρχείων ή το script grabber.