# _block_bindings_term_data_get_value()

URL: https://chugunov.pro/api-wordpress/functions/_block_bindings_term_data_get_value/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 6.9.0.

## Сигнатура

```php
_block_bindings_term_data_get_value( array $source_args, WP_Block $block_instance ): mixed
```

## Описание

Получает значение для источника данных термина (Term Data).

## Параметры

- `$source_args` `array` — обязательный. Массив с аргументами источника, используемыми для поиска переопределяющего значения.
  
  Пример: array( "field" => "name" ).
- `$block_instance` `WP_Block` — обязательный. Экземпляр блока.

## Возвращаемое значение

`mixed`

## Исходный код

Файл: `wp-includes/block-bindings/term-data.php:21`

```php
function _block_bindings_term_data_get_value( array $source_args, $block_instance ) {
	if ( empty( $source_args['field'] ) ) {
		return null;
	}

	/*
	 * BACKWARDS COMPATIBILITY: Hardcoded exception for navigation blocks.
	 * Required for WordPress 6.9+ navigation blocks. DO NOT REMOVE.
	 */
	$block_name          = $block_instance->name ?? '';
	$is_navigation_block = in_array(
		$block_name,
		array( 'core/navigation-link', 'core/navigation-submenu' ),
		true
	);

	if ( $is_navigation_block ) {
		// Navigation blocks: read from block attributes.
		$term_id = $block_instance->attributes['id'] ?? null;
		$type    = $block_instance->attributes['type'] ?? '';
		// Map UI shorthand to taxonomy slug when using attributes.
		$taxonomy = ( 'tag' === $type ) ? 'post_tag' : $type;
	} else {
		// All other blocks: use context
		$term_id  = $block_instance->context['termId'] ?? null;
		$taxonomy = $block_instance->context['taxonomy'] ?? '';
	}

	// If we don't have required identifiers, bail early.
	if ( empty( $term_id ) || empty( $taxonomy ) ) {
		return null;
	}

	// Get the term data.
	$term = get_term( $term_id, $taxonomy );
	if ( is_wp_error( $term ) || ! $term ) {
		return null;
	}

	// Check if taxonomy exists and is publicly queryable.
	$taxonomy_object = get_taxonomy( $taxonomy );
	if ( ! $taxonomy_object || ! $taxonomy_object->publicly_queryable ) {
		if ( ! current_user_can( 'read' ) ) {
			return null;
		}
	}

	switch ( $source_args['field'] ) {
		case 'id':
			return esc_html( (string) $term_id );

		case 'name':
			return esc_html( $term->name );

		case 'link':
			// Only taxonomy entities are supported by Term Data.
			$term_link = get_term_link( $term );
			return is_wp_error( $term_link ) ? null : esc_url( $term_link );

		case 'slug':
			return esc_html( $term->slug );

		case 'description':
			return wp_kses_post( $term->description );

		case 'parent':
			return esc_html( (string) $term->parent );

		case 'count':
			return esc_html( (string) $term->count );

		default:
			return null;
	}
}
```

## История изменений

- 6.9.0 — Introduced.

## Связанные

Использует: [`wp_kses_post`](https://chugunov.pro/api-wordpress/functions/wp_kses_post/), [`get_term_link`](https://chugunov.pro/api-wordpress/functions/get_term_link/), [`current_user_can`](https://chugunov.pro/api-wordpress/functions/current_user_can/), [`esc_html`](https://chugunov.pro/api-wordpress/functions/esc_html/), [`esc_url`](https://chugunov.pro/api-wordpress/functions/esc_url/), [`get_term`](https://chugunov.pro/api-wordpress/functions/get_term/), [`get_taxonomy`](https://chugunov.pro/api-wordpress/functions/get_taxonomy/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/_block_bindings_term_data_get_value/