Documentation: Clarify the behavior of parent when empty during block registration · WordPress/gutenberg#15731

(5 comments) (1 reaction) (0 assignees)JavaScript (9,607 stars) (3,893 forks)batch import

Good First IssueNeeds Dev[Feature] Block API[Type] Developer Documentation

説明

Part of https://github.com/WordPress/gutenberg/issues/41236.

Describe the bug

https://developer.wordpress.org/block-editor/developers/block-api/block-registration/#parent-optional

It might be good to update the documentation here to clarify that you can restrict it to the root if you pass an empty array. (Also good to check if there are tests for this or if it just happens to work.)

This also leads to the question what the default is for this parameter. undefined? null? In any case just "Type: Array" doesn't seem correct.

コントリビューターガイド

技術スタック: javascriptreact
領域: documentation
Issue 種別: documentation
難度: 2
推定時間: 1-3 hours
活動状況: stale
明確さ: clear
前提条件: Basic WordPress development knowledge
初心者向け度: 80
調査方針: Investigate the behavior of the `parent` property in block registration by examining the source code in the Gutenberg repository (e.g., `packages/blocks/src/api/registration.js`). Look for existing tests that cover the empty array case. Update the documentation on developer.wordpress.org to clearly state that an empty array restricts the block to the root, and document the default value (e.g., `undefined`).