块使用唯一的基于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是在服务器端生成的,而不是存储在数据库中。
其他资源