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程序设计有所帮助。
相关文章
- 这篇文章主要介绍了Yii2创建表单(ActiveForm)的方法,结合实例形式详细分析了Yii创建表单的详细步骤及相关函数与属性的使用技巧,需要的朋友可以参考下...2016-07-29
- 这篇文章主要介绍了PHP之深入学习Yii2缓存Cache组件详细讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下...2021-07-27
- 带搜索功能下拉框在项目中经常会用到,下面小编把实现代码分享到脚本之家平台,供大家参考...2016-05-13
- yii2的一个强大之处之一就是他的Form组件,既方便又安全。本文给大家介绍yii2中的rules 自定义验证规则,需要的朋友参考下...2016-04-23
Yii2使用$this->context获取当前的Module、Controller(控制器)、Action等
使用Yii2的时候,在某些场景和环境下需要获得Yii2目前所处于的module(模型)、Controller(控制器)、Action(方法),以及会调用控制器里面已经定义过的一些公共的方法等.对于这些问题Yii2可以在视图层View中使用$this->context这个对象去获得。下面通过示例代码给大家讲解下...2017-04-03- 这篇文章主要介绍了YII2实现多语言配置的方法,文中YII2的版本是2.0.7,可能会与其他教程有不同,有需要的朋友可以参考借鉴,下面来一起看看吧。...2017-01-15
- 这篇文章主要介绍了Yii2实现让关联字段支持搜索功能的方法,结合实例形式分析了Yii2关联字段搜索功能的原理与相关实现技巧,需要的朋友可以参考下...2016-08-27
- 本篇文章主要介绍了Yii2框架实现数据库常用操作总结,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧 ...2017-02-18
- 这篇文章主要介绍了Yii2基于Ajax自动获取表单数据的方法,涉及Yii结合ajax调用鼠标事件动态查询表单的相关技巧,需要的朋友可以参考下...2016-08-27
- 这篇文章主要介绍了yii2分页之实现跳转到具体某页的实例代码的相关资料,需要的朋友可以参考下...2016-06-12
- yii2集成另外一个强大好用的富文本编辑器Redactor。接下来通过本文给大家介绍Yii2集成富文本编辑器redactor实例教程,感兴趣的朋友一起学习吧...2016-04-28
- 这篇文章主要介绍了在WordPress中获取数据库字段内容和添加主题设置菜单的方法,分别讲解了get_option()函数和add_theme_page()函数的用法,需要的朋友可以参考下...2016-01-14
- 这篇文章主要介绍了Yii2使用swiftmailer发送邮件的方法,结合实例形式分析了Yii2使用swiftmailer进行邮件发送的设置与代码实现技巧,需要的朋友可以参考下...2016-05-05
- 这篇文章主要介绍了Yii2搭建后台并实现rbac权限控制完整实例教程的相关资料,需要的朋友可以参考下...2016-05-04
- 在朋友圈里有童鞋向我讨论GridView的问题,有朋友说你用gridview给我去掉表头的链接?我想的很久,用gridview确实不容易实现。有不同见解的朋友欢迎留言。但是呢,这根gridview有个毛线关联啊,明明是要设置ActiveDataProvider,你要我怎么用gridview实现嘛...2016-04-23
- 本文是小编给大家收集整理些有关网络上Yii2中GridView常见操作中出现的大部分问题,本文做一个总结特此分享到脚本之家平台供大家参考...2016-04-23
- 一个有缓存的框架可以说是一个好的框架。下面小编通过本文给大家介绍yii2中是如何使用缓存的,非常具有参考借鉴价值,感兴趣的朋友一起学习吧...2016-05-13
- 这篇文章主要介绍了浅析Yii2 GridView实现下拉搜索教程的相关资料,需要的朋友可以参考下...2016-04-23
- 这篇文章主要介绍了Yii2使用自带的UploadedFile实现的文件上传的相关资料,非常不错,具有参考借鉴价值,需要的朋友可以参考下...2016-06-24
浅析Yii2 GridView 日期格式化并实现日期可搜索教程
这篇文章主要介绍了Yii2 GridView 日期格式化并实现日期可搜索教程的相关资料,需要的朋友可以参考下...2016-04-23