块的标记表示

块使用唯一的基于HTML的语法,以用作明确块分隔符的HTML注释进行区分。这样可以确保块标记在技术上是有效的HTML。

以下是定义块的标记的一些准则:

  • 核心模块以工作包:前缀,后跟块名(例如。,wp:图像). 值得注意的是核心命名空间被省略。
  • 自定义块以工作包:前缀,后跟块名称空间和名称(例如。,wp:名称空间/名称).
  • 注释可以是单行、自动关闭或HTML内容的包装器。
  • 块设置和属性存储为块注释内的JSON对象。

以下是图像块的简化标记表示:

<!-- wp:image{“sizeSlug”:“large”}--><图class=“wp-block-image size-large”><img src=“source.jpg”alt=“”/></图><!-- /wp:图像-->

块的标记在块编辑器中以及在前端显示块时都至关重要:

  • WordPress在编辑器中分析块的标记,以提取其数据并将可编辑版本呈现给用户。
  • 在前端,WordPress再次解析标记以提取数据并呈现最终的HTML输出。
请参阅数据流这篇文章更深入地研究了块数据在WordPress中的解析方式。

保存块时节约函数定义的时间块已在客户端中注册-执行以生成存储在数据库中的标记,并包装在块分隔符注释中。对于动态渲染块,通常设置节约无效的,仅保存带有块属性的占位符注释。

下面是动态呈现块的标记表示(节约=无效的). 请注意,除了注释之外,没有HTML标记。

<!-- wp:latest-posts{“postsToShow”:4,“displayPostDate”:true}/-->

当块具有节约函数,块编辑器检查节约函数与保存到数据库中的块标记相同:

  • 差异将触发验证错误,通常是由于节约函数的输出。
  • 开发人员可以通过实现阻止弃用解释变化。

如上例所示,对于动态呈现的块,存储的标记是最小的。通常,这只是包含块属性的分隔符注释,不受块编辑器的验证。这种方法反映了这些块的动态特性,其中实际的HTML是在服务器端生成的,而不是存储在数据库中。

其他资源