^Status|Draft|
^Todo|Fill in empty topics, these should be proper code examples and not repeat general/views|

====== View Class ======

For a more in depth overview of views see [[:general:views|General/Views]].

===== Creating an instance =====
Creating an instance of the view class.

<code php>
$view = new View('welcome');
</code>

===== Setting data =====

There are several ways to pass data into your views.

Using the View as an object:

<code php>
// Load the view as an object
$view = new View('yourview');
 
// Adding variables to the object that will be displayed in the view
$view->title   = "Welcome to Kohana !";
$view->heading = "My Heading";
$view->content = "My content here.";

//------- or --------

$view->set('title', "Welcome to Kohana !");
$view->set('heading', "My Heading");
$view->set('content', "My content here.");
</code>


You can also supply an array and the keys and values will be treated as variables:

<code php>
// Load the view as an object
$view = new View('yourview', array('title' => "Welcome to Kohana !"));
</code>


===== Methods =====

==== set() ====

''set()'' can be used to set a variable in a view. You can also supply an array and the keys and values will be treated as variables. $this->view->your_variable can be used to accomplish the same.

<code php>
$view = new View('welcome');

$view->set('title', 'Elvis lives');
</code>


==== bind() ====

''bind()'' is like set only the variable is assigned by reference. 

<code php>
$view = new View('welcome');

$var='Some value';

$view->bind('title', $var);

$var='Another value';

$view->render(true); //The 'title' variable will contain 'Another value'
</code>

==== set_global() ====

''set_global()'' is like set only that the variables set are available throughout all views. This means you can use it with views in views for example. 
<code php>
// loading views
$view = new View('page');
$view->header = new View('header');

// setting variables in all views
$view->set_global('title', 'Title of page'); // set variable $title for example in view header.php

$view->render(TRUE);
</code>

==== is_set() ====

''is_set()'' can be used to check if a variable is already set. You can also supply an array with the keys to check.

<code php>
$view = new View('welcome');

if($view->is_set('title'))
{
    $view->set('title', 'OHAI!');
}
</code>


==== render() =====

''render()'' renders the output of the View.

<code php>
// render and store, default, no browser output
$this->template->content = $this->session->get_once('message').$content->render(); 

// render output of view to browser
$this->template->render(TRUE); 
</code>

==== factory() ====

This method is static. Parameters are the same as creating a new instance.

It creates a View instance and immediately returns it so method chaining is possible. 
<code php>
public function _add_breadcrumb()
{
    $crumbs = View::factory('admin/breadcrumb')
        ->set('crumbs', html::breadcrumb())
        ->render();

    $this->template->content = $crumbs.$this->template->content;
}
</code>

==== set_filename() ====
''set_filename()'' sets the name of the file used for the view. 
<code php>
$view=new View;

if(request::is_ajax()) //request helper also exists in 2.2
{
   $view->set_filename('ajax_view');
}
else
{
   $view->set_filename('html_view');
}

$view->render(TRUE);
</code>

<html><p style="text-align:center"></html><< [[core:utf8|Unicode]]<html> : Previous</p></html>