Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README for SelectControl #28811

Merged
merged 1 commit into from
Oct 16, 2021
Merged

Update README for SelectControl #28811

merged 1 commit into from
Oct 16, 2021

Conversation

JohnRDOrazio
Copy link
Contributor

Even though the multiple attribute is foreseen as a possible attribute, the wording of the handbook seems to exclude the possibility of selecting multiple options from the list. This fix clears up the wording to allow for both single and multiple selections from the list.

Types of changes

Wording of the README for the SelectControl component.

@JohnRDOrazio
Copy link
Contributor Author

fixes issue #28812

- There is a strong default option.
- There is little available space.
- The contents of the hidden part of the menu are obvious from its label and the one selected item. For example, if you have an option menu labelled “Month:” with the item “January” selected, the user might reasonably infer that the menu contains the 12 months of the year without having to look.

If you have a shorter list of options, or need all of the options visible to the user, consider using RadioControl instead.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I removed this because the way the multiselects are designed by browsers, all of the options are visible to the user, or at least will have a vertical scroll so as to scroll through the options. With the multiple attribute, there is no dropdown as in the single selection.

@gziolo gziolo added the [Package] Components /packages/components label Feb 7, 2021
Base automatically changed from master to trunk March 1, 2021 15:45
Even though the `multiple` attribute is foreseen as a possible attribute, the wording of the handbook seems to exclude the possibility of selecting multiple options from the list. This fix clears up the wording to allow for both single and multiple selections from the list.
Copy link
Member

@mkaz mkaz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for contributing to the documentation and clarifying the usage of the select control. These changes look good around the usage of multiple. 👍

I rebased and updated the branch so it is good merge.

@mkaz mkaz merged commit 96b3508 into WordPress:trunk Oct 16, 2021
@github-actions
Copy link

Congratulations on your first merged pull request, @JohnRDOrazio! 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!

@github-actions github-actions bot added this to the Gutenberg 11.8 milestone Oct 16, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository [Package] Components /packages/components [Type] Developer Documentation Documentation for developers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants