[ADD] web: add email widget tests and documentation

1 files changed, 17 insertions, 0 deletions

diff --git a/addons/web/static/src/js/fields/basic_fields.js b/addons/web/static/src/js/fields/basic_fields.js
index c78b36f907c..f168d8cc69f 100644
--- a/addons/web/static/src/js/fields/basic_fields.js
+++ b/addons/web/static/src/js/fields/basic_fields.js
@@ -590,10 +590,27 @@ var HandleWidget = AbstractField.extend({
 var EmailWidget = InputField.extend({
     prefix: 'mailto',
     supportedFieldTypes: ['char'],
+
+    /**
+     * In readonly, emails should be a link, not a span.
+     *
+     * @override
+     */
     init: function () {
         this._super.apply(this, arguments);
         this.tagName = this.mode === 'readonly' ? 'a' : 'input';
     },
+
+    //--------------------------------------------------------------------------
+    // Private
+    //--------------------------------------------------------------------------
+
+    /**
+     * In readonly, emails should be a mailto: link with proper formatting.
+     *
+     * @override
+     * @private
+     */
     _renderReadonly: function () {
         this.$el.text(this.value)
             .addClass('o_form_uri o_text_overflow')