View - 类別

优质

小牛编辑

116浏览

2023-12-01

View 类别做为一个包装嵌入式 PHP 的 HTML 页面的物件，称为「检视」。变数可以被指派给检视物件，并且可以在检视内本地引用。

阅读更多关于检视。

__construct($file = null, $data = null, $filter = null)

静态否

参数

参数	预设	描述
`$file`	`null`	检视档案名称，如果没提供你之后必须透过 set_filename 或在 render 中提供。检视档案应该被对应到 app/views 目录。
`$data`	`null`	值的阵列
`$filter`	`null`	设定为 true 或 false 来设定自动编码，预设是主要配置设定（app/config/config.php）

回传一个新的 View 物件

範例

$view = new View('path/to/view', array(
	'menu' => $menu,
	'articles' => $articles,
	'footer_links' => $footer_links,
));

forge($file = null, $data = null, $filter = null)

forge 方法回传一个新的 View 物件。

静态是

参数

参数	预设	描述
`$file`	`null`	检视档案名称，如果没提供你之后必须透过 set_filename 或在 render 中提供。检视档案应该被对应到 app/views 目录，并且不提供 .php 副档名。
`$data`	`null`	值的阵列
`$filter`	`null`	设定为 true 或 false 来设定自动编码，预设是主要配置设定（app/config/config.php）

回传一个新的 View 物件

範例

// 将建立一个对 APPPATH/ 的 View 物件
$view = View::forge('path/to/view', array(
	'menu' => $menu,
	'articles' => $articles,
	'footer_links' => $footer_links,
));

auto_filter($filter = true)

auto_filter 方法设定在 View 实例上是否编码资料。

静态否

参数

参数	预设	描述
`$filter`	`true`	在 View 实例上是否编码资料

回传目前 View 物件

範例

$view = View::forge('path/to/view', array(
	'menu' => $menu,
	'articles' => $articles,
	'footer_links' => $footer_links,
));

$view->auto_filter();

// 或设定它为 false

$view->auto_filter(false);

// 或鍊结

$view = View::forge('path/to/view', array(
	'menu' => $menu,
	'articles' => $articles,
	'footer_links' => $footer_links,
))->auto_filter();

set_filename($file)

set_filename 方法能让你设定或变更检视档案名称。

静态否

参数

参数	预设	描述
`$file`	必要	检视档案名称，检视档案应该被对应到 app/views 目录，并且不提供 .php 副档名。

回传目前 View 物件

範例

$view = new View();

$view->set_filename('path/to/view');

get($key = null, $default = null)

get 方法检索一个或全部设定在检视上的变数。

静态否

参数

参数	预设	描述
`$key`	`null`	变数名称
`$default`	`null`	如果变数没设定要回传的预设值

回传混合

範例

// 建立一个检视并设定一些资料
$view = new View;
$view->set(array('field1' => 'value1', 'field2' => 'value2');

// 取得单一值
$field1 = $view->get('field1');

// 取得单一值，设定一个预设值如果该栏位不存在
$field3 = $view->get('field3', 'value3');

// 取得所有值
$fields = $view->get();

set($key, $value = null, $filter = null)

set 方法指派一个变数到检视。

静态否

参数

参数	预设	描述
`$key`	必要	变数名称或变数阵列
`$value`	`null`	值
`$filter`	`null`	设为 true 或 false 来编码，预设是主要自动编码设定

回传目前 View 物件

範例

$view = new View;
$view->set('users', $users, false);

// 或设定一个阵列

$view->set(array(
	'users' => $users,
	'articles' => $articles,
), null, true);

// 当编码输出启用时，
// 如果你需要传递 HTML／Javascript，你需要设定最后参数为 false。
$view->set('example', '<h1>Heading</h1>', false);

set_safe($key, $value = null)

与 set() 相同，除了它预设不在输出时编码变数。

静态否

参数

参数	预设	描述
`$key`	必要	变数名称或变数阵列
`$value`	`null`	值

回传目前 View 物件

範例

$view = new View;
$view->set_safe('users', $users);

// 或设定一个阵列

$view->set_safe(array(
	'users' => $users,
	'articles' => $articles,
), null);

set_global($key, $value = null, $filter = null)

set_global 方法设定一个可存取的变数给所有检视。

静态是

参数

参数	预设	描述
`$key`	必要	变数名称或变数阵列
`$value`	`null`	值
`$filter`	`null`	设为 true 或 false 来编码，预设是主要自动编码设定

回传空

範例

View::set_global('users', $users, false);

// 或设定一个阵列

View::set_global(array(
	'users' => $users,
	'articles' => $articles,
), null, true);

bind($key, $value = null)

透过参照指派一个值。绑定的好处是该值可以被修改，而不须重新设定它们。也可能在变数有值之前绑定它们。在检视档案中，指派值将可被做为一个变数。

请注意：这些不能被编码输出净化，因此应该被认为是不安全的。

静态否

参数

参数	预设	描述
`$key`	必要	变数名称或变数阵列
`$value`	`null`	值

回传目前 View 物件

範例

$view = new View;
$view->bind('users', $users, false);

// 或设定一个阵列

$view->bind(array(
	'users' => $users,
	'articles' => $articles,
), null, true);

bind_global($key, $value = null)

bind_global 方法透过可存取的参照为所有检视指派一个全域的变数。

请注意：这些不能被编码输出净化，因此应该被认为是不安全的。

静态是

参数

参数	预设	描述
`$key`	必要	变数名称
`$value`	必要	值

回传空

範例

View::bind_global('users', $users);

render($file = null)

render 方法呈现检视物件为一个字串。全域和本地资料会合併并提取给检视档案，来建立本地变数。

静态否

参数

参数	类型	预设	描述
`$file`	字串	`null`	没有副档名的检视档案名称

回传 呈现的检视档案

範例

$html = View::forge()->render('path/to/view');

// 或

$html = View::forge('path/to/view')->render();

// 或

$html = View::forge()->set_filename('path/to/view')->render();

程序助手

render($view, $data = array(), $auto_filter = null)

render 函式是 View::render 的别名。

参数

参数	类型	预设	描述
`$view`	字串	必要	没有副档名的检视档案名称
`$data`	阵列	`array()`	要被传递给检视的资料阵列
`$auto_filter`	布林	`null`	是否过滤资料

回传 字串，来自 View::render 的结果

範例

$html = render('path/to/view', $data_array);