Docs: Replace "html" and "xhtml" instances in DocBlocks and comments with "HTML" and "XHTML".

This ensures consistent capitalization where appropriate.

Props navidos, desrosj.
Fixes #50473.
Built from https://develop.svn.wordpress.org/trunk@48199


git-svn-id: http://core.svn.wordpress.org/trunk@47968 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2020-06-28 14:02:06 +00:00
parent c892c420b7
commit 3336009e34
13 changed files with 151 additions and 129 deletions

View File

@ -169,7 +169,7 @@ function get_image_send_to_editor( $id, $caption, $title, $align, $url = '', $re
}
/**
* Adds image shortcode with caption to editor
* Adds image shortcode with caption to editor.
*
* @since 2.6.0
*
@ -248,7 +248,7 @@ function image_add_caption( $html, $id, $caption, $title, $align, $url, $size, $
}
/**
* Private preg_replace callback used in image_add_caption()
* Private preg_replace callback used in image_add_caption().
*
* @access private
* @since 3.4.0
@ -259,7 +259,7 @@ function _cleanup_image_add_caption( $matches ) {
}
/**
* Adds image html to editor
* Adds image HTML to editor.
*
* @since 2.5.0
*
@ -276,15 +276,15 @@ function media_send_to_editor( $html ) {
}
/**
* Save a file submitted from a POST request and create an attachment post for it.
* Saves a file submitted from a POST request and create an attachment post for it.
*
* @since 2.5.0
*
* @param string $file_id Index of the `$_FILES` array that the file was sent. Required.
* @param int $post_id The post ID of a post to attach the media item to. Required, but can
* be set to 0, creating a media item that has no relationship to a post.
* @param array $post_data Overwrite some of the attachment. Optional.
* @param array $overrides Override the wp_handle_upload() behavior. Optional.
* @param array $post_data Optional. Overwrite some of the attachment.
* @param array $overrides Optional. Override the wp_handle_upload() behavior.
* @return int|WP_Error ID of the attachment or a WP_Error object on failure.
*/
function media_handle_upload( $file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false ) ) {

View File

@ -923,7 +923,7 @@ function parent_dropdown( $default = 0, $parent = 0, $level = 0, $post = null )
}
/**
* Print out option html elements for role selectors.
* Print out option HTML elements for role selectors.
*
* @since 2.1.0
*
@ -1566,7 +1566,7 @@ function add_settings_section( $id, $title, $callback, $page ) {
* do_settings_fields() in do_settings-sections()
*
* The $callback argument should be the name of a function that echoes out the
* html input tags for this setting field. Use get_option() to retrieve existing
* HTML input tags for this setting field. Use get_option() to retrieve existing
* values to show.
*
* @since 2.7.0
@ -1918,7 +1918,7 @@ function find_posts_div( $found_action = '' ) {
/**
* Displays the post password.
*
* The password is passed through esc_attr() to ensure that it is safe for placing in an html attribute.
* The password is passed through esc_attr() to ensure that it is safe for placing in an HTML attribute.
*
* @since 2.7.0
*/

View File

@ -70,7 +70,7 @@ function twentytwenty_site_logo( $args = array(), $echo = true ) {
/**
* Filters the arguments for `twentytwenty_site_logo()`.
*
* @param string $html Compiled html based on our arguments.
* @param string $html Compiled HTML based on our arguments.
* @param array $args Parsed arguments.
* @param string $classname Class name based on current view, home or single.
* @param string $contents HTML for site title or logo.
@ -103,7 +103,7 @@ function twentytwenty_site_description( $echo = true ) {
$html = sprintf( $wrapper, esc_html( $description ) );
/**
* Filters the html for the site description.
* Filters the HTML for the site description.
*
* @since Twenty Twenty 1.0
*
@ -326,7 +326,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
<?php
/**
* Fires before post meta html display.
* Fires before post meta HTML display.
*
* Allow output of additional post meta info to be added by child themes and plugins.
*
@ -453,7 +453,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
}
/**
* Fires after post meta html display.
* Fires after post meta HTML display.
*
* Allow output of additional post meta info to be added by child themes and plugins.
*

View File

@ -55,7 +55,7 @@ class WP_Ajax_Response {
* @type int|false $old_id The previous response ID. Used as the value for the response type
* `old_id` attribute. False hides the attribute. Default false.
* @type string $position Value of the response type `position` attribute. Accepts 1 (bottom),
* -1 (top), html ID (after), or -html ID (before). Default 1 (bottom).
* -1 (top), HTML ID (after), or -HTML ID (before). Default 1 (bottom).
* @type string|WP_Error $data The response content/message. Also accepts a WP_Error object if the
* ID does not exist. Default empty.
* @type array $supplemental An array of extra strings that will be output within a `<supplemental>`

View File

@ -1127,7 +1127,7 @@ final class WP_Customize_Nav_Menus {
}
/**
* Print the html template used to render the add-menu-item frame.
* Print the HTML template used to render the add-menu-item frame.
*
* @since 4.3.0
*/

View File

@ -2734,7 +2734,7 @@ function discover_pingback_server_uri( $url, $deprecated = '' ) {
return false;
}
// Now do a GET since we're going to look in the html headers (and we're sure it's not a binary file).
// Now do a GET since we're going to look in the HTML headers (and we're sure it's not a binary file).
$response = wp_safe_remote_get(
$url,
array(

View File

@ -379,18 +379,23 @@ function user_can_edit_user($user_id, $other_user) {
* @deprecated 2.1.0 Use get_bookmarks()
* @see get_bookmarks()
*
* @param string $cat_name Optional. The category name to use. If no match is found uses all.
* @param string $before Optional. The html to output before the link.
* @param string $after Optional. The html to output after the link.
* @param string $between Optional. The html to output between the link/image and its description. Not used if no image or $show_images is true.
* @param bool $show_images Optional. Whether to show images (if defined).
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner.
* If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which will return links in a
* random order.
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
* @param bool $show_rating Optional. Show rating stars/chars.
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
* @param int $show_updated Optional. Whether to show last updated timestamp
* @param string $cat_name Optional. The category name to use. If no match is found, uses all.
* Default 'noname'.
* @param string $before Optional. The HTML to output before the link. Default empty.
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
* @param string $between Optional. The HTML to output between the link/image and its description.
* Not used if no image or $show_images is true. Default ' '.
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
* 'description', 'rating', or 'owner'. Default 'id'.
* If you start the name with an underscore, the order will be reversed.
* Specifying 'rand' as the order will return links in a random order.
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
* Default true.
* @param bool $show_rating Optional. Show rating stars/chars. Default false.
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
* Default -1.
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 0.
*/
function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
$show_description = true, $show_rating = false,
@ -447,11 +452,14 @@ function wp_get_linksbyname($category, $args = '') {
* @deprecated 2.1.0 Use get_bookmarks()
* @see get_bookmarks()
*
* @param string $cat_name The category name to use. If no match is found uses all.
* @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.
* Or maybe owner. If you start the name with an underscore the order will be reversed. You can also
* specify 'rand' as the order which will return links in a random order.
* @param int $limit Limit to X entries. If not specified, all entries are shown.
* @param string $cat_name Optional. The category name to use. If no match is found, uses all.
* Default 'noname'.
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
* 'description', 'rating', or 'owner'. Default 'name'.
* If you start the name with an underscore, the order will be reversed.
* Specifying 'rand' as the order will return links in a random order.
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
* Default -1.
* @return array
*/
function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
@ -497,12 +505,14 @@ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit
* @deprecated 2.1.0 Use get_bookmarks()
* @see get_bookmarks()
*
* @param int $category The category to use. If no category supplied uses all
* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
* 'description', or 'rating'. Or maybe owner. If you start the name with an
* underscore the order will be reversed. You can also specify 'rand' as the
* order which will return links in a random order.
* @param int $limit Limit to X entries. If not specified, all entries are shown.
* @param int $category Optional. The category to use. If no category supplied, uses all.
* Default 0.
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
* 'description', 'rating', or 'owner'. Default 'name'.
* If you start the name with an underscore, the order will be reversed.
* Specifying 'rand' as the order will return links in a random order.
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
* Default 0.
* @return array
*/
function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
@ -524,18 +534,22 @@ function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
* @deprecated 2.1.0 Use get_bookmarks()
* @see get_bookmarks()
*
* @param string $cat_name The category name to use. If no match is found uses all
* @param string $before The html to output before the link
* @param string $after The html to output after the link
* @param string $between The html to output between the link/image and its description. Not used if no image or show_images is true
* @param bool $show_images Whether to show images (if defined).
* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
* 'description', or 'rating'. Or maybe owner. If you start the name with an
* underscore the order will be reversed. You can also specify 'rand' as the
* order which will return links in a random order.
* @param bool $show_description Whether to show the description if show_images=false/not defined
* @param int $limit Limit to X entries. If not specified, all entries are shown.
* @param int $show_updated Whether to show last updated timestamp
* @param string $cat_name Optional. The category name to use. If no match is found, uses all.
* Default 'noname'.
* @param string $before Optional. The HTML to output before the link. Default empty.
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
* @param string $between Optional. The HTML to output between the link/image and its description.
* Not used if no image or $show_images is true. Default ' '.
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
* 'description', 'rating', or 'owner'. Default 'id'.
* If you start the name with an underscore, the order will be reversed.
* Specifying 'rand' as the order will return links in a random order.
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
* Default true.
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
* Default -1.
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 0.
*/
function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
@ -551,18 +565,22 @@ function get_linksbyname_withrating($cat_name = "noname", $before = '', $after =
* @deprecated 2.1.0 Use get_bookmarks()
* @see get_bookmarks()
*
* @param int $category The category to use. If no category supplied uses all
* @param string $before The html to output before the link
* @param string $after The html to output after the link
* @param string $between The html to output between the link/image and its description. Not used if no image or show_images == true
* @param bool $show_images Whether to show images (if defined).
* @param string $orderby The order to output the links. E.g. 'id', 'name', 'url',
* 'description', or 'rating'. Or maybe owner. If you start the name with an
* underscore the order will be reversed. You can also specify 'rand' as the
* order which will return links in a random order.
* @param bool $show_description Whether to show the description if show_images=false/not defined.
* @param int $limit Limit to X entries. If not specified, all entries are shown.
* @param int $show_updated Whether to show last updated timestamp
* @param int $category Optional. The category to use. If no category supplied, uses all.
* Default 0.
* @param string $before Optional. The HTML to output before the link. Default empty.
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
* @param string $between Optional. The HTML to output between the link/image and its description.
* Not used if no image or $show_images is true. Default ' '.
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
* 'description', 'rating', or 'owner'. Default 'id'.
* If you start the name with an underscore, the order will be reversed.
* Specifying 'rand' as the order will return links in a random order.
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
* Default true.
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
* Default -1.
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 0.
*/
function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
$orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
@ -904,21 +922,24 @@ function wp_get_links($args = '') {
* @deprecated 2.1.0 Use get_bookmarks()
* @see get_bookmarks()
*
* @param int $category The category to use. If no category supplied uses all
* @param string $before the html to output before the link
* @param string $after the html to output after the link
* @param string $between the html to output between the link/image and its description.
* Not used if no image or show_images == true
* @param bool $show_images whether to show images (if defined).
* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
* 'description', or 'rating'. Or maybe owner. If you start the name with an
* underscore the order will be reversed. You can also specify 'rand' as the order
* which will return links in a random order.
* @param bool $show_description whether to show the description if show_images=false/not defined.
* @param bool $show_rating show rating stars/chars
* @param int $limit Limit to X entries. If not specified, all entries are shown.
* @param int $show_updated whether to show last updated timestamp
* @param bool $echo whether to echo the results, or return them instead
* @param int $category Optional. The category to use. If no category supplied uses all.
* Default 0.
* @param string $before Optional. The HTML to output before the link. Default empty.
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
* @param string $between Optional. The HTML to output between the link/image and its description.
* Not used if no image or $show_images is true. Default ' '.
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
* 'description', 'rating', or 'owner'. Default 'name'.
* If you start the name with an underscore, the order will be reversed.
* Specifying 'rand' as the order will return links in a random order.
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
* Default true.
* @param bool $show_rating Optional. Show rating stars/chars. Default false.
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
* Default -1.
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 1.
* @param bool $echo Whether to echo the results, or return them instead.
* @return null|string
*/
function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
@ -1628,30 +1649,31 @@ function the_author_ID() {
/**
* Display the post content for the feed.
*
* For encoding the html or the $encode_html parameter, there are three possible
* values. '0' will make urls footnotes and use make_url_footnote(). '1' will
* encode special characters and automatically display all of the content. The
* value of '2' will strip all HTML tags from the content.
* For encoding the HTML or the $encode_html parameter, there are three possible values:
* - '0' will make urls footnotes and use make_url_footnote().
* - '1' will encode special characters and automatically display all of the content.
* - '2' will strip all HTML tags from the content.
*
* Also note that you cannot set the amount of words and not set the html
* encoding. If that is the case, then the html encoding will default to 2,
* which will strip all HTML tags.
* Also note that you cannot set the amount of words and not set the HTML encoding.
* If that is the case, then the HTML encoding will default to 2, which will strip
* all HTML tags.
*
* To restrict the amount of words of the content, you can use the cut
* parameter. If the content is less than the amount, then there won't be any
* dots added to the end. If there is content left over, then dots will be added
* and the rest of the content will be removed.
* To restrict the amount of words of the content, you can use the cut parameter.
* If the content is less than the amount, then there won't be any dots added to the end.
* If there is content left over, then dots will be added and the rest of the content
* will be removed.
*
* @since 0.71
*
* @deprecated 2.9.0 Use the_content_feed()
* @see the_content_feed()
*
* @param string $more_link_text Optional. Text to display when more content is available but not displayed.
* @param int $stripteaser Optional. Default is 0.
* @param string $more_file Optional.
* @param int $cut Optional. Amount of words to keep for the content.
* @param int $encode_html Optional. How to encode the content.
* @param string $more_link_text Optional. Text to display when more content is available
* but not displayed. Default '(more...)'.
* @param int $stripteaser Optional. Default 0.
* @param string $more_file Optional.
* @param int $cut Optional. Amount of words to keep for the content.
* @param int $encode_html Optional. How to encode the content.
*/
function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
_deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed()' );
@ -1704,7 +1726,7 @@ function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file
* @since 0.71
* @deprecated 2.9.0
*
* @param string $content Content to get links
* @param string $content Content to get links.
* @return string HTML stripped out of content with links at the bottom.
*/
function make_url_footnote( $content ) {
@ -1742,9 +1764,9 @@ function make_url_footnote( $content ) {
* @deprecated 2.9.0 Use _x()
* @see _x()
*
* @param string $text Text to translate
* @param string $domain Optional. Domain to retrieve the translated text
* @return string Translated context string without pipe
* @param string $text Text to translate.
* @param string $domain Optional. Domain to retrieve the translated text.
* @return string Translated context string without pipe.
*/
function _c( $text, $domain = 'default' ) {
_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
@ -1759,9 +1781,9 @@ function _c( $text, $domain = 'default' ) {
* @deprecated 3.0.0 Use _x()
* @see _x()
*
* @param string $text Text to translate
* @param string $domain Domain to retrieve the translated text
* @return string Translated text
* @param string $text Text to translate.
* @param string $domain Domain to retrieve the translated text.
* @return string Translated text.
*/
function translate_with_context( $text, $domain = 'default' ) {
_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );

View File

@ -535,12 +535,12 @@ function atom_enclosure() {
/**
* Determine the type of a string of data with the data formatted.
*
* Tell whether the type is text, html, or xhtml, per RFC 4287 section 3.1.
* Tell whether the type is text, HTML, or XHTML, per RFC 4287 section 3.1.
*
* In the case of WordPress, text is defined as containing no markup,
* xhtml is defined as "well formed", and html as tag soup (i.e., the rest).
* XHTML is defined as "well formed", and HTML as tag soup (i.e., the rest).
*
* Container div tags are added to xhtml values, per section 3.1.1.3.
* Container div tags are added to XHTML values, per section 3.1.1.3.
*
* @link http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.3.1
*

View File

@ -928,7 +928,7 @@ function seems_utf8( $str ) {
* double if set to 'double' or both if otherwise set.
* Default is ENT_NOQUOTES.
* @param false|string $charset Optional. The character encoding of the string. Default false.
* @param bool $double_encode Optional. Whether to encode existing html entities. Default false.
* @param bool $double_encode Optional. Whether to encode existing HTML entities. Default false.
* @return string The encoded text with HTML entities.
*/
function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
@ -5136,7 +5136,7 @@ function wp_sprintf_l( $pattern, $args ) {
}
/**
* Safely extracts not more than the first $count characters from html string.
* Safely extracts not more than the first $count characters from HTML string.
*
* UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT*
* be counted as one character. For example &amp; will be counted as 4, &lt; as
@ -6013,7 +6013,7 @@ function sanitize_hex_color( $color ) {
*
* Saving hex colors without a hash puts the burden of adding the hash on the
* UI, which makes it difficult to use or upgrade to other color types such as
* rgba, hsl, rgb, and html color names.
* rgba, hsl, rgb, and HTML color names.
*
* Returns either '', a 3 or 6 digit hex color (without a #), or null.
*

View File

@ -6559,7 +6559,7 @@ function get_tag_regex( $tag ) {
/**
* Retrieve a canonical form of the provided charset appropriate for passing to PHP
* functions such as htmlspecialchars() and charset html attributes.
* functions such as htmlspecialchars() and charset HTML attributes.
*
* @since 3.6.0
* @access private

View File

@ -3915,7 +3915,7 @@ function wp_get_code_editor_settings( $args ) {
* Retrieves the contents of the search WordPress query variable.
*
* The search query string is passed through esc_attr() to ensure that it is safe
* for placing in an html attribute.
* for placing in an HTML attribute.
*
* @since 2.3.0
*
@ -3943,7 +3943,7 @@ function get_search_query( $escaped = true ) {
* Displays the contents of the search query variable.
*
* The search query string is passed through esc_attr() to ensure that it is safe
* for placing in an html attribute.
* for placing in an HTML attribute.
*
* @since 2.1.0
*/
@ -3959,14 +3959,14 @@ function the_search_query() {
}
/**
* Gets the language attributes for the html tag.
* Gets the language attributes for the 'html' tag.
*
* Builds up a set of html attributes containing the text direction and language
* Builds up a set of HTML attributes containing the text direction and language
* information for the page.
*
* @since 4.3.0
*
* @param string $doctype Optional. The type of html document. Accepts 'xhtml' or 'html'. Default 'html'.
* @param string $doctype Optional. The type of HTML document. Accepts 'xhtml' or 'html'. Default 'html'.
*/
function get_language_attributes( $doctype = 'html' ) {
$attributes = array();
@ -3989,27 +3989,27 @@ function get_language_attributes( $doctype = 'html' ) {
$output = implode( ' ', $attributes );
/**
* Filters the language attributes for display in the html tag.
* Filters the language attributes for display in the 'html' tag.
*
* @since 2.5.0
* @since 4.3.0 Added the `$doctype` parameter.
*
* @param string $output A space-separated list of language attributes.
* @param string $doctype The type of html document (xhtml|html).
* @param string $doctype The type of HTML document (xhtml|html).
*/
return apply_filters( 'language_attributes', $output, $doctype );
}
/**
* Displays the language attributes for the html tag.
* Displays the language attributes for the 'html' tag.
*
* Builds up a set of html attributes containing the text direction and language
* Builds up a set of HTML attributes containing the text direction and language
* information for the page.
*
* @since 2.1.0
* @since 4.3.0 Converted into a wrapper for get_language_attributes().
*
* @param string $doctype Optional. The type of html document. Accepts 'xhtml' or 'html'. Default 'html'.
* @param string $doctype Optional. The type of HTML document. Accepts 'xhtml' or 'html'. Default 'html'.
*/
function language_attributes( $doctype = 'html' ) {
echo get_language_attributes( $doctype );
@ -4654,7 +4654,7 @@ function get_the_generator( $type = '' ) {
}
/**
* Outputs the html checked attribute.
* Outputs the HTML checked attribute.
*
* Compares the first two arguments and if identical marks as checked
*
@ -4663,14 +4663,14 @@ function get_the_generator( $type = '' ) {
* @param mixed $checked One of the values to compare
* @param mixed $current (true) The other value to compare if not just true
* @param bool $echo Whether to echo or just return the string
* @return string html attribute or empty string
* @return string HTML attribute or empty string
*/
function checked( $checked, $current = true, $echo = true ) {
return __checked_selected_helper( $checked, $current, $echo, 'checked' );
}
/**
* Outputs the html selected attribute.
* Outputs the HTML selected attribute.
*
* Compares the first two arguments and if identical marks as selected
*
@ -4679,14 +4679,14 @@ function checked( $checked, $current = true, $echo = true ) {
* @param mixed $selected One of the values to compare
* @param mixed $current (true) The other value to compare if not just true
* @param bool $echo Whether to echo or just return the string
* @return string html attribute or empty string
* @return string HTML attribute or empty string
*/
function selected( $selected, $current = true, $echo = true ) {
return __checked_selected_helper( $selected, $current, $echo, 'selected' );
}
/**
* Outputs the html disabled attribute.
* Outputs the HTML disabled attribute.
*
* Compares the first two arguments and if identical marks as disabled
*
@ -4695,14 +4695,14 @@ function selected( $selected, $current = true, $echo = true ) {
* @param mixed $disabled One of the values to compare
* @param mixed $current (true) The other value to compare if not just true
* @param bool $echo Whether to echo or just return the string
* @return string html attribute or empty string
* @return string HTML attribute or empty string
*/
function disabled( $disabled, $current = true, $echo = true ) {
return __checked_selected_helper( $disabled, $current, $echo, 'disabled' );
}
/**
* Outputs the html readonly attribute.
* Outputs the HTML readonly attribute.
*
* Compares the first two arguments and if identical marks as readonly
*
@ -4711,7 +4711,7 @@ function disabled( $disabled, $current = true, $echo = true ) {
* @param mixed $readonly One of the values to compare
* @param mixed $current (true) The other value to compare if not just true
* @param bool $echo Whether to echo or just return the string
* @return string html attribute or empty string
* @return string HTML attribute or empty string
*/
function readonly( $readonly, $current = true, $echo = true ) {
return __checked_selected_helper( $readonly, $current, $echo, 'readonly' );
@ -4729,7 +4729,7 @@ function readonly( $readonly, $current = true, $echo = true ) {
* @param mixed $current (true) The other value to compare if not just true
* @param bool $echo Whether to echo or just return the string
* @param string $type The type of checked|selected|disabled|readonly we are doing
* @return string html attribute or empty string
* @return string HTML attribute or empty string
*/
function __checked_selected_helper( $helper, $current, $echo, $type ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
if ( (string) $helper === (string) $current ) {

View File

@ -2390,7 +2390,7 @@ function safecss_filter_attr( $css, $deprecated = '' ) {
}
/**
* Helper function to add global attributes to a tag in the allowed html list.
* Helper function to add global attributes to a tag in the allowed HTML list.
*
* @since 3.5.0
* @since 5.0.0 Add support for `data-*` wildcard attributes.

View File

@ -13,7 +13,7 @@
*
* @global string $wp_version
*/
$wp_version = '5.5-alpha-48198';
$wp_version = '5.5-alpha-48199';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.