Welcome to the Cookbook

charset(string $charset=null)

Used to create a meta tag specifying the document's character. Defaults to UTF-8.

 
<?php echo $this->Html->charset(); ?> 

1. <?php echo $this->Html->charset(); ?>

Will output:

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

Alternatively,

<?php echo $this->Html->charset('ISO-8859-1'); ?>

1. <?php echo $this->Html->charset('ISO-8859-1'); ?>

Will output:

<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />

css(mixed $path, string $rel = null, array $options = array())

Creates a link(s) to a CSS style-sheet. If key 'inline' is set to false in $options parameter, the link tags are added to the $scripts_for_layout variable which you can print inside the head tag of the document.

This method of CSS inclusion assumes that the CSS file specified resides inside the /app/webroot/css directory.

<?php echo $this->Html->css('forms'); ?> 

1. <?php echo $this->Html->css('forms'); ?>

Will output:

<link rel="stylesheet" type="text/css" href="/css/forms.css" />

The first parameter can be an array to include multiple files.

<?php echo $this->Html->css(array('forms','tables','menu')); ?>

1. <?php echo $this->Html->css(array('forms','tables','menu')); ?>

Will output:

<link rel="stylesheet" type="text/css" href="/css/forms.css" />
<link rel="stylesheet" type="text/css" href="/css/tables.css" />
<link rel="stylesheet" type="text/css" href="/css/menu.css" />

This method included the CSS in the header.

<?php 	$this->Html->css(array('forms','myplugin/css/forms'),'stylesheet', array('inline' => false ) ); ?> 

1. <?php $this->Html->css(array('forms','myplugin/css/forms'),'stylesheet', array('inline' => false ) ); ?>

Will output in header:

<link rel="stylesheet" type="text/css" href="/css/forms.css" />
<link rel="stylesheet" type="text/css" href="/myplugin/css/forms.css" />

meta(string $type, string $url = null, array $attributes = array())

This method is handy for linking to external resources like RSS/Atom feeds and favicons. Like css(), you can specify whether or not you'd like this tag to appear inline or in the head tag by setting the 'inline' key in the $attributes parameter to false, ie - array('inline' => false).

If you set the "type" attribute using the $attributes parameter, CakePHP contains a few shortcuts:

type	translated value
html	text/html
rss	application/rss+xml
atom	application/atom+xml
icon	image/x-icon

  <?php echo $this->Html->meta(
    'favicon.ico',
    '/favicon.ico',
    array('type' => 'icon')
);?> //Output (line breaks added) </p>
<link
    href="http://example.com/favicon.ico"
    title="favicon.ico" type="image/x-icon"
    rel="alternate"
/>
 
<?php echo $this->Html->meta(
    'Comments',
    '/comments/index.rss',
    array('type' => 'rss'));
?>
 
//Output (line breaks added)
<link
    href="http://example.com/comments/index.rss"
    title="Comments"
    type="application/rss+xml"
    rel="alternate"
/>

1. <?php echo $this->Html->meta(
2. 'favicon.ico',
3. '/favicon.ico',
4. array('type' => 'icon')
5. );?> //Output (line breaks added) </p>
6. <link
7. href="http://example.com/favicon.ico"
8. title="favicon.ico" type="image/x-icon"
9. rel="alternate"
10. />
12. <?php echo $this->Html->meta(
13. 'Comments',
14. '/comments/index.rss',
15. array('type' => 'rss'));
16. ?>
18. //Output (line breaks added)
19. <link
20. href="http://example.com/comments/index.rss"
21. title="Comments"
22. type="application/rss+xml"
23. rel="alternate"
24. />

This method can also be used to add the meta keywords and descriptions. Example:

<?php echo $this->Html->meta(
    'keywords',
    'enter any meta keyword here'
);?>
//Output <meta name="keywords" content="enter any meta keyword here"/>
//

<?php echo $this->Html->meta(
    'description',
    'enter any meta description here'
   );?> 

//Output <meta name="description" content="enter any meta description here"/>

1. <?php echo $this->Html->meta(
2. 'keywords',
3. 'enter any meta keyword here'
4. );?>
5. //Output <meta name="keywords" content="enter any meta keyword here"/>
6. //
7. <?php echo $this->Html->meta(
8. 'description',
9. 'enter any meta description here'
10. );?>
11. //Output <meta name="description" content="enter any meta description here"/>

If you want to add a custom meta tag then the first parameter should be set to an array. To output a robots noindex tag use the following code:

 echo $this->Html->meta(array('name' => 'robots', 'content' => 'noindex')); 

1. echo $this->Html->meta(array('name' => 'robots', 'content' => 'noindex'));

docType(string $type = 'xhtml-strict')

Returns a (X)HTML doctype tag. Supply the doctype according to the following table:

type	translated value
html	text/html
html4-strict	HTML4 Strict
html4-trans	HTML4 Transitional
html4-frame	HTML4 Frameset
xhtml-strict	XHTML1 Strict
xhtml-trans	XHTML1 Transitional
xhtml-frame	XHTML1 Frameset
xhtml11	XHTML 1.1

<?php echo $this->Html->docType(); ?> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<?php echo $this->Html->docType('html4-trans'); ?> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

1. <?php echo $this->Html->docType(); ?>
2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3. <?php echo $this->Html->docType('html4-trans'); ?>
4. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

style(array $data, boolean $oneline = true)

Builds CSS style definitions based on the keys and values of the array passed to the method. Especially handy if your CSS file is dynamic.

<?php echo $this->Html->style(array(
    'background'     => '#633',
    'border-bottom' => '1px solid #000',
    'padding' => '10px'
)); ?>

1. <?php echo $this->Html->style(array(
2. 'background' => '#633',
3. 'border-bottom' => '1px solid #000',
4. 'padding' => '10px'
5. )); ?>

Will output:

  background:#633; border-bottom:1px solid #000; padding:10px;

image(string $path, array $htmlAttributes = array())

Creates a formatted image tag. The path supplied should be relative to /app/webroot/img/.

<?php echo $this->Html->image('cake_logo.png', array('alt' => 'CakePHP'))?> 

1. <?php echo $this->Html->image('cake_logo.png', array('alt' => 'CakePHP'))?>

Will output:

<img src="/img/cake_logo.png" alt="CakePHP" /> 

To create an image link specify the link destination using the url option in $htmlAttributes.

<?php echo $this->Html->image("recipes/6.jpg", array(
    "alt" => "Brownies",
    'url' => array('controller' => 'recipes', 'action' => 'view', 6)
)); ?>

1. <?php echo $this->Html->image("recipes/6.jpg", array(
2. "alt" => "Brownies",
3. 'url' => array('controller' => 'recipes', 'action' => 'view', 6)
4. )); ?>

Will output:

<a href="/recipes/view/6">
    <img src="/img/recipes/6.jpg" alt="Brownies" />
</a>

link(string $title, mixed $url = null, array $options = array(), string $confirmMessage = false)

General purpose method for creating HTML links. Use $options to specify attributes for the element and whether or not the $title should be escaped.

<?php echo $this->Html->link('Enter', '/pages/home', array('class' => 'button', 'target' => '_blank')); ?>

1. <?php echo $this->Html->link('Enter', '/pages/home', array('class' => 'button', 'target' => '_blank')); ?>

Will output:

  
<a href="/pages/home" class="button" target="_blank">Enter</a>

Specify $confirmMessage to display a javascript confirm() dialog.

<?php echo $this->Html->link(
    'Delete',
    array('controller' => 'recipes', 'action' => 'delete', 6),
    array(),
    "Are you sure you wish to delete this recipe?"
);?>

1. <?php echo $this->Html->link(
2. 'Delete',
3. array('controller' => 'recipes', 'action' => 'delete', 6),
4. array(),
5. "Are you sure you wish to delete this recipe?"
6. );?>

Will output:

  
<a href="/recipes/delete/6" onclick="return confirm('Are you sure you wish to delete this recipe?');">Delete</a>

Query strings can also be created with link().

<?php echo $this->Html->link('View image', array(
    'controller' => 'images',
    'action' => 'view',
    1,
    '?' => array('height' => 400, 'width' => 500))
);

1. <?php echo $this->Html->link('View image', array(
2. 'controller' => 'images',
3. 'action' => 'view',
4. 1,
5. '?' => array('height' => 400, 'width' => 500))
6. );

Will output:

  
<a href="/images/view/1?height=400&width=500">View image</a>

HTML special characters in $title will be converted to HTML entities. To disable this conversion, set the escape option to false in the $options array.

<?php 
echo $this->Html->link(
    $this->Html->image("recipes/6.jpg", array("alt" => "Brownies")),
    "recipes/view/6",
    array('escape' => false)
);

?>

1. <?php
2. echo $this->Html->link(
3. $this->Html->image("recipes/6.jpg", array("alt" => "Brownies")),
4. "recipes/view/6",
5. array('escape' => false)
6. );
7. ?>

Will output:

<a href="/recipes/view/6">
    <img src="/img/recipes/6.jpg" alt="Brownies" />
</a>

Also check HtmlHelper::url method for more examples of different types of urls.

tag(string $tag, string $text, array $htmlAttributes)

Returns text wrapped in a specified tag. If no text is specified then only the opening <tag> is returned.

<?php echo $this->Html->tag('span', 'Hello World.', array('class' => 'welcome'));?>
 
//Output
<span class="welcome">Hello World</span>
 
//No text specified.
<?php echo $this->Html->tag('span', null, array('class' => 'welcome'));?>
 
//Output
<span class="welcome">

1. <?php echo $this->Html->tag('span', 'Hello World.', array('class' => 'welcome'));?>
3. //Output
4. <span class="welcome">Hello World</span>
6. //No text specified.
7. <?php echo $this->Html->tag('span', null, array('class' => 'welcome'));?>
9. //Output
10. <span class="welcome">

Text is not escaped by default but you may use $htmlOptions['escape'] = true to escape your text. This replaces a fourth parameter boolean $escape = false that was available in previous versions.

div(string $class, string $text, array $options)

Used for creating div-wrapped sections of markup. The first parameter specifies a CSS class, and the second is used to supply the text to be wrapped by div tags. If the last parameter has been set to true, $text will be printed HTML-escaped.

 
<?php echo $this->Html->div('error', 'Please enter your credit card number.');?>

//Output
<div class="error">Please enter your credit card number.</div>

1. <?php echo $this->Html->div('error', 'Please enter your credit card number.');?>
2.  
3. //Output
4. <div class="error">Please enter your credit card number.</div>

If $text is set to null, only an opening div tag is returned.

<?php echo $this->Html->div('', null, array('id' => 'register'));?>

//Output
<div id="register" class="register">

1. <?php echo $this->Html->div('', null, array('id' => 'register'));?>
2.  
3. //Output
4. <div id="register" class="register">

para(string $class, string $text, array $htmlAttributes, boolean $escape = false)

Returns a text wrapped in a CSS-classed <p> tag. If no text is supplied, only a starting <p> tag is returned.

<?php echo $this->Html->para(null, 'Hello World.');?>
 
//Output
<p>Hello World.</p>

1. <?php echo $this->Html->para(null, 'Hello World.');?>
3. //Output
4. <p>Hello World.</p>

script(mixed $url, mixed $options)

Creates link(s) to a javascript file. If key inline is set to false in $options, the link tags are added to the $scripts_for_layout variable which you can print inside the head tag of the document.

Include a script file into the page. $options['inline'] controls whether or not a script should be returned inline or added to $scripts_for_layout. $options['once'] controls, whether or not you want to include this script once per request or more than once.

You can also use $options to set additional properties to the generated script tag. If an array of script tags is used, the attributes will be applied to all of the generated script tags.

This method of javascript file inclusion assumes that the javascript file specified resides inside the /app/webroot/js directory.

<?php echo $this->Html->script('scripts'); ?> 

1. <?php echo $this->Html->script('scripts'); ?>

Will output:

<script type="text/javascript" href="/js/scripts.js"></script>

You can link to files with absolute paths as well to link files that are not in app/webroot/js

<?php echo $this->Html->script('/otherdir/script_file'); ?> 

1. <?php echo $this->Html->script('/otherdir/script_file'); ?>

The first parameter can be an array to include multiple files.

<?php echo $this->Html->script(array('jquery','wysiwyg','scripts')); ?>

1. <?php echo $this->Html->script(array('jquery','wysiwyg','scripts')); ?>

Will output:

<script type="text/javascript" href="/js/jquery.js"></script>
<script type="text/javascript" href="/js/wysiwyg.js"></script>
<script type="text/javascript" href="/js/scripts.js"></script>

scriptBlock($code, $options = array())

Generate a code block containing $code set $options['inline'] to false to have the script block appear in $scripts_for_layout. Also new is the ability to add attributes to script tags. $this->Html->scriptBlock('stuff', array('defer' => true)); will create a script tag with defer="defer" attribute.

scriptStart($options = array())

Begin a buffering code block. This code block will capture all output between scriptStart() and scriptEnd() and create an script tag. Options are the same as scriptBlock()

scriptEnd()

End a buffering script block, returns the generated script element or null if the script block was opened with inline = false.

An example of using scriptStart() and scriptEnd() would be:

$this->Html->scriptStart(array('inline' => false));

echo $this->Js->alert('I am in the javascript');

$this->Html->scriptEnd();

1. $this->Html->scriptStart(array('inline' => false));
2. echo $this->Js->alert('I am in the javascript');
3. $this->Html->scriptEnd();

tableHeaders(array $names, array $trOptions = null, array $thOptions = null)

Creates a row of table header cells to be placed inside of <table> tags.

<?php echo $this->Html->tableHeaders(array('Date','Title','Active'));?>

//Output 
<tr>
    <th>Date</th>
    <th>Title</th>
    <th>Active</th>
</tr>
 
<?php echo $this->Html->tableHeaders(
    array('Date','Title','Active'),
    array('class' => 'status'),
    array('class' => 'product_table')
);?>
 
//Output
<tr class="status">
     <th class="product_table">Date</th>
     <th class="product_table">Title</th>
     <th class="product_table">Active</th>
</tr>

1. <?php echo $this->Html->tableHeaders(array('Date','Title','Active'));?>
2.  
3. //Output
4. <tr>
5. <th>Date</th>
6. <th>Title</th>
7. <th>Active</th>
8. </tr>
10. <?php echo $this->Html->tableHeaders(
11. array('Date','Title','Active'),
12. array('class' => 'status'),
13. array('class' => 'product_table')
14. );?>
16. //Output
17. <tr class="status">
18. <th class="product_table">Date</th>
19. <th class="product_table">Title</th>
20. <th class="product_table">Active</th>
21. </tr>

tableCells(array $data, array $oddTrOptions = null, array $evenTrOptions = null, $useCount = false, $continueOddEven = true)

Creates table cells, in rows, assigning <tr> attributes differently for odd- and even-numbered rows. Wrap a single table cell within an array() for specific <td>-attributes.

<?php echo $this->Html->tableCells(array(
    array('Jul 7th, 2007', 'Best Brownies', 'Yes'),
    array('Jun 21st, 2007', 'Smart Cookies', 'Yes'),
    array('Aug 1st, 2006', 'Anti-Java Cake', 'No'),
));
?>
 
//Output
<tr><td>Jul 7th, 2007</td><td>Best Brownies</td><td>Yes</td></tr>
<tr><td>Jun 21st, 2007</td><td>Smart Cookies</td><td>Yes</td></tr>
<tr><td>Aug 1st, 2006</td><td>Anti-Java Cake</td><td>No</td></tr>
 
<?php echo $this->Html->tableCells(array(
    array('Jul 7th, 2007', array('Best Brownies', array('class'=>'highlight')) , 'Yes'),
    array('Jun 21st, 2007', 'Smart Cookies', 'Yes'),
    array('Aug 1st, 2006', 'Anti-Java Cake', array('No', array('id'=>'special'))),
));
?>
 
//Output
<tr><td>Jul 7th, 2007</td><td class="highlight">Best Brownies</td><td>Yes</td></tr>
<tr><td>Jun 21st, 2007</td><td>Smart Cookies</td><td>Yes</td></tr>
<tr><td>Aug 1st, 2006</td><td>Anti-Java Cake</td><td id="special">No</td></tr>
 
<?php echo $this->Html->tableCells(
    array(
        array('Red', 'Apple'),
        array('Orange', 'Orange'),
        array('Yellow', 'Banana'),
    ),
    array('class' => 'darker')
);
?>
 
//Output
<tr class="darker"><td>Red</td><td>Apple</td></tr>
<tr><td>Orange</td><td>Orange</td></tr>
<tr class="darker"><td>Yellow</td><td>Banana</td></tr>

1. <?php echo $this->Html->tableCells(array(
2. array('Jul 7th, 2007', 'Best Brownies', 'Yes'),
3. array('Jun 21st, 2007', 'Smart Cookies', 'Yes'),
4. array('Aug 1st, 2006', 'Anti-Java Cake', 'No'),
5. ));
6. ?>
8. //Output
9. <tr><td>Jul 7th, 2007</td><td>Best Brownies</td><td>Yes</td></tr>
10. <tr><td>Jun 21st, 2007</td><td>Smart Cookies</td><td>Yes</td></tr>
11. <tr><td>Aug 1st, 2006</td><td>Anti-Java Cake</td><td>No</td></tr>
13. <?php echo $this->Html->tableCells(array(
14. array('Jul 7th, 2007', array('Best Brownies', array('class'=>'highlight')) , 'Yes'),
15. array('Jun 21st, 2007', 'Smart Cookies', 'Yes'),
16. array('Aug 1st, 2006', 'Anti-Java Cake', array('No', array('id'=>'special'))),
17. ));
18. ?>
20. //Output
21. <tr><td>Jul 7th, 2007</td><td class="highlight">Best Brownies</td><td>Yes</td></tr>
22. <tr><td>Jun 21st, 2007</td><td>Smart Cookies</td><td>Yes</td></tr>
23. <tr><td>Aug 1st, 2006</td><td>Anti-Java Cake</td><td id="special">No</td></tr>
25. <?php echo $this->Html->tableCells(
26. array(
27. array('Red', 'Apple'),
28. array('Orange', 'Orange'),
29. array('Yellow', 'Banana'),
30. ),
31. array('class' => 'darker')
32. );
33. ?>
35. //Output
36. <tr class="darker"><td>Red</td><td>Apple</td></tr>
37. <tr><td>Orange</td><td>Orange</td></tr>
38. <tr class="darker"><td>Yellow</td><td>Banana</td></tr>

View more details about the tableCells function in the API

url(mixed $url = NULL, boolean $full = false)

Returns an URL pointing to a combination of controller and action. If $url is empty, it returns the REQUEST_URI, otherwise it generates the url for the controller and action combo. If full is true, the full base URL will be prepended to the result.

<?php echo $this->Html->url(array(
    "controller" => "posts",
    "action" => "view",
    "bar"));?>
 
// Output
/posts/view/bar

1. <?php echo $this->Html->url(array(
2. "controller" => "posts",
3. "action" => "view",
4. "bar"));?>
6. // Output
7. /posts/view/bar

Here are a few more usage examples:

URL with named parameters

<?php echo $this->Html->url(array(
    "controller" => "posts",
    "action" => "view",
    "foo" => "bar"));
?>
 
// Output
/posts/view/foo:bar

1. <?php echo $this->Html->url(array(
2. "controller" => "posts",
3. "action" => "view",
4. "foo" => "bar"));
5. ?>
7. // Output
8. /posts/view/foo:bar

URL with extension

<?php echo $this->Html->url(array(
    "controller" => "posts",
    "action" => "list",
    "ext" => "rss"));
?>
 
// Output
/posts/list.rss

1. <?php echo $this->Html->url(array(
2. "controller" => "posts",
3. "action" => "list",
4. "ext" => "rss"));
5. ?>
7. // Output
8. /posts/list.rss

URL (starting with '/') with the full base URL prepended.

<?php echo $this->Html->url('/posts', true); ?>

//Output
http://somedomain.com/posts

1. <?php echo $this->Html->url('/posts', true); ?>
2.  
3. //Output
4. http://somedomain.com/posts

URL with GET params and named anchor

<?php echo $this->Html->url(array(
    "controller" => "posts",
    "action" => "search",
    "?" => array("foo" => "bar"),
    "#" => "first"));
?>

//Output
/posts/search?foo=bar#first

1. <?php echo $this->Html->url(array(
2. "controller" => "posts",
3. "action" => "search",
4. "?" => array("foo" => "bar"),
5. "#" => "first"));
6. ?>
7.  
8. //Output
9. /posts/search?foo=bar#first

For further information check Router::url in the API.