Skip to content

Convert webkitdirectory to standard - #45474

Merged
Josh-Cena merged 3 commits into
mdn:mainfrom
BaconMan1168:content/webkitdirectory-standardization-note
Sep 11, 2026
Merged

Josh-Cena merged 3 commits into
mdn:mainfrom
BaconMan1168:content/webkitdirectory-standardization-note

Conversation

@BaconMan1168

Copy link
Copy Markdown
Contributor

Description

Add a note to the <input type="file"> reference page's "Non-standard attributes" section explaining that webkitdirectory is in the process of being standardized.

Motivation

The issue reported that the page doesn't mention webkitdirectory is being standardized. I confirmed the current spec status before editing:

  • The WICG File and Directory Entries API spec, which defines webkitdirectory, explicitly states it "is not a W3C Standard nor is it on the W3C Standards Track" — it's a WICG Community Group draft, not a full standard.
  • browser-compat-data's entry for html/elements/input.json's webkitdirectory still has "standard_track": false.
  • The WHATWG HTML Standard does not define webkitdirectory.

Since it isn't yet part of a full WHATWG/W3C standard, I kept it in the "Non-standard attributes" section (rather than moving it out) and added a note pointing to the WICG spec that is standardizing it, so readers get the "it's on track to become standard" context the issue asked for without an inaccurate "this is now standard" claim.

I also checked the sibling HTMLInputElement.webkitdirectory property page — it doesn't make any explicit standard/non-standard text claim (its Specifications/Compat sections are auto-generated from BCD), so it's already consistent and didn't need a change.

Additional details

Related issues and pull requests

Fixes #45466

Add a note to the input/file non-standard attributes section
explaining that webkitdirectory is being standardized via the WICG
File and Directory Entries API spec, which is not yet a W3C standard
(browser-compat-data still marks it standard_track: false).
@BaconMan1168
BaconMan1168 requested a review from a team as a code owner September 3, 2026 01:40
@BaconMan1168
BaconMan1168 requested review from wbamberg and removed request for a team September 3, 2026 01:40
@github-actions github-actions Bot added Content:HTML Hypertext Markup Language docs size/xs [PR only] 0-5 LoC changed labels Sep 3, 2026
@github-actions

github-actions Bot commented Sep 3, 2026 •

Copy link
Copy Markdown
Contributor

Preview URLs (2 pages)

(comment last updated: 2026-09-11 22:39:46)

@Josh-Cena Josh-Cena left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

It is standardized. Please make it be documented as a standard attribute.

This also applies to the <input> page.

@Josh-Cena

Copy link
Copy Markdown
Member

Just saw that BCD says it's non-standard. I think you should get that fixed first because right now it's inconsistent with https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory.

Per review feedback on PR mdn#45474: webkitdirectory is defined in the
File and Directory Entries API (a WICG spec), matching the standard
track status already recorded for api.HTMLInputElement.webkitdirectory
in browser-compat-data. Move it out of the "Non-standard attributes"
sections on the <input type="file"> and <input> pages into the regular
attribute lists, alongside a companion browser-compat-data fix
(html.elements.input.webkitdirectory's standard_track) prepared
separately so the two stay consistent.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P2PaDYUv8Js2URx3GmpfP2
@BaconMan1168

Copy link
Copy Markdown
Contributor Author

Traced the inconsistency down: browser-compat-data has two entries for this feature with mismatched status. api.HTMLInputElement.webkitdirectory already has standard_track: true and a spec_url pointing to the File and Directory Entries API definition, but html.elements.input.webkitdirectory had standard_track: false with no spec_url. Opened mdn/browser-compat-data#30413 to align the two.

Pushed a commit here that moves webkitdirectory out of the "Non-standard attributes" sections on this page and on the <input> page, into the regular attribute lists, so both pages match once the BCD fix lands.

@github-actions github-actions Bot added size/s [PR only] 6-50 LoC changed and removed size/xs [PR only] 0-5 LoC changed labels Sep 3, 2026

@Josh-Cena Josh-Cena left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thank you, I think we can proceed regardless of the BCD status. Why was the BCD PR converted to draft?

Comment thread files/en-us/web/html/reference/elements/input/file/index.md Outdated
Comment thread files/en-us/web/html/reference/elements/input/index.md Outdated
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
@Josh-Cena Josh-Cena changed the title Note that webkitdirectory is being standardized Convert webkitdirectory to standard Sep 11, 2026
@Josh-Cena
Josh-Cena merged commit 6488b82 into mdn:main Sep 11, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:HTML Hypertext Markup Language docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

webkitdirectory of <input type="file"> is now standard

3 participants