Layout: tabs, columns, fields

Every blueprint is normalized into the same structure: tabs → columns → fields.

$blueprint->tabs();
// [
//   "content" => [
//     "name" => "content", "label" => "Content", "icon" => null,
//     "columns" => [
//       ["width" => "2/3", "fields" => ["intro" => [...], "articles" => [...]]],
//     ],
//   ],
// ]

Field definitions and references

When a blueprint has a layout (tabs, columns or sections), root fields are definitions. They only appear in the panel and in $blueprint->fields() when a tab or column references them:

fields:
  title:
    type: text
  date:
    type: date

tabs:
  content:
    fields:
      - title             # reference
      - date
      - text:             # inline definition
          type: textarea

Without a layout, root fields are the layout themselves.

All other fields

fields: true in a tab or column places all definitions that aren't used anywhere else, in their order:

fields:
  title: text
  text: textarea
  date: date
  author: userpicker

tabs:
  content:
    fields: [title, text]
  meta:
    fields: true      # date, author

Tabs

tabs:
  content:
    label: Content      # default: the name, "seoSettings" → "Seo settings"
    icon: page
    columns: [...]      # or `fields`, wrapped in one 1/1 column
  seo: tabs/seo         # extends site/blueprints/tabs/seo.yml
  old: false            # removes an (inherited) tab

Columns

columns:
  - width: 2/3          # default 1/1
    fields: [title, text]
  - width: 1/3
    fields: [date]

columns at the root level are wrapped in a main tab.

Field shortcuts

Groups

A group field is replaced by its fields. when of the group is passed to every field:

fields:
  address:
    type: group
    when:
      hasAddress: true
    fields:
      street: text
      city: text

Sections (legacy)

Kirby style sections are converted into fields:

headline becomes label.

Field names

All fields of a blueprint share one namespace (case insensitive). Duplicates, unknown types and missing references don't break the blueprint, they are replaced with a red info field describing the error.