WordPress.org网站
获取WordPress
WordPress.org网站

WordPress开发人员资源

寄存器块模式（）

寄存器块模式(一串 $图案名称,阵列 $pattern_properties（$模式属性） ):布尔

在本文中

返回页首

注册新块图案。

参数

$图案名称一串必修的
包含命名空间的块模式名称。
$pattern_properties（$模式属性）阵列必修的
块图案的属性列表。
有关接受的参数，请参阅WP_Block_Patterns_Registry:：register（）。

返回

布尔如果模式注册成功，则为True，否则为false。

来源

函数register_block_pattern（$patter_name，$pattern_properties）{return WP_Block_Patterns_Registry:：get_instance（）->寄存器（$pattern_name，$pattern\properties）；}

查看所有引用 在Trac上查看 在GitHub上查看

用途描述
WP_Block_Patterns_Registry:：get_instance（）wp-includes/class-wp-block-patterns-registry.php

用于检索类的主实例的实用程序方法。

使用者描述
_寄存器远程主题模式（）wp-includes/block-patterns.php（wp-includes/plock-patter）

从主题提供的模式目录中注册模式主题.json文件。

_寄存器_主题_块_模式（）wp-includes/block-patterns.php（wp-includes/plock-patter）

注册活动主题可能在其下提供的任何模式./图案/目录。

_加载远程特征模式（）wp-includes/block-patterns.php（wp-includes/plock-patter）

注册作为特色的来自wordpress.org/patterns的（category）模式。

_加载远程块模式（）wp-includes/block-patterns.php（wp-includes/plock-patter）

从wordpress.org/patterns注册Core的官方模式。

_register_core_block_patterns_and_categories（）wp-includes/block-patterns.php（wp-includes/plock-patter）

注册核心块模式和类别。

变更日志

版本描述
5.5.0介绍。

用户贡献的笔记

  1. 跳到注释6内容
    克里斯蒂娜·布鲁斯特
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：10你必须登录才能对这个便条的帮助进行投票

    根据《块编辑器手册》中的块填充图案文档，的$pattern_properties（$模式属性）阵列包括：

    • 标题（必填）：图案的可读标题。
    • 内容（必填）：图案的原始HTML内容。
    • 描述：用于描述插入器中图案的视觉隐藏文本。描述是可选的，但如果标题没有完全描述模式的功能，则强烈建议使用描述。
    • 类别：用于分组块图案的图案类别列表。块图案可以显示在多个类别上。
    • 关键字：帮助用户在搜索时发现它的别名或关键字。
    • 视图端口宽度：指定插入器中图案的宽度。

    给出的示例函数为：

    寄存器块模式(“wpdocs-my-plugin/my-awesome-pattern”，阵列(“title”=>__（“两个按钮”，“wpdocs-my-plugin”），“description”=>_x（“两个水平按钮，左边的按钮被填充，右边的按钮被轮廓化。”，“Block pattern description'，”wpdocs-my-plugin“），'content'=>“<！--wp:buttons{\”align\“：\”center\“}-->\n<div class=“wp-block-buttons aligncenter\”><！--wp:button{\”backgroundColor\“：”very-dark-gray\“，\”borderRadius\“：0}-->\n。esc_html__（“按钮一”，“wpdocs-my-plugin”）。“</a></div>\n<！--/wp:button-->\n\n<！--wp:button{\”textColor\“：\”very-dark-gray\“，\”borderRadius“：0，\”className\“：”is-style-outline\“}-->\n<div class=\”wp-block-button is-styl-outline\“><a class=\\”wp-block-button___link has-text-color has-very-dack-gray-color no-border-radius“>”。esc_html__（“按钮二”，“wpdocs-my-plugin”）。“</a></div>\n<！--/wp:button--></div>\n<！--/wp:button-->”，));
  2. 跳到注释7内容
    米凯希（mikehealy）
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：6你必须登录才能对这个便条的帮助进行投票

    文件和手册似乎没有提到，但我想寄存器块模式（）应该从附加到初始化挂钩。

    函数wpdocs_register_my_patterns（）{寄存器块模式（…）；}add_action（'init'，'wpdocs_register_mypatterns'）；
  5. 跳到注释10内容
    杰迪普
    你必须登录才能对这张纸条的有用性进行投票本附注的投票结果：2你必须登录才能对这个便条的帮助进行投票

    如何注册新模式块的基本示例。

    函数wpdocs_register_block_patterns（）{寄存器块模式(“wpdocs/my-example”，阵列('标题'=>__（'我的第一个块模式'，'文本域'），“description”=>_x（“这是我的第一个块模式”，“块模式描述”，“textdomain”），“内容”=>“<！--wp:paragraph--><p>单个段落块样式</p><！--/wp:段落-->'，“categories”=>数组（“text”），“keywords”=>数组（“cta”，“demo”，“example”），“viewportWidth”=>800，));}add_action（'init'，'wpdocs_register_block_patterns'）；

你必须登录在能够发表注释或反馈之前。