From c7e4ffad4f3a70f1d980a56430ff0a9430164832 Mon Sep 17 00:00:00 2001
From: David Monjoie <dmo@odoo.com>
Date: Tue, 14 Mar 2017 10:48:14 +0100
Subject: [ADD] web: add date and datetime fields tests and documentation

---
 addons/web/static/src/js/fields/basic_fields.js | 29 +++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

(limited to 'addons/web/static/src/js/fields/basic_fields.js')

diff --git a/addons/web/static/src/js/fields/basic_fields.js b/addons/web/static/src/js/fields/basic_fields.js
index 17d68eaeda0..ec0c161e4e4 100644
--- a/addons/web/static/src/js/fields/basic_fields.js
+++ b/addons/web/static/src/js/fields/basic_fields.js
@@ -171,6 +171,11 @@ var FieldDate = InputField.extend({
     replace_element: true,
     supportedFieldTypes: ['date'],
 
+    /**
+     * In edit mode, instantiates a DateWidget datepicker and listen to changes.
+     *
+     * @override
+     */
     start: function () {
         var self = this;
         var def;
@@ -195,6 +200,12 @@ var FieldDate = InputField.extend({
     // Public
     //--------------------------------------------------------------------------
 
+    /**
+     * Automatically selects the input associated with the datepicker widget.
+     * When entering this field via a tab mechanism in list view for example.
+     *
+     * @override
+     */
     activate: function () {
         var $input = this.datewidget.$input;
         $input.focus();
@@ -205,9 +216,21 @@ var FieldDate = InputField.extend({
     // Private
     //--------------------------------------------------------------------------
 
+    /**
+     * Instantiates a new DateWidget datepicker.
+     *
+     * @private
+     */
     _makeDatePicker: function () {
         return new datepicker.DateWidget(this, {defaultDate: this.value});
     },
+
+    /**
+     * Set the datepicker to the right value rather than the default one.
+     *
+     * @override
+     * @private
+     */
     _renderEdit: function () {
         this.datewidget.set_value(this.value);
     },
@@ -221,6 +244,12 @@ var FieldDateTime = FieldDate.extend({
     // Private
     //--------------------------------------------------------------------------
 
+    /**
+     * Instantiates a new DateTimeWidget datepicker rather than DateWidget.
+     *
+     * @override
+     * @private
+     */
     _makeDatePicker: function () {
         return new datepicker.DateTimeWidget(this, {defaultDate: this.value});
     },
-- 
cgit v1.2.3