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

Add page for HTMLSelectElement showPicker() #29406

Merged
merged 6 commits into from
Dec 8, 2023

Conversation

lukewarlow
Copy link
Contributor

@lukewarlow lukewarlow commented Oct 1, 2023

Description

Add page for HTMLSelectElement showPicker()

Motivation

Added as a requirement of the HTML PR.

Additional details

HTML Spec PR: whatwg/html#9754

ChromeStatus Entry: https://chromestatus.com/feature/5111537299881984

Related issues and pull requests

Browser Compat Data PR: mdn/browser-compat-data#20852

EDIT - HamishW: Docs team tracking Issue: #30336

@github-actions
Copy link
Contributor

github-actions bot commented Oct 1, 2023

Preview URLs

Flaws (12)

Note! 3 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/HTMLSelectElement
Title: HTMLSelectElement
Flaw count: 12

  • macros:
    • /en-US/docs/Web/API/HTMLSelectElement/length does not exist
    • /en-US/docs/Web/API/HTMLSelectElement/multiple does not exist
    • /en-US/docs/Web/API/HTMLSelectElement/name does not exist
    • /en-US/docs/Web/API/HTMLSelectElement/required does not exist
    • /en-US/docs/Web/API/HTMLSelectElement/size does not exist
    • and 7 more flaws omitted

(comment last updated: 2023-12-08 00:46:30)

@lukewarlow
Copy link
Contributor Author

The Browser Compat Data PR has been merged.

@hamishwillee hamishwillee requested a review from a team as a code owner November 20, 2023 01:39
@hamishwillee hamishwillee requested review from Elchi3 and removed request for a team November 20, 2023 01:39
// showPicker() is supported.
}
```

Copy link
Collaborator

@hamishwillee hamishwillee Nov 20, 2023

Choose a reason for hiding this comment

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

Could we have an example of this being used? I'm thinking simple code like in the explainer:

<select id="select">
  <option>Item 1</option>
  <option>Item 2</option>
</select>
<button onclick="select.showPicker()">Show the select option picker</button>

Then we can explain WHY you don't just have the normal form submit or whatever here - i.e. why is this needed/useful.

Copy link
Collaborator

Choose a reason for hiding this comment

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

@lukewarlow I'll leave this to you and rereview when you ping me!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yep no worries! I'm out of office this week so it'll be next week but I'll make the requested changes to get this landed.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Excellent. I'm off after today until Friday week, so will review your changes then.

Copy link
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

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

Thanks for this. Looks great. A few questions/ comments such as https://github.com/mdn/content/pull/29406/files#r1398576219

@lukewarlow
Copy link
Contributor Author

@hamishwillee I've added that example. Haven't added a "use case" atm, not sure how best to word it potentially can be done as a follow up?

@lukewarlow lukewarlow requested a review from a team as a code owner December 8, 2023 00:44
@github-actions github-actions bot added the Content:Security Security docs label Dec 8, 2023
Copy link
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

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

Thanks @lukewarlow

  1. I see use case information as helpful but not mandatory.
  2. I've made a few subedit changes:
    • Headings are sentence case
    • "Usage" is probably OK here, but usually examples have specific titles about what they cover.
    • I hid the comment about live examples. It is useful if someone else comes along to edit this and decides to add the live example, but there is no expectation for readers.
    • I cross linked to the transient activation page and the input version of the method.
    • If you have any other questions about what I did feel free to ask.

This is good. Thanks so much for sorting it out.

@hamishwillee hamishwillee merged commit e312e15 into mdn:main Dec 8, 2023
7 checks passed
dipikabh pushed a commit to dipikabh/content that referenced this pull request Jan 17, 2024
* Add page for HTMLSelectElement showPicker()

* Minor subedit

* Update files/en-us/web/api/htmlselectelement/showpicker/index.md

* Update files/en-us/web/api/htmlselectelement/showpicker/index.md

* Add usage example code

* Subedit and cross link

---------

Co-authored-by: Hamish Willee <hamishwillee@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:Security Security docs Content:WebAPI Web API docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants