云策 WordPress 开发者社区

函数文档

remove_block_asset_path_prefix()

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

概述

remove_block_asset_path_prefix() 函数用于移除块资产路径的前缀，如果提供了前缀的话。它处理资产句柄或带前缀的路径，返回去除前缀后的路径或原始值。

关键要点

  • 函数接受一个参数 $asset_handle_or_path，可以是资产句柄或带前缀的路径。
  • 如果路径以 'file:' 前缀开头，则移除该前缀；如果移除后以 './' 开头，则进一步移除 './'。
  • 返回处理后的路径或原始值，确保路径格式正确。

代码示例

function remove_block_asset_path_prefix( $asset_handle_or_path ) {
	$path_prefix = 'file:';
	if ( ! str_starts_with( $asset_handle_or_path, $path_prefix ) ) {
		return $asset_handle_or_path;
	}
	$path = substr(
		$asset_handle_or_path,
		strlen( $path_prefix )
	);
	if ( str_starts_with( $path, './' ) ) {
		$path = substr( $path, 2 );
	}
	return $path;
}
📄 原文内容

Removes the block asset’s path prefix if provided.

Parameters

$asset_handle_or_pathstringrequired
Asset handle or prefixed path.

Return

string Path without the prefix or the original value.

Source

function remove_block_asset_path_prefix( $asset_handle_or_path ) {
	$path_prefix = 'file:';
	if ( ! str_starts_with( $asset_handle_or_path, $path_prefix ) ) {
		return $asset_handle_or_path;
	}
	$path = substr(
		$asset_handle_or_path,
		strlen( $path_prefix )
	);
	if ( str_starts_with( $path, './' ) ) {
		$path = substr( $path, 2 );
	}
	return $path;
}

View all references View on Trac View on GitHub

Used by Description
register_block_script_module_id()wp-includes/blocks.php

Finds a script module ID for the selected block metadata field. It detects when a path to file was provided and optionally finds a corresponding asset file with details necessary to register the script module under with an automatically generated module ID. It returns unprocessed script module ID otherwise.
register_block_script_handle()wp-includes/blocks.php

Finds a script handle for the selected block metadata field. It detects when a path to file was provided and optionally finds a corresponding asset file with details necessary to register the script under automatically generated handle name. It returns unprocessed script handle otherwise.
register_block_style_handle()wp-includes/blocks.php

Finds a style handle for the block metadata field. It detects when a path to file was provided and registers the style under automatically generated handle name. It returns unprocessed style handle otherwise.
register_block_type_from_metadata()wp-includes/blocks.php

Registers a block type from the metadata stored in the block.json file.

Changelog

Version Description
5.5.0 Introduced.