云策 WordPress 开发者社区

函数文档

get_screen_icon()

查看官方原文 ↗
💡 云策文档标注

概述

get_screen_icon() 函数用于检索屏幕图标，但自 WordPress 3.8 版本起已弃用，不再使用。

关键要点

  • 该函数返回一个空字符串，并标记为已弃用，通过 _deprecated_function() 通知开发者。
  • 屏幕图标功能在 WordPress 3.8 及更高版本中已移除，相关代码应避免使用此函数。
  • 函数最初在 3.2.0 版本引入，3.8.0 版本弃用，建议使用替代方法或移除相关调用。

注意事项

在开发或维护插件/主题时，应检查并更新代码，避免使用已弃用的 get_screen_icon() 函数，以确保兼容性和最佳实践。

📄 原文内容

Retrieves the screen icon (no longer used in 3.8+).

Return

string An HTML comment explaining that icons are no longer used.

Source

function get_screen_icon() {
	_deprecated_function( __FUNCTION__, '3.8.0' );
	return '<!-- Screen icons are no longer used as of WordPress 3.8. -->';
}

View all references View on Trac View on GitHub

Uses Description
_deprecated_function()wp-includes/functions.php

Marks a function as deprecated and inform when it has been used.
Used by Description
screen_icon()wp-admin/includes/deprecated.php

Displays a screen icon.

Changelog

Version Description
3.8.0 Deprecated.
3.2.0 Introduced.