A dropdown list can be used to select a value, based on which we can filter the data to be displayed. For example, the extension page has a dropdown list to filter the displayed extensions according to the selected category.
The following is the view code used for the category filter in the extension page:
echo CHtml::form('','get'); Category: echo CHtml::dropDownList('cat', isset($_GET['cat'])?(int)$_GET['cat']:0, CHtml::listData($categories,'id','name'), array('empty'=>'All categories', 'submit'=>'')); </form>
We first create a form which uses GET as the submission method. We then use [CHtml::dropDownList] to create the dropdown list. We specify two HTML options for the dropdown list:
- empty: this displays an extra dropdown list item at the beginning because this item is not provided by the
- submit: this makes the dropdown list to be able to submit the form. If you change the current selection, the form enclosing the dropdown list will be submitted to the current page (because the submit value is empty).
Once the form is submitted, we will obtain a
cat GET variable which contains the current category selection. We use this value to filter the extensions and display the corresponding results.