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

Καταχώριση χαρακτηριστικών

Τα χαρακτηριστικά ορίζονται μέσα στον πίνακα blockstudio.attributes στο αρχείο block.json σας.

Βασικό παράδειγμα

JSON
{
  "name": "my-theme/my-block",
  "title": "My Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title"
      },
      {
        "id": "content",
        "type": "textarea",
        "label": "Content"
      }
    ]
  }
}

Ιδιότητες χαρακτηριστικών

Όλα τα χαρακτηριστικά έχουν τις ακόλουθες ιδιότητες:

Ιδιότητα Τύπος Περιγραφή
id string Μοναδικό αναγνωριστικό του χαρακτηριστικού
type string Ο τύπος πεδίου (text, textarea, select κ.λπ.)
label string Ετικέτα που εμφανίζεται στον επεξεργαστή
default mixed Προεπιλεγμένη τιμή του χαρακτηριστικού
help string Βοηθητικό κείμενο που εμφανίζεται ως επεξήγηση δίπλα στην ετικέτα
position string Πού εμφανίζεται το πεδίο: inspector (προεπιλογή) ή toolbar
conditions array Λογική συνθηκών για την εμφάνιση ή απόκρυψη του πεδίου

Θέση

Από προεπιλογή, όλα τα πεδία εμφανίζονται στον επιθεωρητή block (πλαϊνή γραμμή). Μπορείτε να το αλλάξετε με την ιδιότητα position:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "alignment",
        "type": "select",
        "label": "Alignment",
        "position": "toolbar",
        "options": [
          { "value": "left", "label": "Left" },
          { "value": "center", "label": "Center" },
          { "value": "right", "label": "Right" }
        ]
      }
    ]
  }
}

Προεπιλεγμένες τιμές

Ορίστε προεπιλεγμένες τιμές χρησιμοποιώντας την ιδιότητα default:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title",
        "default": "Hello World"
      },
      {
        "id": "showBorder",
        "type": "toggle",
        "label": "Show Border",
        "default": true
      }
    ]
  }
}

Βοηθητικό κείμενο

Προσθέστε βοηθητικό κείμενο για να καθοδηγήσετε τους χρήστες:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "apiKey",
        "type": "text",
        "label": "API Key",
        "help": "Enter your API key from the settings page"
      }
    ]
  }
}

Πρόσβαση σε χαρακτηριστικά

Στο πρότυπό σας, τα χαρακτηριστικά είναι διαθέσιμα μέσω της σύντομης σύνταξης $a (ή $attributes):

PHP
<h1><?php echo $a['title']; ?></h1>
<p><?php echo $a['content']; ?></p>

Ή στο Twig:

Twig
<h1>{{ a.title }}</h1>
<p>{{ a.content }}</p>

Βιβλίο συνταγών για μοτίβα πεδίων