云策 WordPress 开发者社区

函数文档

get_block_metadata_i18n_schema()

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

概述

get_block_metadata_i18n_schema() 函数用于获取从 block.json 文件读取的块元数据的国际化（i18n）模式。它返回一个对象，表示块元数据的模式。

关键要点

  • 函数返回块元数据的 i18n 模式，基于 block-i18n.json 文件。
  • 使用 wp_json_file_decode() 读取和解析 JSON 文件，确保高效的单次加载。
  • 主要用于 register_block_type_from_metadata() 函数，以支持块类型的国际化注册。
  • 自 WordPress 5.9.0 版本引入。
📄 原文内容

Gets i18n schema for block’s metadata read from block.json file.

Return

object The schema for block’s metadata.

Source

function get_block_metadata_i18n_schema() {
	static $i18n_block_schema;

	if ( ! isset( $i18n_block_schema ) ) {
		$i18n_block_schema = wp_json_file_decode( __DIR__ . '/block-i18n.json' );
	}

	return $i18n_block_schema;
}

View all references View on Trac View on GitHub

Uses Description
wp_json_file_decode()wp-includes/functions.php

Reads and decodes a JSON file.
Used by Description
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.9.0 Introduced.