Skip to main content

Button

The button field creates a simple button. It doesn't have any value. Usually, this field is used to trigger custom JavaScript actions.

Screenshots​

Settings​

This field doesn't have any specific settings. It only uses common settings. But there are important settings that you should pay attention to, the keys are for use with code:

NameKeyDescription
Default valuestdButton text.
Custom HTML5 attributesattributesA list of custom HTML5 attributes for the button. More info.

This is a sample field settings array when creating this field with code:

[
'type' => 'button',
'name' => 'Advanced Settings',
'std' => 'Toggle',
'attributes' => [
'data-section' => 'advanced-section',
'class' => 'js-toggle',
],
],

Data​

This field does not save any value in the database.

Custom JavaScript​

As said above, this field is usually used for custom JavaScript actions. To enqueue a JavaScript file to the admin editing page, use the rwmb_enqueue_scripts hook:

add_action( 'rwmb_enqueue_scripts', 'prefix_enqueue_custom_script' );
function prefix_enqueue_custom_script() {
wp_enqueue_script( 'script-id', get_template_directory_uri() . '/js/admin.js', [ 'jquery' ], '', true );
}

And in the admin.js script, you can trigger a custom action when click the button:

jQuery( function( $ ) {
$( '.js-toggle' ).on( 'click', function() {
// Do something.
} );
} );