New! TypeRocket v5 is now available. See docs.
Access all of Typerocket. Get Pro.
Repeater Field
( v4 )
Repeaters
The repeater field lets you create groups of repeating fields.
For example, what if you're building an event listing site and need to list speakers for each event. A repeater field would be perfect for listing the speakers in an event post type since every speaker's information will be different even if they speak at multiple events.
The repeater could group fields for the speakers name, photo and a link to their slides.
Take a look at adding a meta box with the repeater.
$box = tr_meta_box('Speakers');
$box->addScreen( 'event' );
$box->setCallback(function() {
$form = tr_form();
echo $form->repeater('Speakers')->setFields([
$form->image('Photo'),
$form->text('Name'),
$form->text('Slides URL')
]);
});
Fields
Before we look at how to format a field parameter correctly take a look at the methods we can use. There are three methods for dealing with fields.
Methods
These methods are: getFields()
, setFields()
and appendField()
.
-
getFields()
returns the fullarray
of field arrays. -
setFields()
takes anarray
of field arrays. -
appendField()
append a fieldarray
.
JavaScript Hook
You can also use the javascript hooks to do something when a repeater field group is added.
Found a typo? Something is wrong in this documentation? Fork and edit it!