W3cubDocs

/WordPress

Walker_CategoryDropdown::start_el( string $output, object $category, int $depth, array $args = array(), int $id )

Starts the element output.

Description

See also

Parameters

$output

(string) (Required) Used to append additional content (passed by reference).

$category

(object) (Required) Category data object.

$depth

(int) (Required) Depth of category. Used for padding.

$args

(array) (Optional) Uses 'selected', 'show_count', and 'value_field' keys, if they exist. See wp_dropdown_categories().

Default value: array()

$id

(int) (Optional) ID of the current category. Default 0 (unused).

Source

File: wp-includes/class-walker-category-dropdown.php 

public function start_el( &$output, $category, $depth = 0, $args = array(), $id = 0 ) {
		$pad = str_repeat( ' ', $depth * 3 );

		/** This filter is documented in wp-includes/category-template.php */
		$cat_name = apply_filters( 'list_cats', $category->name, $category );

		if ( isset( $args['value_field'] ) && isset( $category->{$args['value_field']} ) ) {
			$value_field = $args['value_field'];
		} else {
			$value_field = 'term_id';
		}

		$output .= "\t<option class=\"level-$depth\" value=\"" . esc_attr( $category->{$value_field} ) . '"';

		// Type-juggling causes false matches, so we force everything to a string.
		if ( (string) $category->{$value_field} === (string) $args['selected'] ) {
			$output .= ' selected="selected"';
		}
		$output .= '>';
		$output .= $pad . $cat_name;
		if ( $args['show_count'] ) {
			$output .= '&nbsp;&nbsp;(' . number_format_i18n( $category->count ) . ')';
		}
		$output .= "</option>\n";
	}

Uses

Uses Description
wp-includes/category-template.php: list_cats

Filters a taxonomy drop-down display element.
wp-includes/formatting.php: esc_attr()

Escaping for HTML attributes.
wp-includes/functions.php: number_format_i18n()

Convert float number to format based on the locale.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.

Changelog

Version Description
2.1.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/walker_categorydropdown/start_el