Skip to main content

Yii CHtml static class

Avaiable methods:

CHtml::link() method 

public static string link(string $text, mixed $url='#', array $htmlOptions=array ( ))
Generates a hyperlink tag.
Example 1: Linking to a controller action
<?php echo CHtml::link('Link Text',array('controller/action')); ?>
HTML Output:
<a href="index.php?r=controller/action">Link Text</a>
Example 2: Linking to a controller action with querystring parameters
<?php echo CHtml::link('Link Text',array('controller/action',
                                         'param1'=>'value1')); ?>
HTML Output:
<a href="index.php?r=controller/action&param1=value1">Link Text</a>
Example 3: Linking to a controller action with multiple querystring parameters
<?php echo CHtml::link('Link Text',array('controller/action',
                                         'param1'=>'value1',
                                         'param2'=>'value2',
                                         'param3'=>'value3')); ?>
HTML Output:
<a href="index.php?r=controller/action&param1=value1&param2=value2&param3=value3">Link Text</a>
Example 4: Link opening a new page
<?php echo CHtml::link('Link Text',array('controller/action',
                   'param1'=>'value1'), array('target'=>'_blank'); ?>
HTML Output:
<a target="_blank" href="index.php?r=controller/action&param1=value1">Link Text</a>
Example 5: Linking to a controller action inside the actual controller (Suppose you are in the PostController/view and wants to link to PostController/create)
Just remove the 'controller' part from the string
<?php echo CHtml::link('Link Text',array('action')); ?>
If you are linking to an action from another controller, use the syntax of the former examples.
Example 6: Linking to a controller action from the site root (Suppose you are inside a module and wants to make the link from a controller of the root application)
In this case, add an slash "/" at the start of the string url
<?php echo CHtml::link('Link Text',array('/controller/action')); ?>
This makes more sense if you are working with modules.
Example 7: Linking to a controller action from another module
Replace below the module-id with desired module id .
<?php echo CHtml::link('Link Text',array('/module-id/controller/action')); ?>
Example 8: Linking to a controller action from the same module
This is useful when you want to make absolute paths avoiding to use static module names.
<?php echo CHtml::link('Link Text',array('/{$this->module->id}/controller/action')); ?>
Example 9: Linking to a controller action via POST with confirmation dialog
Delete actions created using gii require the delete request be sent via POST to help prevent deleting objects by accident. Below is an example how to create a link that sends the request via POST and also asks for confirmation. Where you are redirected after the delete depends on your delete action. Note that the id link parameter below is a GET type parameter (submit URL will be something likehttp://example.com/post/delete/id/100).
<?php echo CHtml::link('Delete',"#", array("submit"=>array('delete', 'id'=>$data->ID), 'confirm' => 'Are you sure?')); ?>
If you are using CSRF protection in your application do not forget to add csrf parameter to the htmlOptions array.
<?php echo CHtml::link('Delete',"#", array("submit"=>array('delete', 'id'=>$data->ID), 'confirm' => 'Are you sure?', 'csrf'=>true)); ?>
Example 10: Linking to a controller action via POST with POST parameters
If you need to make POST request with arbitary link with additional POST parameters you should use following code (submit URL will be something like http://example.com/blog/deletePost/param/100).
<p><?php echo lnk('Delete blog post', '#', array(
    'submit'=>array('blog/deletePost', 'param'=>100),
    'params'=>array('id'=>$post->id, 'status'=>Post::STATUS_DELETED_BY_OWNER),
    'csrf'=>true,
)); ?></p>

CHtml::ajaxLink() method 

Syntax:
public static string ajaxLink(string $text, mixed $url, array $ajaxOptions=array ( ), array $htmlOptions=array ( ))
Default example
echo CHtml::ajaxLink(
    $text = 'Click me', 
    $url = '/', 
    $ajaxOptions=array (
        'type'=>'POST',
        'dataType'=>'json',
        'success'=>'function(html){ jQuery("#your_id").html(html); }'
        ), 
    $htmlOptions=array ()
    );
Example #1 : Ajax request using ajaxLink
//In view:
 
echo CHtml::ajaxLink(
    'Test request',          // the link body (it will NOT be HTML-encoded.)
    array('ajax/reqTest01'), // the URL for the AJAX request. If empty, it is assumed to be the current URL.
    array(
        'update'=>'#req_res'
    )
);
 
echo '<div id="req_res">...</div>';
 
 
//In controller
public function actionReqTest01() {
    echo date('H:i:s');
    Yii::app()->end();
}
Example #2 : Ajax request using ajaxLink with loading image
//In view:
echo CHtml::ajaxLink(
    'Test request',          // the link body (it will NOT be HTML-encoded.)
    array('ajax/reqTest01Loading'), // the URL for the AJAX request. If empty, it is assumed to be the current URL.
    array(
        'update'=>'#req_res_loading',
        'beforeSend' => 'function() {           
           $("#maindiv").addClass("loading");
        }',
        'complete' => 'function() {
          $("#maindiv").removeClass("loading");
        }',        
    )
);
 
echo '<div id="req_res_loading">...</div>';
 
 
//In controller:
public function actionReqTest01Loading() {
       sleep(4);   // Sleep for 4 seconds just to demonstrate the Loading Image can be seen, for learning purpose only      
       echo date('H:i:s');
    Yii::app()->end();
}
Reference: Ajaxlink

CHtml::button() method 

public static string button(string $label='button', array $htmlOptions=array ( ))
Generates a button.
Example 1: Connecting a button to a controller action
<?php echo CHtml::button('Button Text', array('submit' => array('controller/action'))); ?>
HTML Output:
<input id="yt0" type="button" value="Button Text" name="yt0"/>
<script type="text/javascript">
/*<![CDATA[*/
jQuery(document).ready(function() {
             jQuery('#yt0').click(function( {
                            jQuery.yii.submitForm(
                                     this,
                                     'controller/action',{}
                                          );return false;});
                                  });
/*]]>*/
</script>

CHtml::textField() method 

public static function textField($name,$value='',$htmlOptions=array())
Generates a textfield.
Example 1: Generating an empty textfield, just with a name
<?php echo CHtml::textField('Text'); ?>
Example 2: Generating a textfield with name and value
<?php echo CHtml::textField('Text', 'some value'); ?>
Example 3: Generating a textfield with customized id, width and maxlength
<?php echo CHtml::textField('Text', 'some value',
 array('id'=>'idTextField', 
       'width'=>100, 
       'maxlength'=>100); ?>
*Note: use 'cols' instead of 'width' when working with textareas
Example 4: Generating a disabled textfield
<?php echo CHtml::textField('Text', 'some value', 
    array('disabled'=>'disabled'); ?>

CHtml::listData() method 

public static function listData($models,$valueField,$textField,$groupField='')
Generates data for dropDownList and listBox, using the format $key=>$value.
Example 1: Generating a list data for categories
<?php 
     /*you can use here any find method you think 
     proper to return your data from db*/
     $models = categories::model()->findAll();
 
     // format models resulting using listData     
     $list = CHtml::listData($models, 
                'category_id', 'category_name');    
 
     print_r($list);
HTML Output (Example):
array("1" => "Arts", "2" => "Science", "3" => "Culture");
Example 2: Generating an ordered list data for categories using findAll parameter
<?php 
     $models = categories::model()->findAll(
                 array('order' => 'category_name'));
 
     $list = CHtml::listData($models, 
                'category_id', 'category_name');    
 
     print_r($list);
HTML Output (Example):
array("1" => "Arts", "3" => "Culture", "2" => "Science");

CHtml::dropDownList() method 

public static function dropDownList($name,$select,$data,$htmlOptions=array())
Generates a dropdown list.
$name: A name for the dropdownList; $select: selected item from the $data $data: an array of the type $key => $value (the possible values of you dropdownlist); $htmlOptions: another options.
Example 1: Generating a simple dropdownlist for gender
<?php echo CHtml::dropDownList('listname', $select, 
              array('M' => 'Male', 'F' => 'Female'));
The $select parameter must contain value 'M' or 'F'.
Example 2: Generating a simple dropdownlist for gender with an 'empty' element.
This example will avoid the dropdownlist to be blank when no value, outputing some proper information to the user
<?php echo CHtml::dropDownList('listname', $select, 
              array('M' => 'Male', 'F' => 'Female'),
              array('empty' => '(Select a gender)'));
Example 3: Using data from a model function.
It is better to have you gender list definition inside your model definition.
At model:
public function getGenderOptions(){
    return array('M' => 'Male', 'F' => 'Female');
}
At view:
<?php echo CHtml::dropDownList('listname', $select, 
              $model->genderOptions,
              array('empty' => '(Select a gender'));
Example 4: Using data from db
In order to create a dropdownList with data from db, you have to combine it with listData method that will format models from db into array of $key=>$value.
This part is equal to listData Example 2:
// retrieve the models from db
$models = categories::model()->findAll(
                 array('order' => 'category_name'));
 
// format models as $key=>$value with listData
$list = CHtml::listData($models, 
                'category_id', 'category_name');
Now, we generate our dropdowList from the $list variable
<?php echo CHtml::dropDownList('categories', $category, 
              $list,
              array('empty' => '(Select a category'));
Example 5: Generating dropdownlist with option groups.
If you need to generate dropdownlist using both optgroup and option tags use the following code.
<div class="cars-select">
    <?php echo CHtml::dropDownList('Cars', 'car_id', array(
        'Mazda'=>array(
            'mazda-rx7'=>'RX7',
            'mazda-rx5'=>'RX5',
        ),
        'Volvo'=>array(
            'volvo-b9tl'=>'B9TL',
            'volvo-l90e-radlader'=>'L90E Radlader',
        ),
    )); ?>
</div>
Code above should generate following HTML.
<div class="cars-select">
    <select name="Cars" id="Cars">
        <optgroup label="Mazda">
            <option value="mazda-rx7">RX7</option>
            <option value="mazda-rx5">RX5</option>
        </optgroup>
        <optgroup label="Volvo">
            <option value="volvo-b9tl">B9TL</option>
            <option value="volvo-l90e-radlader">L90E Radlader</option>
        </optgroup>
    </select>
</div>


Note:this article is heavily borrowed from www.yiiframework.com

Comments

Post a Comment

Popular posts from this blog

Ten output devices, advantages and disadvantages, inter-site back-up mechanism, Expert systems for medical diagnosis,information systems security

(i)Printer Printer enables us to produce information output on paper. It is one of the most popular computer output devices we often use to get information on paper - called hard copy. Advantage They produce high quality paper output for presentation at a speedy rate. It is also possible to share the printer among different users in a network. Disadvantage The cost for maintenance of the printer equipment as well printing ink is cumulatively high. (ii) Plotters These devices are used to produce graphical outputs on paper. They have automated pens that make line drawings on paper Advantage They can produce neat drawings on a piece of paper based on user commands. In Computer Aided Design (CAD) they are used to produce paper prototypes that aid in design of the final system. Disadvantage They are more expensive than printers. Further, the command based interface is difficult to use. (iii)Monitor It is...
8 comments
Read more

simple basic object oriented java code for employee salary calculation

import java.io.*; import java.util.Scanner; public class Employees {     Scanner scan=new Scanner(System.in);     String Fname;   int EmpID;  int DOB; double Allowance;   double Salary;     public void getDetails(){   System.out.println("Enter the first name");   Fname=scan.next();   System.out.println("Enter the ID number");   EmpID=scan.nextInt();   System.out.println("Enter the date of birth");   DOB=scan.nextInt();   System.out.println("Enter the salary");   Salary=scan.nextDouble();   Allowance=0.6*Salary;     }    public void printReport(){    System.out.println(Fname+"\t"+EmpID+"\t"+calGross()+"\t"+calPayee()+"\t"+calNetIncome());    }    public double calGross(){        return Salary + Allowance;    }    public double calPayee(){     ...
18 comments
Read more

Start Wamp server on windows automatically permanently

For those that have completely refused to use linux platforms for development, you might find this useful. As with all (aspiring) web developers, it’s always important to test your projects locally before putting it out there for the entire web community to see. One must-have developer tool for this purpose is WAMPServer. We’ve all wished it’s automatically up and running when we need it. These easy steps will help you automate WAMPServer to run on system start-up. For those unfamiliar with WAMPServer, it is a development package that lets you run web development projects locally. WAMP stands for Windows, Apache, MySQL, PHP/Perl/Python. It’s basically four programs packaged to work as one. WAMP basically turns any Windows PC into a localized web server. The Linux counterpart is called LAMP, obviously. Once WAMPServer is installed in your PC, you’ll be able to test your web projects before putting it into the live environment. But I always found it a hassle to manually s...
2 comments
Read more