Closed Bug 866440 Opened 11 years ago Closed 7 years ago

Documentation for the <input type=date> implementation

Categories

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

All
Other
defect

Tracking

(Not tracked)

RESOLVED FIXED

People

(Reporter: fs, Assigned: teoli)

References

()

Details

(Whiteboard: u=webdev p=2 c=HTML)

:: Developer Documentation Request

      Request Type: New Documentation
     Gecko Version: 20 Branch
 Technical Contact: mounir@lamouri.fr

:: 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
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
Whiteboard: u=webdev p=2 c=HTML
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.
This got done https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/date
Status: NEW → RESOLVED
Closed: 7 years ago
Resolution: --- → FIXED
You need to log in before you can comment on or make changes to this bug.