Theming是一个在Web应用程序里定制网页外观的系统方式。通过采用一个新的主题,可以非常方便的改变应用的外观。
在Yii,每个主题由一个目录代表,包含view文件,layout文件和相关的资源文件,如图片, CSS文件, JavaScript文 件等。主题的名字就是他的目录名字。全部主题都放在在同一目录WebRoot/themes下 。在任何时候,只有一个主题可以被激活 。
提示:默认的主题根目录WebRoot/themes可被配置成其他的。只需要配置themeManager应用部件的属性basePath和baseUrl为 你所要的值。
要激活一个主题,设置Web应用程序的属性theme为你所要的名字。可以在application configuration中配置或者在执行过程 中在控制器的动作里面修改。
注:主题名称是区分大小写的。如果您尝试启动一个不存在的主题, yii: :app()->theme将返回null 。
主题目录里面内容的组织方式和application base path目录下的组织方式一样。例如,所有的view文件必须位于views下 , 布局view文件在views/layouts下 ,和系统view文件在views/system下。例如,如果我们要替换PostController的create view 文件为classic主题下,我们将保存新的view文件为WebRoot/themes/classic/views/post/create.php。
对于在module里 面的控制器view文件,相应主题view文件将被放在views目录下。例如,如果上述的PostController是在一个命名为forum的模块 里 ,我们应该保存create view 文件为WebRoot/themes/classic/views/forum/post/create.php 。如果 forum模块嵌套在另一 个名为support模块里 ,那么view文件应为WebRoot/themes/classic/views/support/forum/post/create.php 。
本例通 过修改Yii Framework 开发教程(11) UI 组件 ActiveForm示例 ,为它添加两个主提,为简单起见,两个主题名字分别为 cyan,grey, 以其背景颜色命名。
首先在应用目录结构下创建themes 目录,然后创建cyan,grey 两个子目录,然后将缺 省的protected/views分别复制到两个子目录下,作为Theme的初始版本。
并使用Yii缺省的Css定义,也分别拷贝到两个 主题子目录下,作为CSS的初始文件。
下面分别对两个主题下的CSS文件稍微做些修改,以示区别,修改css/main.css 修 改body的背景色
body
{
margin: 0;
padding: 0;
color: #555;
font: normal 10pt Arial,Helvetica,sans-serif;
background: #00FFFF;
}
分别该为Cyan和Grey的颜色。
然后修改layout/main.php 引用主题下的CSS文件,在一个主题的视图,我们经 常需要链接其他主题资源文件。例如,我们可能要显示一个在主题下images目录里的图像文件。使用当前激活主题的baseurl属 性,我们就可以为此图像文件生成如下url
yii: :app()->theme->baseUrl .
'/images/FileName.gif'修改后的布局文件如下:
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
href="theme->baseUrl; ?>/css/main.css" />
href="theme->baseUrl; ?>/css/form.css" />
>
Theme Name:theme->name;?>
定义好主题后,就可以通过配置Application的theme属性来设置当前主题:
return array(
'theme'=>'cyan',
......
);
两个主题显示如下:
如果指定的主题不存在,相当于没有主题,将使用缺省的显示方式: