Pereiti prie turinio

Atributų registravimas

Atributai apibrėžiami masyve blockstudio.attributes, esančiame faile block.json.

Pagrindinis pavyzdys

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

Atributų savybės

Visi atributai turi šias savybes:

Savybė Tipas Aprašymas
id string Unikalus atributo identifikatorius
type string Lauko tipas (tekstas, teksto sritis, pasirinkimo laukas ir kt.)
label string Redaktoriuje rodoma etiketė
default mixed Numatytoji atributo reikšmė
help string Pagalbos tekstas, rodomas kaip patarimas šalia etiketės
position string Lauko vieta: inspector (numatytoji) arba toolbar
conditions array Sąlyginė lauko rodymo arba slėpimo logika

Vieta

Pagal numatytuosius nustatymus visi laukai rodomi bloko tikrintuve (šoninėje juostoje). Tai galite pakeisti naudodami savybę 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" }
        ]
      }
    ]
  }
}

Numatytosios reikšmės

Nustatykite numatytąsias reikšmes naudodami savybę default:

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

Pagalbos tekstas

Pridėkite naudotojams skirtą pagalbos tekstą:

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

Prieiga prie atributų

Šablone atributai pasiekiami per trumpinį $a (arba $attributes):

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

Arba naudokite Twig:

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

Laukų šablonų receptų rinkinys