функция
since 5.5.0
generate_block_asset_handle()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
generate_block_asset_handle( string $block_name, string $field_name, int $index ): string
Описание
Генерирует имя ресурса на основе имени блока и указанного имени поля.
Параметры
$block_name
string
обязательный
Имя блока.
$field_name
string
обязательный
Имя поля метаданных.
$index
int
необязательный
Индекс ресурса, когда передано несколько элементов.
Значение по умолчанию 0.
Возвращаемое значение
string
Исходный код
wp-includes/blocks.php:47
function generate_block_asset_handle( $block_name, $field_name, $index = 0 ) {
if ( str_starts_with( $block_name, 'core/' ) ) {
$asset_handle = str_replace( 'core/', 'wp-block-', $block_name );
if ( str_starts_with( $field_name, 'editor' ) ) {
$asset_handle .= '-editor';
}
if ( str_starts_with( $field_name, 'view' ) ) {
$asset_handle .= '-view';
}
if ( str_ends_with( strtolower( $field_name ), 'scriptmodule' ) ) {
$asset_handle .= '-script-module';
}
if ( $index > 0 ) {
$asset_handle .= '-' . ( $index + 1 );
}
return $asset_handle;
}
$field_mappings = array(
'editorScript' => 'editor-script',
'editorStyle' => 'editor-style',
'script' => 'script',
'style' => 'style',
'viewScript' => 'view-script',
'viewScriptModule' => 'view-script-module',
'viewStyle' => 'view-style',
);
$asset_handle = str_replace( '/', '-', $block_name ) .
'-' . $field_mappings[ $field_name ];
if ( $index > 0 ) {
$asset_handle .= '-' . ( $index + 1 );
}
return $asset_handle;
}
История изменений
| Версия | Описание |
|---|---|
| 6.5.0 | Added support for viewScriptModule field. |
| 6.1.0 | Added $index parameter. |
| 5.5.0 | Introduced. |

