gutenbergdocs/docs/reference-guides/core-blocks.md
2025-10-22 01:40:18 +08:00

56 KiB
Raw Blame History

视频

从媒体库嵌入视频或上传新视频。(来源

  • 名称: core/video
  • 分类: 媒体
  • 支持功能: 对齐方式、锚点、交互性(客户端导航)、间距(边距、内边距)
  • 属性: 自动播放、二进制数据块、字幕、控制条、ID、循环播放、静音、内联播放、海报帧、预加载、源文件、音轨

标签云

由热门关键词组成的云图,每个关键词的大小根据出现频率而定。(来源

  • 名称: core/tag-cloud
  • 分类: 小工具
  • 支持: 对齐方式、交互性(客户端导航)、间距(外边距、内边距)、排版(行高)、HTML
  • 属性: 最大字体尺寸、标签数量、显示标签计数、最小字体尺寸、分类法

模板部件

编辑网站的不同全局区域,如页眉、页脚、侧边栏,或创建您自己的区域。(来源

  • 名称: core/template-part
  • 分类: 主题
  • 支持: 对齐方式、交互性(客户端导航)、HTML重命名可复用
  • 属性: 区域、别名、标签名称、主题

术语计数

显示分类法术语的文章计数。(来源

  • 名称: core/term-count
  • 分类: 主题
  • 支持: 颜色(背景、渐变、文本)、交互性(客户端导航)、间距(内边距)、排版(字体大小、行高)、HTML
  • 属性: 括号类型

术语描述

在查看归档时显示分类、标签和自定义分类法的描述。(来源

  • 名称: core/term-description
  • 分类: 主题
  • 支持: 对齐方式(全宽、宽)、颜色(背景、链接、文本)、交互性(客户端导航)、间距(外边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 文本对齐

术语名称

显示分类法术语的名称。(来源

  • 名称: core/term-name
  • 分类: 主题
  • 支持: 对齐方式(全宽、宽)、颜色(背景、渐变、链接、文本)、交互性(客户端导航)、间距(内边距)、排版(字体大小、行高)、HTML
  • 属性: 是否为链接、层级、文本对齐

术语模板

包含用于渲染分类法术语的块元素,如名称、描述等。(来源

  • 名称: core/term-template
  • 分类: 主题
  • 祖先块: core/terms-query
  • 支持: 对齐方式(全宽、宽)、颜色(背景、渐变、链接、文本)、交互性(客户端导航)、布局、间距(块间距、外边距、内边距)、排版(字体大小、行高)、HTML可复用

术语查询

一个高级块,允许根据不同的查询参数和视觉配置显示分类法术语。(来源

  • 名称: core/terms-query
  • 分类: 主题
  • 支持: 对齐方式(全宽、宽)、交互性、布局、HTML
  • 属性: 标签名称、术语查询

文本列(已弃用)

此块已弃用。请改用“列”块。(来源

  • 名称: core/text-columns
  • 分类: 设计
  • 支持: 交互性(客户端导航)、插入器
  • 属性: 列数、内容、宽度

诗歌

插入诗歌。使用特殊的间距格式。或引用歌词。(来源

  • 名称: core/verse
  • 分类: 文本
  • 支持: 锚点、背景(背景图片、背景尺寸)、颜色(背景、渐变、链接、文本)、尺寸(最小高度)、交互性(客户端导航)、间距(外边距、内边距)、排版(字体大小、行高)
  • 属性: 内容、文本对齐

评论下一页

显示下一页评论的链接。(源码

  • 名称: core/comments-pagination-next
  • 分类: theme
  • 父级: core/comments-pagination
  • 支持: colorbackground、gradients、text、interactivityclientNavigation、typographyfontSize、lineHeighthtmlreusable
  • 属性: label

评论页码

显示评论分页的页码列表。(源码

  • 名称: core/comments-pagination-numbers
  • 分类: theme
  • 父级: core/comments-pagination
  • 支持: colorbackground、gradients、text、interactivityclientNavigation、typographyfontSize、lineHeighthtmlreusable

评论上一页

显示上一页评论的链接。(源码

  • 名称: core/comments-pagination-previous
  • 分类: theme
  • 父级: core/comments-pagination
  • 支持: colorbackground、gradients、text、interactivityclientNavigation、typographyfontSize、lineHeighthtmlreusable
  • 属性: label

评论标题

显示带有评论数量的标题。(源码

  • 名称: core/comments-title
  • 分类: theme
  • 祖先: core/comments
  • 支持: align、colorbackground、gradients、text、interactivityclientNavigation、spacingmargin、padding、typographyfontSize、lineHeightanchorhtml
  • 属性: level、levelOptions、showCommentsCount、showPostTitle、textAlign

封面

添加带有文本覆盖的图像或视频。(源码

  • 名称: core/cover
  • 分类: media
  • 支持: align、allowedBlocks、anchor、colorheading、text、backgroundenableContrastChecker、dimensionsaspectRatio、filterduotone、interactivityclientNavigation、layoutallowJustification、shadow、spacingblockGap、margin、padding、typographyfontSize、lineHeighthtml
  • 属性: alt、backgroundType、contentPosition、customGradient、customOverlayColor、dimRatio、focalPoint、gradient、hasParallax、id、isDark、isRepeated、isUserOverlayColor、minHeight、minHeightUnit、overlayColor、poster、sizeSlug、tagName、templateLock、url、useFeaturedImage

详情

隐藏和显示额外内容。(源码

  • 名称: core/details
  • 分类: text
  • 支持: alignfull、wide、allowedBlocks、anchor、colorbackground、gradients、link、text、interactivityclientNavigation、layoutallowEditing、spacingblockGap、margin、padding、typographyfontSize、lineHeighthtml
  • 属性: name、placeholder、showContent、summary

嵌入

添加一个显示从其他网站(如 Twitter 或 YouTube拉取内容的块。源码

  • 名称: core/embed
  • 分类: embed
  • 支持: align、interactivityclientNavigation、spacingmargin
  • 属性: allowResponsive、caption、previewable、providerNameSlug、responsive、type、url

文件

添加可下载文件的链接。(源码

  • 名称: core/file
  • 分类: media
  • 支持: align、anchor、colorbackground、gradients、link、text、interactivity、spacingmargin、padding
  • 属性: blob、displayPreview、downloadButtonText、fileId、fileName、href、id、previewHeight、showDownloadButton、textLinkHref、textLinkTarget

阅读时长

显示阅读文章所需的分钟数,也可显示字数统计。(源码

  • 名称: core/post-time-to-read
  • 分类: 主题
  • 支持功能: 颜色(背景、渐变、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 平均阅读速度、范围显示模式、显示方式、文字对齐

标题

显示文章、页面或任何其他内容类型的标题。(源码

  • 名称: core/post-title
  • 分类: 主题
  • 支持功能: 对齐(全宽、宽屏)、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 链接模式、标题级别、级别选项、链接目标、关联关系、文字对齐

预格式化文本

添加保留空格和制表符的文本,同时支持样式设置。(源码

  • 名称: core/preformatted
  • 分类: 文本
  • 支持功能: 锚点、颜色(背景、渐变、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)
  • 属性: 内容

引述块

为文本中的引用内容赋予特殊的视觉强调效果。(源码

  • 名称: core/pullquote
  • 分类: 文本
  • 支持功能: 对齐(全宽、左、右、宽屏)、锚点、背景(背景图、背景尺寸)、颜色(背景、渐变、链接、文字)、尺寸(最小高度)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)
  • 属性: 引用来源、文字对齐、内容值

循环查询

高级功能块,支持根据不同查询参数和可视化配置来显示文章类型。(源码

  • 名称: core/query
  • 分类: 主题
  • 支持功能: 对齐(全宽、宽屏)、内容角色、交互性、布局、HTML
  • 属性: 增强分页、命名空间、查询参数、查询ID、标签名称

无结果

包含在未找到查询结果时用于渲染内容的区块元素。(源码

  • 名称: core/query-no-results
  • 分类: 主题
  • 祖先区块: core/query
  • 支持功能: 对齐、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、排版(字体大小、行高)、HTML可复用

分页

在适用时显示指向下一组/上一组文章的分页导航。(源码

  • 名称: core/query-pagination
  • 分类: 主题
  • 祖先区块: core/query
  • 允许子区块: core/query-pagination-previous上一页、core/query-pagination-numbers页码、core/query-pagination-next下一页
  • 支持功能: 对齐、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、布局(默认、允许继承允许切换)、排版(字体大小、行高)、HTML可复用
  • 属性: 分页箭头、显示标签

下一页

显示下一篇文章列表页的链接。(源码

  • 名称: core/query-pagination-next
  • 分类: 主题
  • 父级区块: core/query-pagination
  • 支持功能: 颜色(背景、渐变、文字)、交互性(客户端导航)、排版(字体大小、行高)、HTML可复用
  • 属性: 标签文字

首页链接

创建始终指向网站首页的链接。若页眉中已存在网站标题链接,通常无需使用此功能。(来源

  • 名称: core/home-link
  • 分类: 设计
  • 父级: core/navigation
  • 支持: 交互性(客户端导航)、版式(字体大小、行高)、HTML可复用
  • 属性: 标签

自定义 HTML

添加自定义 HTML 代码并在编辑时预览效果。(来源

  • 名称: core/html
  • 分类: 小工具
  • 支持: 交互性(客户端导航)、类名自定义类名HTML
  • 属性: 内容

图像

插入图像以呈现视觉表达。(来源

  • 名称: core/image
  • 分类: 媒体
  • 支持: 对齐(居中、全宽、左对齐、右对齐、宽屏)、锚点、颜色(背景文字)、滤镜(双色调)、交互性、阴影()、间距(边距)
  • 属性: 替代文本、宽高比、二进制数据、说明文字、高度、链接地址、ID、灯箱效果、链接类、链接目标类型、链接打开方式、关联关系、缩放比例、尺寸标识、标题、URL、宽度

最新评论

显示您最近的评论列表。(来源

  • 名称: core/latest-comments
  • 分类: 小工具
  • 支持: 对齐、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、版式(字体大小、行高)、HTML
  • 属性: 显示评论数、显示头像、显示日期、显示摘要

最新文章

显示您最近发布的文章列表。(来源

  • 名称: core/latest-posts
  • 分类: 小工具
  • 支持: 对齐、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、版式(字体大小、行高)、HTML
  • 属性: 为特色图片添加链接、分类目录、列数、显示作者、显示特色图片、显示文章内容、显示文章内容选项、显示发布日期、摘要长度、特色图片对齐方式、特色图片高度尺寸、特色图片尺寸标识、特色图片宽度尺寸、排序方式、排序依据、文章布局、显示文章数、选定作者

列表

按特定顺序显示的有序项目集合。(来源

  • 名称: core/list
  • 分类: 文本
  • 允许的子块: core/list-item
  • 支持: 不稳定粘贴文本内联、锚点、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、版式(字体大小、行高)、HTML
  • 属性: 有序列表、占位符、反向排序、起始数值、类型、值

列表项

列表中的单个项目。(来源

  • 名称: core/list-item
  • 分类: 文本
  • 父级: core/list
  • 允许的子块: core/list
  • 支持: 锚点、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、拆分功能、版式(字体大小、行高)、类名
  • 属性: 内容、占位符

登录/退出

显示登录和退出链接。(来源

  • 名称: core/loginout
  • 分类: 主题
  • 支持: 类名、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、版式(字体大小、行高)
  • 属性: 以表单形式显示登录、重定向至当前页面

核心区块参考

本文档列出了 block-library 包中包含的区块。

  • 带删除线(删除线)标记的项目已被明确禁用。
  • 标记为 Experimental: true 的区块仅在 Gutenberg 激活时可用。
  • 标记为 Experimental: fse 的区块仅在全站编辑器中可用。

手风琴

显示一组手风琴标题及关联的可展开内容。(源码)

  • 名称: core/accordion
  • 分类: 设计
  • 允许的区块: core/accordion-item
  • 支持: 对齐全宽锚点ariaLabel背景背景图片背景尺寸颜色背景渐变文本内容角色交互性布局阴影间距区块间距外边距内边距排版字体大小行高html
  • 属性: 自动关闭,标题级别,图标位置,级别选项,显示图标

手风琴标题

显示手风琴标题。(源码)

  • 名称: core/accordion-heading
  • 分类: 设计
  • 父级: core/accordion-item
  • 支持: 锚点,颜色(背景,渐变,文本),交互性,阴影,间距(内边距),排版(字体大小),对齐区块可见性锁定
  • 属性: 图标位置,级别,默认展开,显示图标,标题

手风琴项目

显示手风琴中的内容部分,包括标题和可展开内容。(源码)

  • 名称: core/accordion-item
  • 分类: 设计
  • 父级: core/accordion
  • 允许的区块: core/accordion-heading, core/accordion-panel
  • 支持: 颜色(背景,渐变,文本),内容角色,交互性,布局(允许编辑),阴影,间距(区块间距,外边距),排版(字体大小,行高),html
  • 属性: 默认展开

手风琴面板

显示手风琴面板。(源码)

  • 名称: core/accordion-panel
  • 分类: 设计
  • 父级: core/accordion-item
  • 支持: 允许的区块,颜色(背景,渐变,文本),内容角色,交互性,布局(允许编辑),阴影,间距(区块间距,内边距),排版(字体大小,行高),区块可见性html锁定
  • 属性: 是否选中,默认展开,模板锁定

文章归档

显示按日期归档的文章列表。(源码)

  • 名称: core/archives
  • 分类: 小工具
  • 支持: 对齐,颜色(背景,渐变,链接,文本),交互性(客户端导航),间距(外边距,内边距),排版(字体大小,行高),html
  • 属性: 以下拉菜单显示,显示标签,显示文章计数,类型

音频

嵌入简易音频播放器。(源码)

  • 名称: core/audio
  • 分类: 媒体
  • 支持: 对齐,锚点,交互性(客户端导航),间距(外边距,内边距)
  • 属性: 自动播放二进制数据说明文字ID循环播放预加载源文件

头像

添加用户头像。(源码)

  • 名称: core/avatar
  • 分类: 主题
  • 支持: 对齐,颜色(背景文本),滤镜(双色调),交互性(客户端导航),间距(外边距,内边距),宽对齐html
  • 属性: 是否为链接链接目标尺寸用户ID

区块模式

在站点中复用此设计。(源码)

  • 名称: core/block
  • 分类: 可复用
  • 支持: 交互性(客户端导航),自定义类名html插入器重命名
  • 属性: 内容,引用

数学公式

使用 LaTeX 显示数学符号。(源码

  • 名称: core/math
  • 分类: 文本
  • 属性: latex、mathML

媒体与文本

将媒体内容与文字并排显示,实现更丰富的版式布局。(源码

  • 名称: core/media-text
  • 分类: 媒体
  • 支持功能: 对齐(全宽、宽屏)、允许嵌套块、锚点、色彩(背景、渐变、标题、链接、文字)、交互功能(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: align、focalPoint、href、imageFill、isStackedOnMobile、linkClass、linkDestination、linkTarget、mediaAlt、mediaId、mediaLink、mediaPosition、mediaSizeSlug、mediaType、mediaUrl、mediaWidth、rel、useFeaturedImage、verticalAlignment

不受支持

您的站点不支持此区块。(源码

  • 名称: core/missing
  • 分类: 文本
  • 支持功能: 交互功能(客户端导航)、classNamecustomClassNamehtmlinserterreusable
  • 属性: originalContent、originalName、originalUndelimitedContent

摘要分隔符

此区块前的内容将显示在归档页面的摘要中。(源码

  • 名称: core/more
  • 分类: 设计
  • 支持功能: 交互功能(客户端导航)、classNamecustomClassNamehtmlmultiple
  • 属性: customText、noTeaser

导航菜单

一组帮助访客浏览站点的功能区块。(源码

  • 名称: core/navigation
  • 分类: 主题
  • 允许嵌套块: core/navigation-link、core/search、core/social-links、core/page-list、core/spacer、core/home-link、core/site-title、core/site-logo、core/navigation-submenu、core/loginout、core/buttons
  • 支持功能: 对齐全宽、宽屏、ariaLabel、contentRole、插入器、交互功能、布局允许子级尺寸调整、默认设置、允许继承允许切换允许垂直对齐)、间距(块间距、单位)、排版(字体大小、行高)、HTML重命名
  • 属性: __unstableLocation、backgroundColor、customBackgroundColor、customOverlayBackgroundColor、customOverlayTextColor、customTextColor、hasIcon、icon、maxNestingLevel、openSubmenusOnClick、overlayBackgroundColor、overlayMenu、overlayTextColor、ref、rgbBackgroundColor、rgbTextColor、showSubmenuIcon、templateLock、textColor

自定义链接

向导航菜单添加页面、链接或其他项目。(源码

  • 名称: core/navigation-link
  • 分类: 设计
  • 父级区块: core/navigation
  • 允许嵌套块: core/navigation-link、core/navigation-submenu、core/page-list
  • 支持功能: 交互功能(客户端导航)、排版(字体大小、行高)、HTML重命名可复用
  • 属性: description、id、isTopLevelLink、kind、label、opensInNewTab、rel、title、type、url

子菜单

为导航菜单添加子菜单。(源码

  • 名称: core/navigation-submenu
  • 分类: 设计
  • 父级区块: core/navigation
  • 支持功能: 交互功能(客户端导航)、排版(字体大小、行高)、HTML可复用
  • 属性: description、id、isTopLevelItem、kind、label、opensInNewTab、rel、title、type、url

分页符

将内容分割成多页浏览体验。(源码

  • 名称: core/nextpage
  • 分类: 设计
  • 父级区块: core/post-content
  • 支持功能: 交互功能(客户端导航)、classNamecustomClassNamehtml

页面列表

显示所有页面的列表。(源码

  • 名称: core/page-list
  • 分类: 小工具
  • 允许嵌套区块: core/page-list-item
  • 支持功能: 颜色(背景、渐变、链接、文字)、内容角色、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML可复用性
  • 属性: 是否嵌套、父页面ID

页面列表项

在页面列表中显示单个页面。(源码

  • 名称: core/page-list-item
  • 分类: 小工具
  • 父区块: core/page-list
  • 支持功能: 交互性(客户端导航)、HTML插入器锁定可复用性
  • 属性: 是否包含子项、页面ID、标签、链接、标题

段落

所有叙事内容的基础构建单元。(源码

  • 名称: core/paragraph
  • 分类: 文本
  • 支持功能: __unstablePasteTextInline、锚点、颜色背景、渐变、链接、文字、交互性客户端导航、间距边距、内边距、拆分、排版自适应文字、字体大小、行高类名
  • 属性: 对齐方式、内容、文本方向、首字下沉、占位符

模式占位符

显示区块模式。(源码

  • 名称: core/pattern
  • 分类: 主题
  • 支持功能: 交互性(客户端导航)、区块可见性HTML插入器重命名
  • 属性: 模式别名

文章作者

显示文章作者详细信息,包括姓名、头像和个人简介。(源码

  • 名称: core/post-author
  • 分类: 主题
  • 支持功能: 颜色(背景、渐变、链接、文字)、滤镜(双色调)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 头像尺寸、署名行、是否设为链接、链接打开方式、显示头像、显示简介、文本对齐

作者简介

显示作者的个人简介。(源码

  • 名称: core/post-author-biography
  • 分类: 主题
  • 支持功能: 颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)
  • 属性: 文本对齐

作者姓名

显示作者姓名。(源码

  • 名称: core/post-author-name
  • 分类: 主题
  • 支持功能: 颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 是否设为链接、链接打开方式、文本对齐

评论(已弃用)

此区块已被弃用,请改用评论区区块。(源码

  • 名称: core/post-comment
  • 实验性功能: 全站编辑
  • 分类: 主题
  • 允许嵌套区块: core/avatar、core/comment-author-name、core/comment-content、core/comment-date、core/comment-edit-link、core/comment-reply-link
  • 支持功能: 交互性(客户端导航)、HTML插入器
  • 属性: 评论ID

评论数量

显示文章的评论数量。(源码

  • 名称: core/post-comments-count
  • 分类: 主题
  • 支持功能: 颜色(背景、渐变、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 文本对齐

脚注

显示页面中添加的脚注。(来源

  • 名称: core/footnotes
  • 分类: 文本
  • 支持功能: 颜色(背景、链接、文本)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML插入器多选可复用

表单

表单。(来源

  • 名称: core/form
  • 实验性:
  • 分类: 通用
  • 允许包含的块: core/paragraph、core/heading、core/form-input、core/form-submit-button、core/form-submission-notification、core/group、core/columns
  • 支持功能: 锚点、颜色(背景、渐变、链接、文本)、间距(边距、内边距)、排版(字体大小、行高)
  • 属性: action、email、method、submissionMethod

输入字段

表单的基本构建块。(来源

  • 名称: core/form-input
  • 实验性:
  • 分类: 通用
  • 父级块: core/form
  • 支持功能: 锚点、间距(边距)、可复用
  • 属性: inlineLabel、label、name、placeholder、required、type、value、visibilityPermissions

表单提交通知

在表单提交后提供通知消息。(来源

  • 名称: core/form-submission-notification
  • 实验性:
  • 分类: 通用
  • 父级块: core/form
  • 属性: type

表单提交按钮

表单的提交按钮。(来源

  • 名称: core/form-submit-button
  • 实验性:
  • 分类: 通用
  • 父级块: core/form
  • 允许包含的块: core/buttons、core/button

经典编辑器

使用经典的 WordPress 编辑器。(来源

  • 名称: core/freeform
  • 分类: 文本
  • 支持功能: classNamecustomClassName可复用
  • 属性: content

图库

在丰富的图库中展示多张图片。(来源

  • 名称: core/gallery
  • 分类: 媒体
  • 允许包含的块: core/image
  • 支持功能: 对齐、锚点、颜色(背景、渐变、文本)、交互性(客户端导航)、布局(默认、允许编辑允许继承允许切换、间距块间距、边距、内边距、单位em、px、rem、vh、vwHTML
  • 属性: allowResize、aspectRatio、caption、columns、fixedHeight、ids、imageCrop、images、linkTarget、linkTo、randomOrder、shortCodeTransforms、sizeSlug

将块聚集在一个布局容器中。(来源

  • 名称: core/group
  • 分类: 设计
  • 支持功能: 对齐全宽、宽屏、允许块、锚点、ariaLabel、背景背景图片、背景尺寸、颜色背景、按钮、渐变、标题、链接、文本、尺寸最小高度、交互性客户端导航、布局允许子元素调整大小、位置粘性、阴影、间距块间距、边距、内边距、排版字体大小、行高HTML
  • 属性: tagName、templateLock

标题

引入新章节并组织内容,以帮助访问者(和搜索引擎)理解内容结构。(来源

  • 名称: core/heading
  • 分类: 文本
  • 支持功能: __unstablePasteTextInline、对齐全宽、宽屏、锚点、className、颜色背景、渐变、链接、文本、交互性客户端导航、间距边距、内边距、拆分、排版自适应文本、字体大小、行高
  • 属性: content、level、levelOptions、placeholder、textAlign

面包屑导航

为层级化文章类型或基于分类法条目显示面包屑导航路径。(源代码

  • 名称: core/breadcrumbs
  • 实验性功能:
  • 分类: 主题
  • 支持功能: 颜色(背景、渐变、链接、文本)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 分隔符、显示首页链接、类型

按钮

通过按钮式链接引导访客执行操作。(源代码

  • 名称: core/button
  • 分类: 设计
  • 父级块: core/buttons
  • 支持功能: 锚点、颜色(背景、渐变、文本)、交互性(客户端导航)、阴影、间距(内边距)、拆分效果、排版(字体大小、行高)、宽对齐对齐可复用
  • 属性: 背景色、渐变、链接目标、占位符、关联关系、标签名称、文本、文本对齐、文字颜色、标题、类型、链接地址、宽度

按钮组

通过一组按钮式链接引导访客执行操作。(源代码

  • 名称: core/buttons
  • 分类: 设计
  • 允许嵌套块: core/button
  • 支持功能: 对齐(全宽、宽幅)、锚点、颜色(背景、渐变、文本)、内容角色、交互性(客户端导航)、布局(默认、允许继承允许切换)、间距(块间距、边距、内边距)、排版(字体大小、行高)、HTML

日历

显示您站点的文章日历。(源代码

  • 名称: core/calendar
  • 分类: 小工具
  • 支持功能: 对齐、颜色(背景、链接、文本)、交互性(客户端导航)、排版(字体大小、行高)、HTML
  • 属性: 月份、年份

分类列表

显示指定分类法下的所有条目列表。(源代码

  • 名称: core/categories
  • 分类: 小工具
  • 支持功能: 对齐、颜色(背景、渐变、链接、文本)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 下拉式显示、标签、显示空项、显示层级、显示标签、仅显示顶级分类、显示文章计数、分类法

代码块

展示保留原始空格和制表符的代码片段。(源代码

  • 名称: core/code
  • 分类: 文本
  • 支持功能: 对齐(宽幅)、锚点、颜色(背景、渐变、文本)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)
  • 属性: 内容

单列

列块中的独立列单元。(源代码

  • 名称: core/column
  • 分类: 设计
  • 父级块: core/columns
  • 支持功能: 允许嵌套块、锚点、颜色(背景、按钮、渐变、标题、链接、文本)、交互性(客户端导航)、布局、阴影、间距(块间距、内边距)、排版(字体大小、行高)、HTML可复用
  • 属性: 模板锁定、垂直对齐、宽度

多列布局

以多列形式展示内容,每列可添加独立内容块。(源代码

  • 名称: core/columns
  • 分类: 设计
  • 允许嵌套块: core/column
  • 支持功能: 对齐(全宽、宽幅)、锚点、颜色(背景、按钮、渐变、标题、链接、文本)、交互性(客户端导航)、布局(默认、允许编辑允许继承允许切换)、阴影、间距(块间距、边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 移动端堆叠显示、模板锁定、垂直对齐

评论表单

显示文章的评论表单。(源码

  • 名称: core/post-comments-form
  • 分类: 主题
  • 支持: 颜色(背景、渐变、标题、链接、文本),间距(外边距、内边距),版式(字体大小、行高),HTML
  • 属性: 文本对齐

评论链接

显示当前文章评论的链接。(源码

  • 名称: core/post-comments-link
  • 分类: 主题
  • 支持: 颜色(背景、链接、文本),交互性(客户端导航),间距(外边距、内边距),版式(字体大小、行高),HTML
  • 属性: 文本对齐

内容

显示文章或页面的内容。(源码

  • 名称: core/post-content
  • 分类: 主题
  • 支持: 对齐(全宽、宽),背景(背景图片、背景尺寸),颜色(背景、渐变、标题、链接、文本),尺寸(最小高度),交互性(客户端导航),布局,间距(块间距、外边距、内边距),版式(字体大小、行高),HTML
  • 属性: 标签名称

日期

显示文章或页面等内容的发布日期。(源码

  • 名称: core/post-date
  • 分类: 主题
  • 支持: 颜色(背景、渐变、链接、文本),交互性(客户端导航),间距(外边距、内边距),版式(字体大小、行高),HTML
  • 属性: 日期时间、格式、是否为链接、文本对齐

摘要

显示文章的摘要。(源码

  • 名称: core/post-excerpt
  • 分类: 主题
  • 支持: 颜色(背景、渐变、链接、文本),交互性(客户端导航),间距(外边距、内边距),版式(字体大小、行高),HTML
  • 属性: 摘要长度、更多文本、在新行显示更多、文本对齐

特色图片

显示文章的特色图片。(源码

  • 名称: core/post-featured-image
  • 分类: 主题
  • 支持: 对齐(居中、全宽、左、右、宽),颜色(背景文本),滤镜(双色调),交互性(客户端导航),阴影(),间距(外边距、内边距),HTML
  • 属性: 宽高比、自定义渐变、自定义覆盖颜色、暗化比例、渐变、高度、是否为链接、链接目标、覆盖颜色、关联属性、缩放、尺寸标识、使用文章首张图片、宽度

文章导航链接

显示与当前文章相邻的上一篇或下一篇文章链接。(源码

  • 名称: core/post-navigation-link
  • 分类: 主题
  • 支持: 颜色(背景、链接、文本),交互性(客户端导航),版式(字体大小、行高),HTML可复用
  • 属性: 箭头、标签、链接标签、显示标题、分类法、文本对齐、类型

文章模板

包含用于渲染文章的块元素,如标题、日期、特色图片、内容或摘要等。(源码

  • 名称: core/post-template
  • 分类: 主题
  • 祖先: core/query
  • 支持: 对齐(全宽、宽),颜色(背景、渐变、链接、文本),交互性(客户端导航),布局,间距(块间距、外边距、内边距),版式(字体大小、行高),HTML可复用

文章分类项

显示文章的分类项。(源码

  • 名称: core/post-terms
  • 分类: 主题
  • 支持: 颜色(背景、渐变、链接、文本),交互性(客户端导航),间距(外边距、内边距),版式(字体大小、行高),HTML
  • 属性: 前缀、分隔符、后缀、分类项、文本对齐

评论作者头像 (已弃用)

此区块已被弃用,请改用头像区块。(源码)

  • 名称: core/comment-author-avatar
  • 实验性: fse
  • 分类: 主题
  • 祖先区块: core/comment-template
  • 支持功能: 颜色(背景、文字)、交互性(客户端导航)、间距(边距、内边距)、HTML插入器
  • 属性: 高度、宽度

评论作者名称

显示评论作者的名称。(源码)

  • 名称: core/comment-author-name
  • 分类: 主题
  • 祖先区块: core/comment-template
  • 支持功能: 颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 是否为链接、链接目标、文本对齐

评论内容

显示评论的内容。(源码)

  • 名称: core/comment-content
  • 分类: 主题
  • 祖先区块: core/comment-template
  • 支持功能: 颜色(背景、渐变、链接、文字)、间距(内边距)、排版(字体大小、行高)、HTML
  • 属性: 文本对齐

评论日期

显示评论发布的日期。(源码)

  • 名称: core/comment-date
  • 分类: 主题
  • 祖先区块: core/comment-template
  • 支持功能: 颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 日期格式、是否为链接

评论编辑链接

显示指向 WordPress 仪表盘中编辑评论的链接。此链接仅对具有编辑评论权限的用户可见。(源码)

  • 名称: core/comment-edit-link
  • 分类: 主题
  • 祖先区块: core/comment-template
  • 支持功能: 颜色(背景、渐变、链接、文字)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 链接目标、文本对齐

评论回复链接

显示用于回复评论的链接。(源码)

  • 名称: core/comment-reply-link
  • 分类: 主题
  • 祖先区块: core/comment-template
  • 支持功能: 颜色(背景、渐变、链接、文字)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 文本对齐

评论模板

包含用于显示评论的区块元素,如标题、日期、作者、头像等。(源码)

  • 名称: core/comment-template
  • 分类: 设计
  • 父区块: core/comments
  • 支持功能: 对齐、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、HTML可复用

评论

高级区块,允许使用不同的视觉配置显示文章评论。(源码)

  • 名称: core/comments
  • 分类: 主题
  • 支持功能: 对齐(全宽、宽)、颜色(背景、渐变、标题、链接、文字)、间距(边距、内边距)、排版(字体大小、行高)、HTML
  • 属性: 传统模式、标签名称

评论分页

在适用时显示分页导航,用于跳转至上一组/下一组评论。(源码)

  • 名称: core/comments-pagination
  • 分类: 主题
  • 父区块: core/comments
  • 允许的子区块: core/comments-pagination-previous、core/comments-pagination-numbers、core/comments-pagination-next
  • 支持功能: 对齐、颜色(背景、渐变、链接、文字)、交互性(客户端导航)、布局(默认、允许继承允许切换)、排版(字体大小、行高)、HTML可复用
  • 属性: 分页箭头

短代码

通过WordPress短代码插入额外的自定义元素。源码

  • 名称: core/shortcode
  • 分类: 小工具
  • 支持: classNamecustomClassNamehtml
  • 属性: text

站点标志

显示代表此站点的图像。更新此区块,更改将应用到所有位置。(源码

  • 名称: core/site-logo
  • 分类: 主题
  • 支持: 对齐、颜色(背景文本)、滤镜(双色调)、交互性(客户端导航)、间距(边距、内边距)、alignWidehtml
  • 属性: isLink、linkTarget、shouldSyncIcon、width

站点标语

用简短的文字描述此站点的内容。这对搜索结果、社交媒体分享非常重要,并能向访问者清晰传达信息。(源码

  • 名称: core/site-tagline
  • 分类: 主题
  • 支持: 对齐(全宽、宽)、颜色(背景、渐变、文本)、内容角色、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、html
  • 属性: level、levelOptions、textAlign

站点标题

显示此站点的名称。更新该区块,更改将应用到所有使用位置。这也将显示在浏览器标题栏和搜索结果中。(源码

  • 名称: core/site-title
  • 分类: 主题
  • 支持: 对齐(全宽、宽)、颜色(背景、渐变、链接、文本)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)、html
  • 属性: isLink、level、levelOptions、linkTarget、textAlign

社交图标

显示链接到社交资料或站点的图标。(源码

  • 名称: core/social-link
  • 分类: 小工具
  • 父级: core/social-links
  • 支持: 交互性(客户端导航)、htmlreusable
  • 属性: label、rel、service、url

社交图标组

显示链接到您的社交资料或站点的图标。(源码

  • 名称: core/social-links
  • 分类: 小工具
  • 允许的区块: core/social-link
  • 支持: 对齐(居中、左、右)、锚点、颜色(背景、渐变、enableContrastChecker文本)、内容角色、交互性(客户端导航)、布局(默认、allowInheritingallowSwitchingallowVerticalAlignment)、间距(区块间距、边距、内边距、单位)、html
  • 属性: customIconBackgroundColor、customIconColor、iconBackgroundColor、iconBackgroundColorValue、iconColor、iconColorValue、openInNewTab、showLabels、size

间距块

在区块之间添加空白并自定义其高度。(源码

  • 名称: core/spacer
  • 分类: 设计
  • 支持: 锚点、交互性(客户端导航)、间距(边距)
  • 属性: height、width

表格

以行和列的形式创建结构化内容以显示信息。(源码

  • 名称: core/table
  • 分类: 文本
  • 支持: 对齐、锚点、颜色(背景、渐变、文本)、交互性(客户端导航)、间距(边距、内边距)、排版(字体大小、行高)
  • 属性: body、caption、foot、hasFixedLayout、head

目录

用标题列表总结您的文章。为标题区块添加HTML锚点以在此处链接它们。源码

  • 名称: core/table-of-contents
  • 实验性:
  • 分类: 设计
  • 支持: ariaLabel、颜色背景、渐变、链接、文本、交互性客户端导航、间距边距、内边距、排版字体大小、行高html
  • 属性: headings、maxLevel、onlyIncludeCurrentPage、ordered

页码

显示用于分页的页码列表。(来源

  • 名称: core/query-pagination-numbers
  • 分类: theme主题
  • 父级: core/query-pagination
  • 支持: colorbackground背景gradients渐变text文字interactivityclientNavigation客户端导航typographyfontSize字体大小lineHeight行高htmlreusable可复用
  • 属性: midSize

上一页

显示上一篇文章页面链接。(来源

  • 名称: core/query-pagination-previous
  • 分类: theme主题
  • 父级: core/query-pagination
  • 支持: colorbackground背景gradients渐变text文字interactivityclientNavigation客户端导航typographyfontSize字体大小lineHeight行高htmlreusable可复用
  • 属性: label

查询标题

显示查询标题。(来源

  • 名称: core/query-title
  • 分类: theme主题
  • 支持: alignfull全宽wide宽colorbackground背景gradients渐变text文字interactivityclientNavigation客户端导航spacingmargin边距padding内边距typographyfontSize字体大小lineHeight行高html
  • 属性: levellevelOptionsshowPrefixshowSearchTermtextAligntype

查询总数

显示查询结果总数。(来源

  • 名称: core/query-total
  • 分类: theme主题
  • 祖先: core/query
  • 支持: alignfull全宽wide宽colorbackground背景gradients渐变text文字interactivityclientNavigation客户端导航spacingmargin边距padding内边距typographyfontSize字体大小lineHeight行高html
  • 属性: displayType

引用

为引用的文本提供视觉强调。"在引用他人时,我们其实是在引用自己。" —— 胡里奥·科塔萨尔(来源

  • 名称: core/quote
  • 分类: text文本
  • 支持: alignfull全宽left左right右wide宽allowedBlocksanchorbackgroundbackgroundImage背景图片backgroundSize背景尺寸colorbackground背景gradients渐变heading标题link链接text文字dimensionsminHeight最小高度interactivityclientNavigation客户端导航layoutallowEditing允许编辑spacingblockGap块间距margin边距padding内边距typographyfontSize字体大小lineHeight行高html
  • 属性: citationtextAlignvalue

阅读更多

显示文章、页面或任何其他内容类型的链接。(来源

  • 名称: core/read-more
  • 分类: theme主题
  • 支持: colorbackground背景gradients渐变text文字interactivityclientNavigation客户端导航spacingmargin边距padding内边距typographyfontSize字体大小lineHeight行高html
  • 属性: contentlinkTarget

RSS

显示来自任何RSS或Atom订阅源的条目。来源

  • 名称: core/rss
  • 分类: widgets小工具
  • 支持: aligncolorbackground背景gradients渐变link链接text文字interactivityclientNavigation客户端导航spacingmargin边距padding内边距html
  • 属性: blockLayoutcolumnsdisplayAuthordisplayDatedisplayExcerptexcerptLengthfeedURLitemsToShowopenInNewTabrel

搜索

帮助访问者找到您的内容。(来源

  • 名称: core/search
  • 分类: widgets小工具
  • 支持: aligncenter居中left左right右colorbackground背景gradients渐变text文字interactivityspacingmargin边距typographyfontSize字体大小lineHeight行高html
  • 属性: buttonPositionbuttonTextbuttonUseIconisSearchFieldHiddenlabelplaceholderqueryshowLabelwidthwidthUnit

分隔符

用水平分隔符在想法或部分之间创建间隔。(来源

  • 名称: core/separator
  • 分类: design设计
  • 支持: aligncenter居中full全宽wide宽anchorcolorbackground背景gradients渐变enableContrastChecker启用对比度检查器text文字interactivityclientNavigation客户端导航spacingmargin边距
  • 属性: opacitytagName