函数文档

screen_options()

💡 云策文档标注

概述

screen_options() 函数用于返回屏幕的每页选项,但自 WordPress 3.3.0 起已被弃用,建议使用 WP_Screen::render_per_page_options() 替代。

关键要点

  • screen_options() 函数已弃用,自 WordPress 3.3.0 起应改用 WP_Screen::render_per_page_options()。
  • 该函数调用 get_current_screen() 获取当前屏幕对象,并渲染每页选项。
  • 相关函数包括 get_current_screen() 和 _deprecated_function(),用于处理屏幕对象和弃用通知。

代码示例

function screen_options( $screen ) {
    _deprecated_function( __FUNCTION__, '3.3.0', '$current_screen->render_per_page_options()' );

    $current_screen = get_current_screen();

    if ( ! $current_screen )
        return '';

    ob_start();
    $current_screen->render_per_page_options();
    return ob_get_clean();
}

注意事项

  • 在开发中应避免使用此弃用函数,以保持代码兼容性和最佳实践。
  • 查看变更日志:3.3.0 版本弃用,2.8.0 版本引入。

📄 原文内容

Returns the screen’s per-page options.

Description

See also

Source

function screen_options( $screen ) {
	_deprecated_function( __FUNCTION__, '3.3.0', '$current_screen->render_per_page_options()' );

	$current_screen = get_current_screen();

	if ( ! $current_screen )
		return '';

	ob_start();
	$current_screen->render_per_page_options();
	return ob_get_clean();
}

Changelog

Version Description
3.3.0 Deprecated. Use WP_Screen::render_per_page_options()
2.8.0 Introduced.