Select
Creates a select box with pre-defined options.
Config methods
add_options( $options )
Add an associative array with options or a callable.
The method can be called multiple times, in which case the options between the calls will be appended (instead of overwritten).
set_options( $options )
Set options as an associative array or a callable.
The method is not intended to be called multiple times – each call will overwrite the previous options.
Field::make( 'select', 'crb_content_align', 'Text alignment' )
->add_options( array(
'left' => 'Left',
'center' => 'Center',
'right' => 'Right',
) )NB! Performance implications
If fetching your options has performance implications we strongly suggest you define a function to retrieve them and pass that function’s name (or any valid callable) as the argument to add_options()/set_options() – this way your options will only be fetched when needed rather than on every pageload:
function my_computation_heavy_getter_function() {
$results = $wpdb->get_results(); // fetching from the database, for example
$results_dictionary = results_to_dictionary( $results ); // pseudocode for transforming database results to key=>value dictionary
return $results_dictionary;
}
// ...
Field::make( 'select', 'crb_select_field' )
->add_options( 'my_computation_heavy_getter_function' )