WordPress.org网站
获取WordPress
WordPress.org网站

WordPress开发人员资源

提交按钮（）

submit_按钮(一串 $文本 = ”,一串 $类型 = “主要”,一串 $名称 = '提交',布尔 $包装 = 真的,数组|字符串 $其他属性 = ” )

在本文中

返回页首

用提供的文本和适当的类回显提交按钮。

描述

另请参见

参数

$文本一串可选择的
按钮的文本。默认为“保存更改”。

违约：''

$类型一串可选择的
按钮的类型和CSS类。核心价值包括“主要”,“小”、和“大型”.默认值“主要”.

违约：“主要”

$名称一串可选择的
提交按钮的HTML名称。如果没有身份证件属性在$其他属性参数，$名称将用作按钮的身份证件.默认值'提交'.

违约：'提交'

$包装布尔可选择的
如果输出按钮应包装在段落标记中，则为True，否则为false。

违约：真的

$其他属性阵列|一串可选择的
应使用按钮输出的其他属性，将属性映射到其值，例如。数组（“id”=>“search-submit”）.
这些键/值属性对将输出为attribute=“value”，其中属性是键。属性也可以作为字符串提供，例如。id=“搜索-提交”，尽管通常首选数组格式。

违约：''

更多信息

此功能不能在站点前端使用，只有在加载管理屏幕时才可用。

参数$类型可以是单个值、以空格分隔的值列表或值数组。这些值决定了按钮的HTML类。

  • 如果$类型是“delete”，类是“button-secondary-delete”。
  • 否则，第一个类是“button”，后面按出现顺序依次为：
    • 类型值“primary”使类“button-primary“
    • 类型值“small”使类“button-small”
    • 类型值“large”使类“button-large“
    • 类型值'secondary'或'button-secondary'被忽略（'button'类具有样式）
    • 任何其他类型值“foo”都会使类成为“foo

例如，默认值$类型“primary”会产生一个包含HTML类“button button-primary“的按钮。

此函数不返回值。按钮的HTML将直接输出到浏览器。

使用相关功能获取提交按钮（），它将按钮作为字符串返回，而不是回显它。它具有不同的默认值$类型,'主要大型'，生成HTML类'按钮按钮-主按钮-大'.

来源

函数submit_button（$text=''，$type='primary'，$name='submit'，$wrap=true，$other_attributes=''）{echo get_submit_button（$text、$type、$name、$wrap、$other_attributes）；}

查看所有引用 在Trac上查看 在GitHub上查看

使用描述
获取提交按钮（）wp-admin/includes/template.php

返回一个提交按钮，其中包含提供的文本和适当的类。

使用者描述
WP_MS_Sites_List_Table:：extra_tablenav（）wp-admin/includes/class-wp-ms-sites-list-table.php

显示批量操作和分页之间的额外控件。

wp_print_community_events_markup（）wp-admin/includes/dashboard.php

打印事件和新闻仪表板小部件的社区事件部分的标记。

WP_Plugins_List_Table:：search_box（）wp-admin/includes/class-wp-plugins-list-table.php

显示搜索框。

网络步骤1（）wp-admin/includes/network.php

打印网络安装过程的步骤1。

显示设置窗体（）wp-admin/安装.php

显示安装程序设置窗体。

WP_Screen:：render_Screen_options（）wp-admin/includes/class-wp-screen.php

渲染屏幕选项选项卡。

WP_Plugins_List_Table:：extra_tablenav（）wp-admin/includes/class-wp-plugins-list-table.php
WP_Links_List_Table:：extra_tablenav（）wp-admin/includes/class-wp-links-list-table.php
安装theme_search_form（）wp-admin/includes/theme-install.php

显示搜索主题的搜索表单。

安装主题仪表板（）wp-admin/includes/theme-install.php

显示主题的标记过滤器。

安装主题上传（）wp-admin/includes/theme-install.php

显示从zip文件上载主题的表单。

WP_List_Table:：search_box（）wp-admin/includes/class-wp-list-table.php

显示搜索框。

WP_List_Table:：bulk_actions（）wp-admin/includes/class-wp-list-table.php

显示批量操作下拉列表。

安装搜索表单（）wp-admin/includes/plugin-install.php

显示用于搜索插件的搜索表单。

安装插件上传（）wp-admin/includes/plugin-install.php

显示从zip文件上载插件的表单。

_wp_仪表盘_control_callback（）wp-admin/includes/dashboard.php

输出当前仪表板小部件的控件。

wp_network_dashboard_right_now（）wp-admin/includes/dashboard.php
wp_仪表盘_quick_press（）wp-admin/includes/dashboard.php

显示“快速草稿”小部件。

find_posts_div（）wp-admin/includes/template.php

输出用于将媒体附加到媒体列表屏幕中的帖子或页面的模式窗口。

元格式（_F）wp-admin/includes/template.php

打印自定义字段元框中的表单。

wp_import_upload_form（）wp-admin/includes/template.php

输出导入程序用于接受要导入的数据的表单。

WP_Users_List_Table:：extra_tablenav（）wp-admin/includes/class-wp-users-list-table.php

输出控件以允许批量更改用户角色。

媒体上传类型格式（）wp-admin/includes/media.php

输出给定媒体类型的旧媒体上载表单。

媒体上传库格式（）wp-admin/includes/media.php

添加库表单以上载iframe。

媒体上传库格式（）wp-admin/includes/media.php

输出媒体库的旧媒体上传表单。

媒体上传格式（）wp-admin/includes/media.php

输出旧媒体上传表单。

链接提交元数据框（）wp-admin/includes/meta-boxes.php

显示链接创建表单域。

post_submit_meta_box（）wp-admin/includes/meta-boxes.php

显示提交后表单域。

附件_提交_ meta_box（）wp-admin/includes/meta-boxes.php

显示附件提交表单字段。

WP_Media_List_Table:：extra_tablenav（）wp-admin/includes/class-wp-media-list-table.php
WP_Comments_List_Table:：extra_tablenav（）wp-admin/includes/class-wp-comments-list-table.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/nav-menu.php

显示分类菜单项的元框。

请求文件系统凭据（）wp-admin/includes/file.php

向用户显示一个表单，以请求他们的FTP/SSH详细信息，以便连接到文件系统。

WP_Posts_List_Table:：inline_edit（）wp-admin/included/class-wp-posts-list-table.php

输出内联编辑时显示的隐藏行

wp_widget_control（）wp-admin/includes/widgets.php

用于显示控件控件窗体的元控件。

WP_Posts_List_Table:：extra_tablenav（）wp-admin/includes/class-wp-posts-list-table.php
自定义图像标题：：step_1（）wp-admin/includes/class-custom-image-header.php

显示自定义页眉图像页面的第一步。

自定义图像标题：：step_2（）wp-admin/includes/class-custom-image-header.php

显示自定义页眉图像页面的第二步。

确认删除用户（）wp-admin/includes/ms.php
列表核心更新（）wp-admin/update-core.php

列出可用的核心更新。

自定义背景：：admin_page（）wp-admin/includes/class-custom-background.php

显示自定义背景页。

再显示37个显示更少

变更日志

版本描述
3.1.0介绍。

用户贡献的笔记

  2. 跳到注释10内容
    法典
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：2你必须登录才能对这个便条的帮助进行投票

    显示辅助按钮
    WordPress对次要按钮和主要按钮的样式不同。主按钮是蓝色的，比灰色的辅助按钮更突出。默认情况下，提交按钮（）输出一个主按钮。要显示辅助按钮，请将$类型参数到“次要”:

    submit_button（__（'重置'，'文本域'），'辅助'）；
  3. 跳到注释11内容
    食品法典委员会
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：2你必须登录才能对这个便条的帮助进行投票

    显示删除按钮
    默认情况下，WordPress目前似乎没有针对删除按钮的自定义样式，但它确实为它们提供了'删除'HTML类。然而，未来可能会发生变化，因此最好指定$类型作为'删除'显示删除按钮时：

    submit_button（__（“删除”，“文本域”），“删除”）；

    默认情况下，删除按钮将显示为辅助按钮，而不是主按钮。如果要将其显示为主按钮，可以这样做：

    submit_button（__（'Delete'，'textdomain'），'Delete button-primary'）；
  4. 跳到注释12内容
    食品法典委员会
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：1你必须登录才能对这个便条的帮助进行投票

    使用$name参数
    这个$名称如果要设置按钮的HTML名称属性，则可以使用参数。默认情况下，这将是'提交'.

    submit_button（__（'保存设置'，'文本域'），'主'，'wpdocs-Save-Settings'）；

    默认情况下$名称也用于填写按钮的身份证件属性。要更改此设置，可以传递身份证件通过$其他属性参数：

    $other_attributes=数组（“id”=>“wpdocs-button-id”）；submit_button（__（'保存设置'，'文本域'），'主'，'wpdocs-Save-Settings'，true，$other_attributes）；
  5. 跳到注释13内容
    食品法典委员会
    你必须登录才能对这个便条的帮助进行投票此备注的投票结果：1你必须登录才能对这个便条的帮助进行投票

    使用$wrap参数
    这个$包装参数控制按钮是否包装在段落标记中，默认情况下是这样的。这可能是一种帮助或阻碍，具体取决于您希望如何显示按钮。要关闭此行为，请传递假对于第四个参数：

    submit_button（__（'提交'，'文本域'），'主'，'提交表单'，false）；
  8. 跳到注释16内容
    塞德里克·莫里斯·凯利
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：0你必须登录才能对这个便条的帮助进行投票

    这个例子显示了一个插件选项页面表单，其中有两个提交按钮，每个按钮都有不同的用途。

    <form method=“post”><?php（电话）settings_fields（'wpdocs-fields-settings'）；do_settings_sections（'wpdocs-sections-settings'）；/*带有“保存更改”文本的默认提交按钮*/submit_button（）；/*自定义提交按钮的其他属性*/$attributes=数组（“id”=>“wpdocs-field-id”）；/*自定义提交按钮*/提交按钮（esc_html__（“我的操作”，“text_domain”），//按钮文本，本地化“primary”，//按钮的CSS类“wpdocs-input-name”，//按钮的“name”属性，用于在POST数据中标识它true，//将按钮包装在<p>标记中$attributes//其他属性，如“id”); ?></form>

你必须登录在能够发表注释或反馈之前。