Array Fieldtype

Overview#

This fieldtype is used to manage key: value array data in the right situation. It's used for situations when there is data you would like to stay grouped together because there's only one set and you don't want to use loops.

If you'd like to have lists of this type of data, you might want to use a grid or replicator field.

Modes#

The screenshot above depicts the three modes you can choose from. Two for when you know there is a fixed set of keys (keyed/single), and one for when you don't (dynamic).

Keyed Mode#

The first field contains pre-defined keys. This will give the user a stricter input. They can only enter the values for the specified keys, and they cannot be reordered.

address:
  type: array
  keys:
    street: Street
    city: City
    country: Country
yaml
yaml

The keys can be specified with or without labels. The snippet above (and what's shown in the screenshot) uses labels.

The following is an example of just keys. When using this syntax, the key and the label will be identical.

keys:
  - street
  - city
  - country
antlers
antlers

Single Mode#

Exactly the same restrictions and setup as keyed mode, except the user can only manage an array one item at a time, using a select box to switch between keys.

Dynamic Mode#

The second field contains no pre-defined keys. This will allow the user to define them on the fly and re-arrange them.

address:
  type: array
yaml
yaml

Column headings can be set with value_header & key_header.

value_header: Type of Bacon
key_header: Why is it awesome?
antlers
antlers

Data Structure#

In the example above, the keyed mode and dynamic mode would save the exact same data.

address:
  street: 221B Baker Street
  city: London
  country: England
yaml
yaml

Single mode will only save data if it has been entered by the user.

address:
  England: '221 Baker Street, London'
yaml
yaml

Templating#

This fieldtype is not augmented.

// Array access
{{ address }}
    {{ street }} {{ city }} {{ country }}
{{ /address }}
 
// Nested variables
{{ address:street }} {{ address:city }} {{ address:country }}
 
// Foreach tag:
{{ foreach:address }}
    {{ value }}
{{ /foreach:address }}
antlers
antlers

// Nested variables
{{ $address['street'] }}
{{ $address['city'] }}
{{ $address['country'] }}
 
// Using foreach
@foreach ($address as $key => $value)
    {{ $key }}: {{ $value }}
@endforeach
blade
blade

Options#