Text | Meta Box Documentation

Overview

The text field creates a simple text input. You are able to enter any content or select a value from a predefined list via datalist option.

Screenshots

Default:

text

With datalist:

text with datalist

Cloneable:

text clone

Settings

Besides the common settings, this field has the following specific settings:

Name	Description
`placeholder`	Placeholder for the input. Optional.
`size`	Size of input box. Optional. Default 30.
`datalist`	Predefined values that users can select from (users still can enter text if they want). Optional. This parameter has the following sub-parameters:
	`id`: ID of the div that stores the options. Usually not used and auto-generated as `{$field['id']_list`. Useful if you have several text input with same datalist.
	`options`: Array of predefined values to select from.

Sample code

array(
    'name'        => 'Text',
    'label_description' => 'Label description',
    'id'          => 'text',
    'desc'        => 'Please enter some text above',
    'type'        => 'text',

    // Default value (optional)
    // 'std'         => 'Default text value',

    // Cloneable (i.e. have multiple value)?
    'clone'       => true,

    // Placeholder
    'placeholder' => 'Enter something here',

    // Input size
    'size'        => 30,

    // Datalist
    'datalist'    => array(
        // Unique ID for datalist. Optional.
        'id'      => 'text_datalist',
        // List of predefined options
        'options' => array(
            'What',
            'When',
            'Where',
            'Why',
            'Who',
        ),
    ),
),

Data

This field simply saves a single entered value in the database.

If the field is cloneable, then the value is stored as a serialized array in a single row in the database.

Template usage

If field is not cloneable:

$value = rwmb_meta( $field_id );
echo $value;

If field is cloneable:

$values = rwmb_meta( $field_id );
foreach ( $values as $value ) {
    echo $value;
}