那么,支持的值的完整列表是什么?
可用格式类型的列表保存在core/rich-text
百货商店您可以通过在浏览器控制台中运行此代码来查询存储,该控制台将返回一个包含以下格式类型的数组:
wp.data.select( \'core/rich-text\' ).getFormatTypes();
截至编写时,共有10种默认/核心格式类型:
bold
,
code
,
image
,
italic
,
link
,
strikethrough
,
underline
,
text-color
,
subscript
, 和
superscript
. (注意:我故意省略了名称空间
core
如中所示
core/bold
.)
References: Introduction to the Format API » Register a New Format 以及@wordpress/format-library
package.
但是formattingControls
已弃用。使用allowedFormats
取而代之的是
The
formattingControls
prop(erty),虽然在写作时仍然有效,但长期以来
deprecated (2019年8月),您现在应该使用其替代品:
allowedFormats
.
二者都allowedFormats
和formattingControls
接受格式名称数组,但有两个区别:
带formattingControls
, 您不需要指定名称空间,即如果全名为core/bold
, 您只需使用bold
.
其次,不支持自定义格式类型-它们不会导致任何错误,但也不会出现在富文本工具栏中(或添加到富文本工具栏中)。
带有allowedFormats
, 您需要指定包含命名空间的完整格式名称,例如。core/bold
和core/italic
.
那是因为allowedFormats
支持自定义格式类型。例如,如果您已注册sample format here (已命名my-custom-format/sample-output
), 然后你会设置allowedFormats
像这样:
allowedFormats={ [ \'core/bold\', \'core/italic\', \'my-custom-format/sample-output\' ] }