Complex fields act as containers to which you can add multiple groups of fields. It is represented as a table, where each row is a field group. The user is able to add infinite rows of each group. This allows to repeat a set of fields multiple times creating customizable and sortable lists. This is useful when creating image galleries, lists of data or advanced content and layout elements.
Field::make('complex', 'crb_slide')->add_fields(array( Field::make('text', 'title'), Field::make('image', 'photo'), ))
The example above shows how to make a slide show. We crated a single complex field named
slide, to which we attached one group of fields that represents a single slide –
photo. The user will be able to add multiple rows of title and photo, thus creating a list of slides for the slide show.
A more advanced usage of the complex field is shown below:
Field::make('complex', 'crb_media_item') ->add_fields('photograph', array( Field::make('image', 'image'), Field::make('text', 'caption'), )) ->add_fields('movie', array( Field::make('file', 'video'), Field::make('text', 'title'), Field::make('text', 'length'), ))
Here we have to create a list of media items, lets say for an art exhibition. There are two types of items – photos (defined by an
image and a
caption) and movies (having a
length and the
video file itself). Since items have different properties, we need to define separate group for each one. Groups also must have a name, by which they will be recognized later –
As you can see, depending on their usage, complex fields can either contain a single unnamed group or multiple named groups.