Quick Start

In this quick start, you'll learn how to add the TextBox widget to an HTML project using HTML markup and jQuery script.

To create a new HTML page in your favorite text editor, add the following code and save the document with an .html extension.
Drop down and copy markup
Paste in your favorite text editor.
Copy Code

<!DOCTYPE HTML> <HTML> <head> </head> <body> </body> </HTML>

Paste in your favorite text editor.	Copy Code
<!DOCTYPE HTML> <HTML> <head> </head> <body> </body> </HTML>

Add links to the dependencies to your HTML page within the <head> tags. Find the latest dependencies in the content delivery network (CDN) file at wijmo cdn.

References	Copy Code
<!--jQuery References--> <script src="http://code.jquery.com/jquery-1.11.1.min.js" type="text/javascript"></script> <script src="http://code.jquery.com/ui/1.11.0/jquery-ui.min.js" type="text/javascript"></script> <!--Theme--> <link href="http://cdn.wijmo.com/themes/aristo/jquery-wijmo.css" rel="stylesheet" type="text/css" /> <!--Wijmo Widgets CSS--> <link href="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20183.140.min.css" rel="stylesheet" type="text/css" /> <!--Wijmo Widgets JavaScript--> <script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20183.140.min.js" type="text/javascript"></script> <script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20183.140.min.js" type="text/javascript"></script> <script src="http://cdn.wijmo.com/interop/wijmo.data.ajax.3.20183.140.js" type="text/javascript"></script> <!--Knockout JS Library--> <script src="http://cdn.wijmo.com/external/knockout-3.1.0.js" type="text/javascript"></script> <!--Wijmo Knockout Integration Library--> <script src="http://cdn.wijmo.com/interop/knockout.wijmo.3.20183.140.js" type="text/javascript"></script>

References

Copy Code

<!--jQuery References--> 
<script src="http://code.jquery.com/jquery-1.11.1.min.js" type="text/javascript"></script>
<script src="http://code.jquery.com/ui/1.11.0/jquery-ui.min.js" type="text/javascript"></script>

<!--Theme-->
<link href="http://cdn.wijmo.com/themes/aristo/jquery-wijmo.css" rel="stylesheet" type="text/css" />

<!--Wijmo Widgets CSS-->
<link href="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20183.140.min.css" rel="stylesheet" type="text/css" />

<!--Wijmo Widgets JavaScript-->
<script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20183.140.min.js" type="text/javascript"></script>
<script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20183.140.min.js" type="text/javascript"></script>
<script src="http://cdn.wijmo.com/interop/wijmo.data.ajax.3.20183.140.js" type="text/javascript"></script>
 
<!--Knockout JS Library-->
<script src="http://cdn.wijmo.com/external/knockout-3.1.0.js" type="text/javascript"></script>
  
<!--Wijmo Knockout Integration Library-->
<script src="http://cdn.wijmo.com/interop/knockout.wijmo.3.20183.140.js" type="text/javascript"></script>

Add the following markup within the <body> tags to create the widget. This markup adds three textbox widgets to your page.

The first <input> element creates the text input widget, with its id option set to 'textbox' and its type option set to 'text.' The text input accepts a single line of text.
The second <input> element creates the password widget, with its id option set to 'textbox' and its type option set to 'password.' The password input hides text as it is entered.
The <textarea> element creates the resizable text area widget, with its id option set to 'area' and its rows and cols options set to '5' and '50.' The rows and cols options set the size of the area.

Markup	Copy Code
<h3>Text Input</h3> <input id="textbox" type="text" / > <h3>Password Input</h3> <input id="textbox" type="password" /> <h3>Text Area</h3> <textarea id="area" rows="5" cols="50"></textarea>

Within the <head> tags, below the references, add the following script to initialize each of the three textbox widgets and add a watermark, text that disappears when the user begins typing, to each.

Script	Copy Code
<script type="text/javascript"> $(document).ready(function () { $(":input[type='text'],:input[type='password'],textarea").wijtextbox(); var watermark = 'Collect user names, hide password input, and allow users to resize a multi-line text area.'; $(":input[type='text'],:input[type='password'],textarea").blur(function () { if ($(this).val().length == 0) $(this).val(watermark).addClass('watermark'); }).focus(function () { if ($(this).val() == watermark) $(this).val('').removeClass('watermark'); }).val(watermark).addClass('watermark'); }); </script>

Script

Copy Code

<script type="text/javascript">
    $(document).ready(function () {
        $(":input[type='text'],:input[type='password'],textarea").wijtextbox();
        var watermark = 'Collect user names, hide password input, and allow users to resize a multi-line text area.';
        $(":input[type='text'],:input[type='password'],textarea").blur(function () {
            if ($(this).val().length == 0)
                $(this).val(watermark).addClass('watermark');
        }).focus(function () {
            if ($(this).val() == watermark)
                $(this).val('').removeClass('watermark');
        }).val(watermark).addClass('watermark');
    });
</script>

Save your HTML file and open it in a browser. The widget appears like the following live widget. Click inside any of the TextBox widgets to see the watermark disappear.

Reference

Concepts

KO