submit_button() - WordPress 函数参考中文文档

返回介绍

submit_button()

发布于 2017-09-11 字数10134 浏览 978 评论 0

submit_button( string $text = null,  string $type = 'primary',  string $name = 'submit',  bool $wrap = true,  array|string $other_attributes = null )

Echoes a submit button, with provided text and appropriate class(es).


描述


参数

$text

(string)
(Optional)
The text of the button (defaults to ‘Save Changes’)

Default value: null

$type

(string)
(Optional)
The type and CSS class(es) of the button. Core values include ‘primary’, ‘small’, and ‘large’.

Default value: ‘primary’

$name

(string)
(Optional)
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.

Default value: ‘submit’

$wrap

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

Default value: true

$other_attributes

(array|string)
(Optional)
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 value: null


源代码

File: wp-admin/includes/template.php

function submit_button( $text = null, $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = null ) {
	echo get_submit_button( $text, $type, $name, $wrap, $other_attributes );
}

更新日志

Version 描述
3.1.0 Introduced.

相关函数

Uses

  • wp-admin/includes/template.php:
    get_submit_button()

Used By

  • wp-admin/includes/dashboard.php:
    wp_print_community_events_markup()
  • wp-admin/includes/class-wp-plugins-list-table.php:
    WP_Plugins_List_Table::search_box()
  • wp-admin/includes/network.php:
    network_step1()
  • wp-admin/install.php:
    display_setup_form()
  • wp-admin/includes/class-wp-screen.php:
    WP_Screen::render_screen_options()
  • wp-admin/includes/class-wp-plugins-list-table.php:
    WP_Plugins_List_Table::extra_tablenav()
  • wp-admin/includes/class-wp-links-list-table.php:
    WP_Links_List_Table::extra_tablenav()
  • wp-admin/includes/theme-install.php:
    install_theme_search_form()
  • wp-admin/includes/theme-install.php:
    install_themes_dashboard()
  • wp-admin/includes/theme-install.php:
    install_themes_upload()
  • wp-admin/includes/class-wp-list-table.php:
    WP_List_Table::search_box()
  • wp-admin/includes/class-wp-list-table.php:
    WP_List_Table::bulk_actions()
  • wp-admin/includes/plugin-install.php:
    install_search_form()
  • wp-admin/includes/plugin-install.php:
    install_plugins_upload()
  • wp-admin/includes/dashboard.php:
    wp_network_dashboard_right_now()
  • wp-admin/includes/dashboard.php:
    wp_dashboard_quick_press()
  • wp-admin/includes/dashboard.php:
    _wp_dashboard_control_callback()
  • wp-admin/includes/template.php:
    find_posts_div()
  • wp-admin/includes/template.php:
    meta_form()
  • wp-admin/includes/template.php:
    wp_import_upload_form()
  • wp-admin/includes/class-wp-users-list-table.php:
    WP_Users_List_Table::extra_tablenav()
  • wp-admin/includes/media.php:
    media_upload_type_form()
  • wp-admin/includes/media.php:
    media_upload_gallery_form()
  • wp-admin/includes/media.php:
    media_upload_library_form()
  • wp-admin/includes/media.php:
    media_upload_form()
  • wp-admin/includes/meta-boxes.php:
    link_submit_meta_box()
  • wp-admin/includes/meta-boxes.php:
    post_submit_meta_box()
  • wp-admin/includes/meta-boxes.php:
    attachment_submit_meta_box()
  • wp-admin/includes/class-wp-media-list-table.php:
    WP_Media_List_Table::extra_tablenav()
  • wp-admin/includes/class-wp-comments-list-table.php:
    WP_Comments_List_Table::extra_tablenav()
  • wp-admin/includes/nav-menu.php:
    wp_nav_menu_item_post_type_meta_box()
  • wp-admin/includes/nav-menu.php:
    wp_nav_menu_item_taxonomy_meta_box()
  • wp-admin/includes/file.php:
    request_filesystem_credentials()
  • wp-admin/includes/class-wp-posts-list-table.php:
    WP_Posts_List_Table::inline_edit()
  • wp-admin/includes/widgets.php:
    wp_widget_control()
  • wp-admin/includes/class-wp-posts-list-table.php:
    WP_Posts_List_Table::extra_tablenav()
  • wp-admin/custom-header.php:
    Custom_Image_Header::step_1()
  • wp-admin/custom-header.php:
    Custom_Image_Header::step_2()
  • wp-admin/includes/ms.php:
    confirm_delete_users()
  • wp-admin/update-core.php:
    list_core_update()
  • wp-admin/custom-background.php:
    Custom_Background::admin_page()
  • Show 36 more used by
    Hide more used by


User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Contributed by Codex

    Default Usage

    
    submit_button();
    

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

    
    <input type="submit" name="submit" id="submit" class="button button-primary" value="Save Changes"  />
    
    
  2. Using Custom Text
    To output a button with custom text, use the first parameter like this:

    
    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':

    
    submit_button( __( 'Reset', 'textdomain' ), '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:

    
    submit_button( __( 'Delete', 'textdomain' ), '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:

    
    submit_button( __( 'Delete', 'textdomain' ), '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'.

    
    submit_button( __( 'Save Settings', 'textdomain' ), '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:

    
    $other_attributes = array( 'id' => 'wpdocs-button-id' );
    submit_button( __( 'Save Settings', 'textdomain' ), '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:

    
    submit_button( __( 'Submit', 'textdomain' ), '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:

    
    $other_attributes = array( 'tabindex' => '1' );
    submit_button( __( 'Go!', 'textdomain' ), 'secondary', '', true, $other_attributes );
    
    

上一篇:strip_shortcode_tag()

下一篇:switch_theme()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!