submit_button()显示一个提交按钮

目录

描述

Echos a submit button, with provided text and appropriate class.

Note: This function is only available from the administration panels. It cannot be used on the front end of the site.

submit_button() 描述

用法

<?php submit_button$text$type$name$wrap$other_attributes ?>

submit_button() 用法

参数

$text

(string) (可选) The text of the button

默认值: Save Changes

$type

(string|array) (可选) The type of button. Common values: primary, secondary, delete.

默认值: primary

Note: $type can be a single value, or a space separated list of values, or an array of values. The values determine the HTML classes of the button.

  • If $type is 'delete', the classes are 'button-secondary delete'.
  • Otherwise the first class is 'button', followed by any of these in order of appearance:
    • type value 'primary' makes class 'button-primary'
    • type value 'small' makes class 'button-small'
    • type value 'large' makes class 'button-large'
    • type value 'secondary' or 'button-secondary' is ignored (the 'button' class has the styling)
    • any other type value 'foo' makes the class 'foo'

For example, the default $type 'primary' results in a button with HTML classes 'button button-primary'.

$name

(string) (可选) The HTML name of the submit button. If no id attribute is given in $other_attributes below, $name will be used as the button's id.

默认值: submit

$wrap

(boolean) (可选) True if the output button should be wrapped in a paragraph tag, false otherwise. Defaults to true

默认值: true

$other_attributes

(array|string) (可选) Other attributes that should be output with the button, mapping attributes to their values, such as array( 'tabindex' => '1' ).

默认值: NULL

submit_button() 参数

返回值

This function does not return a value. The HTML for the button is output directly to the browser.

submit_button() 返回值

示例

Default Usage

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
submit_button();

This will output the following HTML, which will display a button with the text, "Save Changes".

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

<input type="submit" name="submit" id="submit" class="button button-primary" value="Save Changes"  />

Using Custom Text

To output a button with custom text, use the first parameter like this:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
submit_button( 'Submit' );

Display a Secondary Button

WordPress styles secondary and primary buttons differently. Primary buttons are blue, and stand out more than secondary buttons, which are grey. By default, submit_button() outputs a primary button. To display a secondary button instead, set the $type parameter to 'secondary':

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
submit_button( 'Reset', 'secondary' );

Display a Delete Button

By default, WordPress doesn't currently appear to have custom styling for delete buttons, but it does give them the 'delete' HTML class. However, it's possible that could change in the future, so it's a good idea to specify the $type as 'delete' when displaying a delete button:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
submit_button( 'Delete', 'delete' );

By default, delete buttons will be displayed as secondary buttons, not primary. If you want to display it as a primary button, you can do it like this:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
submit_button( 'Delete', 'delete button-primary' );

Using the $name Parameter

The $name parameter may be used if you want to set the HTML name attribute for the button. By default, this will be 'submit'.

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

submit_button( 'Save Settings', 'primary', 'wpdocs-save-settings' );

By default, the $name is also used to fill out the button's id attribute. To change this, you can pass an id via the $other_attributes parameter:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

$other_attributes = array( 'id' => 'wpdocs-button-id' );

submit_button( 'Save Settings', 'primary', 'wpdocs-save-settings', true, $other_attributes );

Using the $wrap Parameter

The $wrap parameter controls whether the button is wrapped in a paragraph tag, which it is by default. This can be a help or a hindrance depending on where an how you wish to display the button. To turn this behavior off, pass false for the fourth parameter:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
submit_button( 'Submit', 'primary', 'submit-form', false );

Specifying Other HTML Attributes

You can add any HTML attributes you chose to your button using the $other_attributes parameter. For example:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

$other_attributes = array( 'tabindex' => '1' );

submit_button( 'Go!', 'secondary', '', true, $other_attributes );

submit_button() 示例

注意

  • 使用到 the related function get_submit_button(), which returns the button as a string instead of echoing it. It has a different default $type, 'primary large', resulting in the HTML classes 'button button-primary button-large'.
  • This function cannot be used on the front end of the site, it is only available when loading the administration panels.

submit_button() 注意

历史

添加于 版本: 3.1

submit_button() 历史

源文件

submit_button() 函数的代码位于 /wp-admin/includes/template.php.

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
/**
 * Echoes a submit button, with provided text and appropriate class(es).
 *
 * @since 3.1.0
 *
 * @see get_submit_button()
 *
 * @param string       $text             The text of the button (defaults to 'Save Changes')
 * @param string       $type             Optional. The type and CSS class(es) of the button. Core values
 *                                       include 'primary', 'secondary', 'delete'. Default 'primary'
 * @param string       $name             The HTML name of the submit button. Defaults to "submit". If no
 *                                       id attribute is given in $other_attributes below, $name will be
 *                                       used as the button's id.
 * @param bool         $wrap             True if the output button should be wrapped in a paragraph tag,
 *                                       false otherwise. Defaults to true
 * @param array|string $other_attributes Other attributes that should be output with the button, mapping
 *                                       attributes to their values, such as setting tabindex to 1, etc.
 *                                       These key/value attribute pairs will be output as attribute="value",
 *                                       where attribute is the key. Other attributes can also be provided
 *                                       as a string such as 'tabindex="1"', though the array format is
 *                                       preferred. Default null.
 */
function submit_button( $text = null, $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = null ) {
	echo get_submit_button( $text, $type, $name, $wrap, $other_attributes );
}

submit_button() 源文件

相关