866440 - Documentation for the <input type=date> implementation

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: HTML, defect, P5)

Description

[Florian Scholz (Open Web Docs)]

:: Developer Documentation Request

      Request Type: New Documentation
     Gecko Version: 20 Branch
 Technical Contact: [e-mail]

:: Details

Specification:
http://www.whatwg.org/specs/web-apps/current-work/multipage/states-of-the-type-attribute.html#date-state-%28type=date%29

Needs release notes:
https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Releases/20

MDN pages probably in need of an update:
https://developer.mozilla.org/en-US/docs/HTML/Element/Input
https://developer.mozilla.org/en-US/docs/DOM/HTMLInputElement

Information out of bug 769352:
"The plan is to have the DOM bits done and use the native widgets on Android and do a UI on B2G. We will disable it on desktop as long as we don't have a UI there."
"DOM implementation is now complete and lives behind a pref: "dom.experimental_forms". Given that the implementation comes with no UI, it is only available on Mobile."

Sanitizing algorithm for <input type=date>, bug 769379:
http://www.whatwg.org/specs/web-apps/current-work/multipage/common-microsyntaxes.html#valid-date-string

Properties documentation:
* .valueAsNumber and .valueAsDate (conversions between string/date and string/number), bug 769370
* NaN and Infinity passed to .valueAsNumber, bug 825009
* .min, bug 769357
* .max, bug 769355
* .step, bug 769359 
Implementation details for step (see bug 769359 c6):
"If applying value += step*n returns a value that is not a date, (i.e. a timestamp not corresponding to a date whose time is set on midnight UTC), then we return the next valid date that is not in step mismatch.
For example with <input type='date' min='2012-08-17' step='1.5' value='2012-08-18'> stepUp() will return "2012-08-20"."

Possibly interesting bugs, but not yet resolved:
User Interface for Desktop: bug 773205
User Interface for Mobile: bug 446510

Comment 1

[Florian Scholz (Open Web Docs)]

Additional implementation details on .valueAsDate:
Bug 826305 - .valueAsDate shouldn't set the value to the empty string if the passed value isn't a Date

Comment 2

[Mounir Lamouri (:mounir)]

The implementation status is the following:
- Firefox Android: available by default;
- Firefox OS: available by default;
- Firefox Desktop: disabled by default.

The preference to toggle this feature is "dom.experimental_forms".

Florian, feel free to let me know if you have any question.

Comment 3

[Florian Scholz (Open Web Docs)]

This got done https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/date