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. |