documentation for implementing date & time selectors

[apiuser]

Feature request from markoshust, posted on GitHub Sep 07, 2015

There is no documentation (or reference to other documentation) on implementing date & time selectors from the admin pattern library:

http://devdocs.magento.com/guides/v2.0/pattern-library/getting-user-input/date_time_selector/date_ti...

[apiuser]

Comment from almarchenko, posted on GitHub Sep 08, 2015

Hi!

This is implemented using the standard jQuery UI timepicker widget https://jqueryui.com/datepicker/ + addon https://github.com/magento/magento2/blob/develop/lib/web/jquery/jquery-ui-timepicker-addon.js

[apiuser]

Comment from markoshust, posted on GitHub Sep 08, 2015

Thank you very much -- it might be worth noting that in the pattern library and linking to the api documentation http://api.jqueryui.com/datepicker/

[apiuser]

Comment from markoshust, posted on GitHub Sep 09, 2015

I'm going to reopen this issue -- there appears to be some Magento2 magic going on behind the scenes, and it's very unclear what is going on with the datepicker, and how styles are pulled into the admin pages. I really think we need some clear documentation on this, along with how to implement all of the different date/datetime pickers.

[apiuser]

Comment from almarchenko, posted on GitHub Sep 09, 2015

"Thank you very much -- it might be worth noting that in the pattern library and linking to the api " Yeah, definitely you are right. There are several teams working on docs, we'll contact the team which authored the Admin Pattern Library.

" I'm going to reopen this issue... I really think we need some clear documentation on this" We'll create a ticket for adding detailed docs, but we'll need some time to write and publish them. Do you mind if we close this issue, once the internal one is created?

[apiuser]

Comment from markoshust, posted on GitHub Sep 09, 2015

Sure no prob

[apiuser]

Comment from almarchenko, posted on GitHub Sep 17, 2015

I've added links http://devdocs.magento.com/guides/v2.0/pattern-library/getting-user-input/date_time_selector/date_ti...

• the task of creating a detailed docs is in progress. Thank you!

[apiuser]

Comment from markoshust, posted on GitHub Nov 11, 2015

Can we re-open this ticket? This is not complete. I still don't know how to implement a timepicker, as there is no documentation.

[apiuser]

Comment from daim2k5, posted on GitHub Nov 11, 2015

Can you explain what we need to complete the task?

[apiuser]

Comment from markoshust, posted on GitHub Nov 11, 2015

We need code examples to show how to use the datepicker with an input field, for all variations (ex. Single Time Picker, Date Range Picker, Horizontal stacked, Vertical stacked... all of them, how to implement), for both Admin and Frontend implementations.

[apiuser]

Comment from tanberry, posted on GitHub Nov 13, 2015

Agreed, we need to expand the docs, and include code snippets and real-life examples. We will prioritize this for immediately post-GA work. Thanks @MarkShust, please keep the feedback coming; I hope you plan on watching the Keynote at MLAustralia next week! ;-)