WordPress开发函数add_screen_option(),注册和配置管理屏幕选项。
add_screen_option( string $option, mixed $args = array() )
$option
(string) (必需) 一个选项名称。
$args
(mixed) (可选) Option-dependent参数。
默认值: array()
文件: wp-admin/includes/screen.php
function add_screen_option( $option, $args = array() ) {
$current_screen = get_current_screen();
if ( ! $current_screen ) {
return;
}
$current_screen->add_option( $option, $args );
}
(由Codex - 5年前贡献)
例子
更改网络仪表板的默认列
add_action( 'wp_network_dashboard_setup', function() {
add_screen_option( 'layout_columns', array( 'default' => 2 ) );
} );
(由giangel84 - 1年前贡献)
$option参数定义对象(输入或单选按钮),它将被打印到屏幕选项部分。
只能接受2个方法:
1. “per_page”
2. “layout_columns”
示例1:
add_screen_option( 'per_page', array( 'label' => 'My Label', 'default' => 1, 'option' => 'option_name' ) );
将打印
<input type="number" step="1" min="1" max="999" class="screen-per-page" name="wp_screen_options[value]" id="option_name" maxlength="3" value="1">
示例2:
add_screen_option( 'layout_columns', array( 'max' => 2, 'default' => 2 ) );
将打印
<input type="radio" name="screen_columns" value="1">
<input type="radio" name="screen_columns" value="2" checked="checked">
add_screen_option还不支持复选框方法。