- added ParsleyUI.getErrorsMessages() (Closes #607)

CHANGELOG.md

@@ -17,6 +17,7 @@
   - added requirejs AMD support for `dist/parsley.js` and `dist/parsley.min.js`
     versions (#606)
   - fixed custom namespace -multiple that didn't re-evaluated correctly (#595)
+  - added `ParsleyUI.getErrorsMessages()` (Closes #607)
 
 ## 2.0.0-rc5
 

dist/parsley.js

@@ -1,7 +1,7 @@
 /*!
 * Parsleyjs
 * Guillaume Potier - <guillaume@wisembly.com>
-* Version 2.0.0-rc5 - built Thu Apr 17 2014 18:53:10
+* Version 2.0.0-rc5 - built Thu Apr 17 2014 19:33:56
 * MIT Licensed
 *
 */
@@ -1137,6 +1137,16 @@
       if ((diff.kept.length || diff.added.length) && 'undefined' === typeof fieldInstance._ui.failedOnce)
         this.manageFailingFieldTrigger(fieldInstance);
     },
+    // Returns an array of field's error message(s)
+    getErrorsMessages: function (fieldInstance) {
+      // No error message, field is valid
+      if (true === fieldInstance.validationResult)
+        return [];
+      var messages = [];
+      for (var i = 0; i < fieldInstance.validationResult.length; i++)
+        messages.push(this._getErrorMessage(fieldInstance, fieldInstance.validationResult[i].assert));
+      return messages;
+    },
     manageStatusClass: function (fieldInstance) {
       if (true === fieldInstance.validationResult)
         this._successClass(fieldInstance);

dist/parsley.remote.js

@@ -255,7 +255,7 @@ window.ParsleyConfig.validators.remote = {
 /*!
 * Parsleyjs
 * Guillaume Potier - <guillaume@wisembly.com>
-* Version 2.0.0-rc5 - built Thu Apr 17 2014 18:53:10
+* Version 2.0.0-rc5 - built Thu Apr 17 2014 19:33:56
 * MIT Licensed
 *
 */
@@ -1391,6 +1391,16 @@ window.ParsleyConfig.validators.remote = {
       if ((diff.kept.length || diff.added.length) && 'undefined' === typeof fieldInstance._ui.failedOnce)
         this.manageFailingFieldTrigger(fieldInstance);
     },
+    // Returns an array of field's error message(s)
+    getErrorsMessages: function (fieldInstance) {
+      // No error message, field is valid
+      if (true === fieldInstance.validationResult)
+        return [];
+      var messages = [];
+      for (var i = 0; i < fieldInstance.validationResult.length; i++)
+        messages.push(this._getErrorMessage(fieldInstance, fieldInstance.validationResult[i].assert));
+      return messages;
+    },
     manageStatusClass: function (fieldInstance) {
       if (true === fieldInstance.validationResult)
         this._successClass(fieldInstance);

doc/index.html

@@ -867,6 +867,10 @@ <h3 id="ui-for-javascript">UI for javascript</h3>
               <td><code>window.ParsleyUI.removeError(parsleyInstance, name);</code></td>
               <td>Manually remove an error message.</td>
             </tr>
+            <td>Get errors messages <version>#2.0</version></td>
+              <td><code>window.ParsleyUI.getErrorsMessages(parsleyInstance);</code></td>
+              <td>Returns an array of the field errors messages displayed once validated.</td>
+            </tr>
           </tbody>
         </table>
         <!-- ****************** Events ****************** -->

src/parsley/ui.js

@@ -49,6 +49,20 @@ define('parsley/ui', [
         this.manageFailingFieldTrigger(fieldInstance);
     },
 
+    // Returns an array of field's error message(s)
+    getErrorsMessages: function (fieldInstance) {
+      // No error message, field is valid
+      if (true === fieldInstance.validationResult)
+        return [];
+
+      var messages = [];
+
+      for (var i = 0; i < fieldInstance.validationResult.length; i++)
+        messages.push(this._getErrorMessage(fieldInstance, fieldInstance.validationResult[i].assert));
+
+      return messages;
+    },
+
     manageStatusClass: function (fieldInstance) {
       if (true === fieldInstance.validationResult)
         this._successClass(fieldInstance);

test/dev.html

@@ -55,7 +55,7 @@
         <input type="submit">
     </form> -->
 
-<!--     <form id="parsley" data-parsley-validate>
+    <form id="parsley" data-parsley-validate>
         <select name="plan" id="plan" class="form-control first" required="">
             <option selected="selected" value="">Please select</option>
             <option value="1200">1200 Calories</option>
@@ -64,9 +64,9 @@
         </select>
         <input type="submit" />
         <input type="reset" onclick="javascript:$('#parsley').parsley().destroy();" />
-    </form> -->
+    </form>
 
-    <form id="doesntwork">
+<!--     <form id="doesntwork">
         <h2>doesnt work</h2>
         <div>
             <label>
@@ -77,21 +77,22 @@ <h2>doesnt work</h2>
         <div>
             <button type="submit">go</button>
         </div>
-    </form>
+    </form> -->
 
-    <script src="../bower_components/jquery/jquery.js"></script>
+    <!-- <script src="../bower_components/jquery/jquery.js"></script> -->
     <!-- <script src="../src/parsley.remote.js"></script> -->
     <!-- <script src="../src/extra/dateiso.js"></script> -->
     <!-- <script src="../src/i18n/fr.extra.js"></script> -->
-    <script src="../dist/parsley.js"></script>
-    <!-- <script src="../bower_components/requirejs/require.js" data-main="../src/main"></script></body> -->
+    <!-- <script src="../src/i18n/fr.js"></script> -->
+    <!-- <script src="../dist/parsley.js"></script> -->
+    <script src="../bower_components/requirejs/require.js" data-main="../src/main"></script></body>
     <!-- <script src="../src/i18n/it.js"></script> -->
 
     <script type="text/javascript">
-        $(document).ready(function () {
-            $('#doesntwork').parsley({
-                namespace: 'data-validate-'
-            });
-        });
+        // $(document).ready(function () {
+        //     $('#doesntwork').parsley({
+        //         namespace: 'data-validate-'
+        //     });
+        // });
     </script>
 </html>

test/features/ui.js

@@ -254,6 +254,18 @@ define(function () {
         expect($('#element').hasClass('parsley-error')).to.be(false);
         expect($('ul#parsley-id-' + parsleyField.__id__ + ' li').length).to.be(0);
       });
+      it('should have a getErrorsMessage() method', function () {
+        $('body').append('<input type="email" id="element" value="foo" data-parsley-minlength="5" />');
+        var parsleyInstance = $('#element').parsley();
+        parsleyInstance.validate();
+        expect(window.ParsleyUI.getErrorsMessages(parsleyInstance).length).to.be(1);
+        expect(window.ParsleyUI.getErrorsMessages(parsleyInstance)[0]).to.be('This value should be a valid email.');
+
+        $('#element').attr('data-parsley-priority-enabled', false);
+        parsleyInstance.validate();
+        expect(window.ParsleyUI.getErrorsMessages(parsleyInstance).length).to.be(2);
+        expect(window.ParsleyUI.getErrorsMessages(parsleyInstance)[0]).to.be('This value is too short. It should have 5 characters or more.');
+      });
       afterEach(function () {
         if ($('#element').length)
           $('#element').remove();