好哇网

register_block_pattern 注册自定义Pattern

作者 2021-07-12 422

函数功能

注册自定义Pattern 到WordPress古腾堡编辑器。

函数参数

参数 数据类型 是否必需 描述 默认值
$pattern_name 字符串 包含命名空间的Pattern名称
$pattern_properties 数组 包含Pattern属性的数组。

$pattern_properties 数组可以包含以下几项数据。

参数 数据类型 是否必需 描述
title 字符串 模式标题
content 字符串 古腾堡编辑器的内容代码
description 字符串 Pattern作用的详细说明
categories 字符串 Pattern分类
keywords 字符串 Pattern关键词,用于搜索
viewportWidth 字符串 在插入时指定Pattern的宽度

函数返回值

如果自定义Pattern注册成功,返回true,否则为false。

使用示例

下面的示例注册了一个包含两个按钮的自定义Pattern。数组中 content 的内容可以在古腾堡编辑器中编辑好后,切换到古腾堡编辑器的代码模式,直接复制代码过来。

1
2
3
4
5
6
7
8
register_block_pattern(
    'wpdocs-my-plugin/my-awesome-pattern',
    array(
        'title'       => __( 'Two buttons', 'wpdocs-my-plugin' ),
        'description' => _x( 'Two horizontal buttons, the left button is filled in, and the right button is outlined.', 'Block pattern description', 'wpdocs-my-plugin' ),
        'content'     => "",
    )
);

发表评论

好哇网,每天提供1000+次下载,做你身边靠谱的下载站!

立刻探索下载

留言咨询