{"id":329,"date":"2013-10-13T15:57:22","date_gmt":"2013-10-13T07:57:22","guid":{"rendered":"https:\/\/www.techcoil.com\/blog\/?p=329"},"modified":"2018-09-09T12:57:06","modified_gmt":"2018-09-09T04:57:06","slug":"how-to-use-jquery-to-intercept-form-submissions-and-validate-form-input","status":"publish","type":"post","link":"https:\/\/www.techcoil.com\/blog\/how-to-use-jquery-to-intercept-form-submissions-and-validate-form-input\/","title":{"rendered":"How to use jQuery to intercept form submissions and validate form input"},"content":{"rendered":"

There came a time where I had to create a HTML form to accept inputs from users in order to generate a report. Before submitting the form to the back end server, there are some validations that I can perform on the data at the client side to reduce the number of HTTP responses that my server had to generate for unwanted inputs. The cost savings is especially significant when the form submission contains large file as part of the HTTP request<\/a>.<\/p>\n

I chose to use jQuery for intercepting the form submissions and do some data validation before I allow the browser to create a HTTP request to the server. This post documents a proof of concept, as a stepping stone, to realize my objective.<\/p>\n

The sample scenario<\/h2 >\nI have a form that asks the user for a number via a text field. When the user clicks on the submit button, jQuery will help me intercept the form submission and check whether the data submitted by the user is a numeric value. If data submitted by user is not numeric, the codes will stop the form submission and prompt a message. <\/p>\n

JavaScript to intercept form submission and validate the data from the user<\/h2>\n
\r\n$(document).ready(\r\n\tfunction () {\t\r\n\t\t$('#numberInputForm').submit(\t\r\n\t\t\tfunction(event) {\r\n\t\t\t\tvar numberTextFieldVal = $('#numberTextField').val();\r\n\t\t\t\tif (isNaN(numberTextFieldVal) || numberTextFieldVal == '') {\r\n\t\t\t\t\twriteMessageToWebPage("Data submitted is not a number!");\r\n\t\t\t\t\tevent.preventDefault();\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t);\r\n\t}\r\n); \r\n<\/pre>\n
When the HTML document is ready, I attach a callback function for jQuery<\/code> to notify me when there is a form submission triggered from the form with numberInputForm<\/code> as the id. The callback function accepts a event object which can be used to stop the form submission later.<\/p>\n
I then get the value of the text field with numberTextField<\/code> as the id. Using the isNaN<\/code> function, I check if the value from the text field is not a number of if it is an empty string. If the value from the text field is not a number, I call the function writeMessageToWebPage<\/code>:<\/p>\n
\r\nfunction writeMessageToWebPage(msg) {\r\n\t$('#feedbackMsg').html(msg);\t\r\n}\r\n<\/pre>\n
and call event.preventDefault<\/code> to stop the form submission. The writeMessageToWebPage<\/code> function receives a message from its input parameter and set it as the HTML contents to the HTML element with feedbackMsg<\/code> as the id.<\/p>\n
The php codes that realized the HTML form<\/h2>\n
Referring to the HTML reference that I had created earlier<\/a>, I created a php script to generate the HTML codes for this proof of concept.<\/p>\n
\r\n<html>\r\n\t<head>\r\n\t<script type="text\/javascript" src="http:\/\/ajax.googleapis.com\/ajax\/libs\/jquery\/1.7.1\/jquery.min.js"><\/script>\r\n\t<script type="text\/javascript">\r\n\t\r\n\tfunction writeMessageToWebPage(msg) {\r\n\t\t\r\n\t\t$('#feedbackMsg').html(msg);\r\n\t\t\r\n\t}\r\n\t\r\n\t$(document).ready(\r\n\t\t\r\n\t\tfunction () {\r\n\t\t\t\r\n\t\t\t$('#numberInputForm').submit(\r\n\t\t\t\t\r\n\t\t\t\tfunction(event) {\r\n\t\t\t\t\t\r\n\t\t\t\t\tvar numberTextFieldVal = $('#numberTextField').val();\r\n\t\t\t\t\tif (isNaN(numberTextFieldVal) || numberTextFieldVal == '') {\r\n\t\t\t\t\t\twriteMessageToWebPage("Data submitted is not a number!");\r\n\t\t\t\t\t\tevent.preventDefault();\r\n\t\t\t\t\t}\r\n\t\t\t\t\t\r\n\t\t\t\t}\r\n\t\t\t\t\r\n\t\t\t);\r\n\t\t\t\r\n\t\t}\r\n\t\t\r\n\t); \r\n\t\r\n\t<\/script>\r\n\t<\/head>\r\n\t<body>\r\n\t\t<div id="feedbackMsg">\r\n<?php\r\n\t\t\tif (isset($_POST['numberTextField'])) {\r\n\t\t\t\techo 'You had just submitted the number: ' . $_POST['numberTextField'];\r\n\t\t\t}\r\n?>\t\t\t\r\n\t\t<\/div>\r\n\t\t<form id="numberInputForm" method="post" action="<?php echo $_SERVER['REQUEST_URI'];?>">\r\n\t\t<fieldset>\r\n\t\t\t<label for="numberTextField">Number:<\/label>\r\n\t\t\t<input id="numberTextField" name="numberTextField" type="text"\/>\r\n\t\t<\/fieldset>\r\n\t\t<fieldset>\r\n\t\t\t<input name="submitButton" type="submit" value="submit"\/>\r\n\t\t<\/fieldset>\r\n\t\t<\/form>\r\n\t<\/body>\r\n<\/html>\r\n<\/pre>\n
When a form submission is allowed, the browser will post the HTTP request to the same script that renders the form. The script checks if there is post data that is tagged with numberTextField<\/code>. If there is, it displays the value back to the user.<\/p>\n
\n   See how this proof of concept works<\/a>\n<\/div>\n\n