Documentation
Getting Started
jqxDropDownList represents a jQuery widget that contains a list of selectable items displayed in a drop-down.Every UI widget from jQWidgets toolkit needs its JavaScript files to be included in order to work properly.
The first step is to create html page and add links to the javascript files and css dependencies to your project. The jqxDropDownList widget requires the following files:
<head><link rel="stylesheet" href="../../jqwidgets/styles/jqx.base.css" type="text/css"/><script type="text/javascript" src="../../scripts/jquery-1.11.1.min.js"></script><script type="text/javascript" src="../../jqwidgets/jqxcore.js"></script><script type="text/javascript" src="../../jqwidgets/jqxbuttons.js"></script><script type="text/javascript" src="../../jqwidgets/jqxscrollbar.js"></script><script type="text/javascript" src="../../jqwidgets/jqxlistbox.js"></script><script type="text/javascript" src="../../jqwidgets/jqxdropdownlist.js"></script> <script async src="https://www.googletagmanager.com/gtag/js?id=G-2FX5PV9DNT"></script><script>window.dataLayer = window.dataLayer || [];function gtag(){dataLayer.push(arguments);}gtag('js', new Date());gtag('config', 'G-2FX5PV9DNT');</script></head>
The next step is to create a div element within the body of the html document.
<div id='jqxdropdownlist'></div>
The last step is to initialize the widget by adding the following script to the html document:
var source = [ "Instant coffee", "Irish coffee", "Liqueur coffee"];// Create a jqxDropDownList$("#jqxdropdownlist").jqxDropDownList({ source: source, width: '200px', height: '25px'});
To call a function(method), you need to pass the method name and parameters(if any) in the jqxDropDownList’s constructor.
To get the result of a function(method) call, you need to pass the method name in the jqxDropDownList’s constructor.$("#jqxdropdownlist").jqxDropDownList(‘selectIndex’, 1);
To set a property(option), you need to pass the property name and value(s) in the jqxDropDownList's constructor.$("#jqxdropdownlist").jqxDropDownList(‘getSelectedIndex’);
To get a property(option), you need to pass the property name to the jqxDropDownList's constructor.$("#jqxdropdownlist").jqxDropDownList({ selectedIndex: 2 });
To bind to an event of a UI widget, you can use basic jQuery syntax. Let’s suppose that you want to get the selected item when the user clicks. The example code below demonstrates how to bind to the ‘select’ event of jqxDropDownList.var index = $("#jqxdropdownlist").jqxDropDownList('selectedIndex');
$('#jqxDropDownList').on('select', function (event) {var args = event.args;var item = $('#jqxDropDownList').jqxDropDownList('getItem', args.index);});
Basic Sample
<!DOCTYPE html><html lang="en"><head> <title>jQuery DropDownList Sample</title> <link rel="stylesheet" href="../../jqwidgets/styles/jqx.base.css" type="text/css" /> <script type="text/javascript" src="../../scripts/jquery-1.11.1.min.js"></script> <script type="text/javascript" src="../../jqwidgets/jqxcore.js"></script> <script type="text/javascript" src="../../jqwidgets/jqxbuttons.js"></script> <script type="text/javascript" src="../../jqwidgets/jqxscrollbar.js"></script> <script type="text/javascript" src="../../jqwidgets/jqxlistbox.js"></script> <script type="text/javascript" src="../../jqwidgets/jqxdropdownlist.js"></script><script async src="https://www.googletagmanager.com/gtag/js?id=G-2FX5PV9DNT"></script><script>window.dataLayer = window.dataLayer || [];function gtag(){dataLayer.push(arguments);}gtag('js', new Date());gtag('config', 'G-2FX5PV9DNT');</script></head><body> <div id='content'> <script type="text/javascript"> $(document).ready(function () { var source = [ "Affogato", "Americano", "Bicerin", "Breve", "Café Bombón", "Café au lait", "Caffé Corretto", "Café Crema", "Caffé Latte", ]; // Create a jqxDropDownList $("#jqxdropdownlist").jqxDropDownList({ source: source, selectedIndex: 0, width: '200px', height: '25px' }); // disable the sixth item. $("#jqxdropdownlist").jqxDropDownList('disableAt', 5); // bind to 'select' event. $('#jqxdropdownlist').bind('select', function (event) { var args = event.args; var item = $('#jqxdropdownlist').jqxDropDownList('getItem', args.index); alert('Selected: ' + item.label); }); }); </script> <div id='jqxdropdownlist'> </div> </div></body></html>