在RichText组件的`formattingControls`参数中可以使用什么值

时间:2020-10-15 作者:kanlukasz

Documentation 表示:

  • formattingControls={ [ \'bold\', \'italic\' ] } // Allow the content to be made bold or italic, but do not allow other formatting options
。。。但我找不到所有值的列表​​我们可以在那里使用。

我知道bold, italic, link, strikethrough 但还有更多的因素。

那么,支持的值的完整列表是什么?

1 个回复
最合适的回答,由SO网友:Sally CJ 整理而成

那么,支持的值的完整列表是什么?

可用格式类型的列表保存在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 取而代之的是

TheformattingControls prop(erty),虽然在写作时仍然有效,但长期以来deprecated (2019年8月),您现在应该使用其替代品:allowedFormats.

二者都allowedFormatsformattingControls 接受格式名称数组,但有两个区别:

formattingControls, 您不需要指定名称空间,即如果全名为core/bold, 您只需使用bold.

其次,不支持自定义格式类型-它们不会导致任何错误,但也不会出现在富文本工具栏中(或添加到富文本工具栏中)。

带有allowedFormats, 您需要指定包含命名空间的完整格式名称,例如。core/boldcore/italic.

那是因为allowedFormats 支持自定义格式类型。例如,如果您已注册sample format here (已命名my-custom-format/sample-output), 然后你会设置allowedFormats 像这样:

allowedFormats={ [ \'core/bold\', \'core/italic\', \'my-custom-format/sample-output\' ] }

相关推荐

Admin Theme customization

我遵循wordpress codex网站上关于通过插件创建管理主题的说明。我激活了插件,但我的样式表没有包含在<head>.. 这是我的代码:add_action( \'admin_init\', \'kd_plugin_admin_init\' ); add_action( \'admin_menu\', \'kd_plugin_admin_menu\' ); function kd_plugin_admin_init() { /* Register