Tab or click through the form fields to see helpful hinters and your form progress
Firstly include jQuery and the progression.css and progress.js files. Place these before </head>
section
<link href='progression.css' rel='stylesheet' type='text/css'> <script type="text/javascript" src="https://s3.pstatp.com/cdn/expire-1-M/jquery/1.7.2/jquery.min.js"></script> <script type="text/javascript" src="progression.js"></script>
You must give your form a unique ID. You then need to add a data attribute of data-progression
to each element that needs to be a step in the form progression.
The helper text for the tooltip can be set by adding data-helper
to the element. This is demonstrated below
<form id="myform"> <p> <label for="">Name</label> <input data-progression="" type="text" data-helper="Help users through forms by prividing helpful hinters" name="name" value="" placeholder="" /> </p> </form>
Once you have created your form you will need to initiate the plugin.
At its most basic level you can initiate the plugin like:
$(document).ready(function ($) { $("#myform").progression(); });
If you want to initiate the plugin with options then you can do so like:
$("#myform").progression({ tooltipWidth: '200', tooltipPosition: 'right', tooltipOffset: '50', showProgressBar: true, showHelper: true, tooltipFontSize: '14', tooltipFontColor: 'fff', progressBarBackground: 'fff', progressBarColor: '6EA5E1', tooltipBackgroundColor: 'a2cbfa', tooltipPadding: '10', tooltipAnimate: true });
Variable | Default Value | Description | Valid Options |
---|---|---|---|
tooltipWidth | 200 | The width in pixels that you would like the tooltip to be | |
tooltipPosition | right | Whether the tooltip should sit to the left or right of the form | left/right |
tooltipOffset | 50 | The width in pixels that you would like the offset of the tooltip to be | |
showProgressBar | true | Whether the progress bar should be displayed or not | true/false |
showHelper | true | Whether the helper text should be shown or not | true/false |
tooltipFontSize | 14 | Set the font size of the helper text in pixels | |
tooltipFontColor | ffffff | The hash color reference of the helper text | |
progressBarBackground | ffffff | The hash color reference of the progress bar background | |
progressBarColor | 6EA5E1 | The hash color reference of the progress bar | |
tooltipPadding | 10 | The padding for the tooltip in pixels | |
tooltipAnimate | true | Whether to animate the tooltip or not | true/false |