Use built-in AJAX to create a list of second-level linkages under the YII Framework

Use built-in AJAX to create a list of second-level linkages under the YII Framework

Often you'll need a form with two dropdowns, and one dropdown's values will be dependent on the value of the other dropdown. using Yii's built-in AJAX functionality you can create such a dropdown.

View of the form

We'll show a form that shows countries and dependent of the country selected will show cities.

echo CHtml::dropDownList('country_id','', array(1=>'USA',2=>'France',3=>'Japan'),    array(        'ajax' => array(            'type'=>'POST',             'url'=>CController::createUrl('currentController/dynamiccities'),            //Style: CController::createUrl('currentController/methodToCall')            'update'=>'#city_id', //selector to update            //'data'=>'js:javascript statement'             //leave out the data key to pass all form values through        )    )); //empty since it will be filled by the other dropdownecho CHtml::dropDownList('city_id','', array());

The first dropdown is filled with several value/name pairs of countries. whenever it is changed an ajax request will be done to the 'dynamiccities 'Action of the current controller. the result of that request (output of the 'dynamiccities 'action) will be placed in the second dropdown with id is # city_id.

Controller action method

It will have to output the html to fill the second dropdownlist. Furthermore it will do that dependent on the value of the first dropdown.

public function actionDynamiccities(){    $data=Location::model()->findAll('parent_id=:parent_id',           array(':parent_id'=>(int) $_POST['country_id']));    $data=CHtml::listData($data,'id','name');    foreach($data as $value=>$name)    {        echo CHtml::tag('option',           array('value'=>$value),CHtml::encode($name),true);    }}

It will retrieve all cities that have as a parent the id of the first dropdown. It will then output all those cities using the tag and the output will end up in the second dropdown.

You might wonder where the $ _ POST ['country _ id'] comes from. it's simple, when the 'data' key of the ajax array in the first dropdown is empty, all values of the elements of the form the dropdown is in, will be passed to the controller via the ajax request. if you're using Firebug you can inspect this request and see for yourself.

This behaviour can also be changed. By default the value of the 'data' key in the ajax configuration array isjs:jQuery(this).parents("form").serialize(). The preceding?js:? Indicates to Yii that a javascript statement will follow and thus shocould not be escaped. so, if you change the 'data' key to something else preceded by 'JS: 'you can fill in your own statement. the same applies to the 'success' parameter.

For this to work you also need to edit the Method accessRules () (if available) in your current Controller. In this example we wocould change

array('allow', // allow authenticated user to perform 'create' and 'update' actions    'actions'=>array('create','update'),    'users'=>array('@'),),

To

array('allow', // allow authenticated user to perform 'create' and 'update' actions    'actions'=>array('create','update','dynamiccities'),    'users'=>array('@'),),

N order to allow access for authenticated Users to our Method 'dynamiccities '. To allow access to eg any User or to use more complex rules please read more about accessRules and Authentication? Here.