Add block variations to FAQ #29154
Merged
Add block variations to FAQ #29154
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
👋 Thanks for your first Pull Request and for helping build the future of Gutenberg and WordPress, @priethor! In case you missed it, we'd love to have you join us in our Slack community, where we hold regularly weekly meetings open to anyone to coordinate with each other. If you want to learn more about WordPress development in general, check out the Core Handbook full of helpful information. |
github-actions
bot
added
the
First-time Contributor
|
Size Change: -57 B (0%) Total Size: 1.38 MB
ℹ️ View Unchanged
|
annezazu
reviewed
Feb 19, 2021
annezazu
reviewed
Feb 19, 2021
docs/designers-developers/faq.md
Outdated
|
|
||
| No, block variations are different versions of a single base block, sharing a similar functionality, but with slight differences in their implementation, or settings (attributes, InnerBlocks,etc). Block variations are transparent for users, and once registered a block variation, it will appear as a new block. For example, the `embed` block registers different block variations to embed content from specific providers. | ||
|
|
||
| On the other hand, [block styles](/docs/designers-developers/developers/filters/block-filters.md#block-style-variations) allow providing alternative styles to existing blocks, and they work by adding a className to the block’s wrapper. Once a block has registered block styles, block style selector will appear in its sidebar so that users can chose among the different registered styles. |
There was a problem hiding this comment.
I might rephrase this to: "Meanwhile, block styles allow you to provide alternative styles to existing blocks"
There was a problem hiding this comment.
I agree with you, although I copied that phrasing from the Block Style variations documentation. Do you think it might be worth changing it there, too? 🤔
There was a problem hiding this comment.
Yes! Definitely good to update in both places as the current phrasing is pretty strange.
annezazu
reviewed
Feb 19, 2021
ntsekouras
approved these changes
Feb 19, 2021
There was a problem hiding this comment.
Thank you @priethor ! Improvements in documentation are 💯 !!
|
Congratulations on your first merged pull request, @priethor! We'd like to credit you for your contribution in the post announcing the next WordPress release, but we can't find a WordPress.org profile associated with your GitHub account. When you have a moment, visit the following URL and click "link your GitHub account" under "GitHub Username" to link your accounts: https://profiles.wordpress.org/me/profile/edit/ And if you don't have a WordPress.org account, you can create one on this page: https://login.wordpress.org/register Kudos! |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Seeing there is some confusion regarding block variations and block style variations, I added this topic to the FAQ. I linked to the block styles variations filter but AFAIK there is no equivalent for
registerBlockVariation, just the @wordpress/blocks package API definition.