add_meta_box()

热度:69
Function: 向一个或多个屏幕添加元框。
版本 20190729
所属分类 Functions
可使用页面 All
默认值

add_meta_box( string $id, string $title, callable $callback, string|array|WP_Screen $screen = null, string $context = 'advanced', string $priority = 'default', array $callback_args = null )

  • 向一个或多个屏幕添加元框。


参数:

$id

(string) (Required) 元框ID(用于元框的'id'属性)。


$title

(string) (Required) 元框的标题。


$callback

(callable) (Required) 用所需内容填充框的功能。该函数应该回显其输出。


$screen

(string|array|WP_Screen) (Optional) 显示框的屏幕(例如帖子类型,“链接”或“注释”)。接受单个屏幕ID,WP_Screen对象或屏幕ID数组。默认为当前屏幕。如果您使用add_menu_page()或 add_submenu_page()来创建新屏幕(以及screen_id),请确保您的菜单slug符合sanitize_key()的限制 否则“屏幕”菜单可能无法在您的页面上正确呈现。

Default value(默认值): null


$context

(string) (Optional) 屏幕中应显示框的上下文。可用的上下文因屏幕而异。后期编辑屏幕上下文包括“正常”,“侧面”和“高级”。评论屏幕上下文包括“正常”和“侧面”。菜单元框(手风琴部分)都使用“侧面”上下文。全球

Default value(默认值): 'advanced'


$priority

(string) (Optional) 框应显示的上下文中的优先级(“高”,“低”)。

Default value(默认值): 'default'


$callback_args

(array) (Optional) 应设置为box数组的$ args属性的数据(这是传递给回调的第二个参数)。

Default value(默认值): null


示例:

function add_meta_box( $id, $title, $callback, $screen = null, $context = 'advanced', $priority = 'default', $callback_args = null ) {

    global $wp_meta_boxes;

 

    if ( empty( $screen ) ) {

        $screen = get_current_screen();

    } elseif ( is_string( $screen ) ) {

        $screen = convert_to_screen( $screen );

    } elseif ( is_array( $screen ) ) {

        foreach ( $screen as $single_screen ) {

            add_meta_box( $id, $title, $callback, $single_screen, $context, $priority, $callback_args );

        }

问题反馈反馈和建议QQ群:785318993