修改内置页面、新增自定义主题、修改登录页面

每个项目的需求都不同，风格要求也不同，例如我想修改下登录页、框架页面、错误页面等待，那在JeeSite4.0中如何覆盖默认视图视图呢？

1、先了解下SpringMVC的视图配置：

  1. // Beetl主题视图解析器（order越小优先级越高）
  2. BeetlViewResolver beetlThemes = new BeetlViewResolver();
  3. beetlThemes.setPrefix("/themes/" + Global.getProperty("web.view.themeName") + "/");
  4. beetlThemes.setSuffix(".html");
  5. beetlThemes.setOrder(10000);
  6. registry.viewResolver(beetlThemes);
  7. // Beetl默认视图解析器（order越小优先级越高）
  8. BeetlViewResolver beetlDefault = new BeetlViewResolver();
  9. beetlDefault.setPrefix("/");
  10. beetlDefault.setSuffix(".html");
  11. beetlDefault.setOrder(20000);
  12. registry.viewResolver(beetlDefault);
  13. // 默认视图定义，根据后缀渲染（.json、.xml）
  14. JsonView jsonView = new JsonView();
  15. jsonView.setPrettyPrint(false);
  16. XmlView xmlView = new XmlView();
  17. xmlView.setPrettyPrint(false);
  18. registry.enableContentNegotiation(jsonView, xmlView);

2、我们再看下application.yml（v4.0.x：jeesite.yml）里视图相关配置themeName默认为default。

  1. # Web 相关
  2. web:
  4.   # MVC 视图相关
  5.   view:
  7.     # 系统主题名称，主题视图优先级最高，如果主题下无这个视图文件则访问默认视图
  8.     # 引入页面头部：'/themes/'+themeName+'/include/header.html'
  9.     # 引入页面尾部：'/themes/'+themeName+'/include/footer.html'
  10.     themeName: default

3、有经验的小伙伴也许一看就明白，MVC的视图加载机制，原来是依照谁先加载谁受用原则进行的，也就是说优先级越高的视图被找到就用谁，后面的视图将会被忽略。顺序如下：/src/main/resources/views/themes/default/**/.html –> /src/main/resources/views/**/.html –> JSON/XML，先去找主题目录下的视图文件，找不到使用JeeSite默认，如果还找不到，则返回JSON或XML数据。

4、下面我们来举个例子（修改登录页面）

  • 复制 /jeesite-module-core/src/main/resources/views/modules/sys/sysLogin.html 文件到 /web/src/main/resources/views/themes/default/modules/sys/sysLogin.html目录下。

  • 然后修改，刚刚复制的sysLogin.html视图文件内容，改成你满意的样式，这样就大功告成啦。

5、如果你想在公共的地方加载自己的css或js，JeeSite为你提供了两个公共文件，/src/main/webapp/static/common/common.css和/src/main/webapp/static/common/common.js文件，你可以修改它。

自定义主题，快速切换视图

1、JeeSite 4.x 版本已提供快速换肤功能，这里的换肤不是单单的换掉css改变下配色，而是，把系统中的所有的视图，包括登录页、框架页、列表页、内容页，甚至换掉grid组件。

2、上一章中说到了application.yml（v4.0.x：jeesite.yml）里视图相关配置themeName，其实上一章节的思路是让你修改和完善default这个主题，如果你想大范围的修改完全不同的UI，建议你再起一个名字。我们可以吧这个改为你想起的视图名字，如：good，这样你的所有视图文件，资源文件将都在这个目录下：/src/main/resources/views/themes/good/、/src/main/resources/static/themes/good/。另外还有两个目录，公共include的头部和尾部：/themes/good/include/header.html、/themes/good/include/footer.html。

3、下面如何操作就不用就不赘述了，和上一章节例子相同。