Yii2主题(Theme)用法详解

本文实例讲述了Yii2主题(Theme)用法。分享给大家供大家参考，具体如下：

首先看看主要的配置方式：

'components' => [

'view' => [

'theme' => [

'pathMap' => ['@app/views' => '@app/themes/basic'],

'baseUrl' => '@web/themes/basic',

],

],

],

Yii中的主题功能主要由yii\base\Theme类来实现，它的主要思想是：先定义好一个一一对应的字符串映射数组，然后对给定的字符串按照数组中的映射关系进行字符串替换。

有如下映射：

$pathMap=[

'@app/a' => '@app/aaa',

'@app/b' => '@app/bbb',

'@app/c' => [

'@app/ccc/xxx',

'@app/ccc/yyy',

],

];

对字符串 @app/a/site/index.php，由上面的映射关系可知会把@app/a替换为@app/aaa，生成结果为@app/aaa/site/index.php。

但要注意，这个还不是最终的结果。由于在Yii中是对文件路径的操作，所以如果@app/aaa/site/index.php这个文件存在的话，则会返回这个路径，否则返回原路径即：@app/a/site/index.php

如果有字符串@app/c/site/index.php，由于上面的映射知道@app/c对应2个替换项，Yii会从前开始依次替换，先生成@app/ccc/xxx/site/index.php，如果这个文件存在，则返回这个路径，否则继续替换。

如果所有的替换结果都不存在对应的文件，那么最后返回原路径。

同时写多个替换的目标值有这么一个好处：实现主题的继承。

现在有一套默认的主题default，如果现在要增加一套黑色的主题，有两个办法可以实现。

第一种：把所有的default中的视图全部复制一份到blank目录中。

第二种：只复制一份layout布局文件到blank目录中，然后在布局文件中修改整体颜色。然后设置为

$pathMap=[

'@app/c' => [

'@app/ccc/blank',

'@app/ccc/default',

],

];

好处看到了吧，如果在blank中没有找到文件，会从default中来查找，也就是说blank中的文件会覆盖default中存在的文件，从而实现了主题的继承。

主题中的属性：

$pathMap：这个就是用来设置替换映射关系的。

'pathMap' =>[

'@app/views' => [

'@app/themes/blank',

'@app/themes/default',

],

'@app/modules' => '@app/themes/default/modules',

'@app/widgets' => '@app/themes/default/widgets'

],

这三个分别对views、modules和widgets应用主题。

$baseUrl：这个用来设置要访问的资源的url(结尾不加“/”)

$basePath：设置资源所在的文件目录

主题中的方法：

public function init()

public function init()

{

parent::init();

//如果没有设置$pathMap映射，则使用$basePath，

if (empty($this->pathMap)) {

/*

* 如果$basePath也没有设置，则出异常。

* 也就是说 $pathMap和$basePath至少要设置一个，如果两个都设置了，优先使用$pathMap

*/

if (($basePath = $this->getBasePath()) === null) {

throw new InvalidConfigException('The "basePath" property must be set.');

}

//设置当前模块的路径和$basePath的映射关系

$this->pathMap = [Yii::$app->getBasePath() => [$basePath]];

}

}

public function applyTo($path)

//这个就是按照 $pathMap中的定义的映射关系来对$path进行替换字符串的

public function applyTo($path)

{

//对路径中的"/"、“\”进行统一替换

$path = FileHelper::normalizePath($path);

foreach ($this->pathMap as $from => $tos) {

//映射数组中的来源(旧值)

$from = FileHelper::normalizePath(Yii::getAlias($from)) . DIRECTORY_SEPARATOR;

//如果在$path中有可替换的旧值

if (strpos($path, $from) === 0) {

$n = strlen($from);

//对目标值循环，

foreach ((array) $tos as $to) {

$to = FileHelper::normalizePath(Yii::getAlias($to)) . DIRECTORY_SEPARATOR;

//把$path中的$from替换为$to

$file = $to . substr($path, $n);

//如果是文件，直接返回

if (is_file($file)) {

return $file;

}

}

}

}

return $path;

}

更多关于Yii相关内容感兴趣的读者可查看本站专题：《Yii框架入门及常用技巧总结》、《php优秀开发框架总结》、《smarty模板入门基础教程》、《php面向对象程序设计入门教程》、《php字符串(string)用法总结》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》

希望本文所述对大家基于Yii框架的PHP程序设计有所帮助。相关阅读:

升级Win10系统后音响设备出现杂音如何解决

jQuery Mobile操作HTML5的常用函数总结

Windows7系统开启Telnet服务方法图文教程

DevExpress之ChartControl用法实例总结

Javascript与jQuery方法的隐藏与显示

Java的云打印Lodop

MAC安装魔兽争霸3后自己的电脑无法连入局域网的解决方法

js的toLowerCase方法用法实例

angularjs学习笔记之简单介绍

详解java中&和&&的区别

android中TabHost的图标(48×48)和文字叠加解决方法

JS如何设置cookie有效期为当天24点并弹出欢迎登陆界面

jQuery实现的漂亮表单效果代码

有关opacity或RGBA设置颜色值及元素的透明值