Metronic 与 VS2013/2015 合作开发

时间:2022-10-03 02:58:21

Metronic 与 VS2013/2015 合作开发 

去年购买了一个:METRONIC  (http://www.keenthemes.com/) ,最近下了最新的版本:V3.7 ,解压缩后,目录如下:(没有列出RTL 部分)

- _documentation - Contains of admin and frontend themes general documentation files.

- _resources - Contains of commercially licensed and free stock photos and the theme's PSD files.

- theme - Metronic HTML theme's main folder(Default version).
     - assets - Contains of theme related files(css, js, images, etc).
         - admin - Contains of admin theme related files(css, js, images, etc).
         - frontend - Contains of admin theme related files(css, js, images, etc).
         - global - Contains of global Metronic framework components, customized 3rd party plugins.
                      All the features under global folder can be used both in frontend theme and admin theme.

- sass - Contains of SASS(sass-lang.com) files for the admin theme(only the admin default version fully supports SASS).
     - templates - Contains of admin and frontend theme template pages.
        - admin - Contains of admin theme templates pages.
        - frontend - Contains of frontend theme template pages.

1、建立一个 VS 2013 的解决方案,在方案中,创建一个*文件夹(Metronic),与 Models、Controllers 等平列,将:解压缩的 METRONIC软件 下的 theme 文件夹下的内容 COPY 过来到:文件夹(metronic)下。 可以只保留有关的管理主题Admin,对 frontend 文件夹(前端主题)可以删除,而且对ADMIN 主题下的四个,可以仅保留一个。

运行VS,通过游览器本地地址:http://localhost:XXXX/metronic/templates/admin/index.html    HTML 版本;

http://localhost:9087/metronic/templates/admin/angularjs/#/dashboard.html        angularjs 版本;

2、对于 VS2015 的解决方案 ,由于静态文件放置于:WWWROOT 文件夹下,因此在其中创建一个文件夹(Metronic),复制 METRONIC软件下 theme 文件夹下的内容,类似 VS2013 的操作。

运行VS,同样通过游览器本地地址 http://localhost:XXXX/metronic/templates/admin/index.html  访问 HTML 版本。

3、本人只关注:Metronic 的 angularjs 版本。  (服务目录:E:/ZXL_CDREPORT)

4、将解决方案 Views\Home 目录的 Index.cshtml 的内容,全部置换为 metronic 软件 admin 主题下 angularjs 版本的 index.html 文件的内容。

(注意:如果直接修改 metronic 的文件,需要保存为 UTF8 格式,原文件不是UTF8。)

A、  修改 CSS 文件的相对引用路径为直接引用。即: href="../../../   修改为  href="/metronic/  .

B、  修改JAVASCRIPT (JS) 文件的引用   src="js/app.js"  及 src="js/directives.js"  为:

src="~/metronic/templates/admin/angularjs/js/app.js"

src="~/metronic/templates/admin/angularjs/js/directives.js"

C、 将 data-ng-include="'tpl/XXXX.html'"  几个 包含引入的文件,涉及:METRONIC\templates\admin\angularjs\tpl 下的几个文件。

使用 ASPNET 5 的 WEBCOMPONENT 技术实现。需要 增加控制器。 在 Controllers下增加 ViewComponents 文件夹,设计一个类:

public class LayoutTplViewComponent : ViewComponent

{
                             private readonly ApplicationDbContext db;

public LayoutTplViewComponent(ApplicationDbContext context)
                             {
                                 db = context;
                             }

public async Task<IViewComponentResult> InvokeAsync(string tpl)
                              {

return View(tpl);
                              }

}

将 INDEX 文件中 <div data-ng-include="'tpl/XXX.html'" data-ng-controller="XXXController" class="XXX hidden-xs hidden-sm">
                    </div>

更换为:

<div data-ng-controller="XXXController" class="XXX hidden-xs hidden-sm">
                            @await Component.InvokeAsync("LayoutTpl", "XXX")    //异步调用上述类的方法。
                    </div>

主题 theme-panel.html  可以不用处理,否则,好像按钮没有了作用。

实际 Footer.html 也可以不用处理。否则回到顶部的按钮不见。可能是JS脚本没有执行。

重点处理:Header sidebar 菜单,SIDEBAR 的菜单希望从数据获取后使用 RAZOR 语法生成。

5、修改 app.js 文件 的路由配置。MetronicApp.config() 方法

1)$urlRouterProvider.otherwise("XXXX");  是默认的路由,系统初始打开的内容页面,由其确定。

2)将各个路由配置的资源路径,修改为绝对引用路径。

3) 为了自动配置,此处配置可以考虑使用 单独的JS 文件。!!!

     6、修改 app.js 文件 的控制器的初始化 MetronicApp.controller()

在此方法中,在一段备注:Init entire layout(header, footer, sidebar, etc) on page load if the partials included in server side instead of loading with ng-include directive ,意思是:如果主页(INDEX)的一部分内容(比如 header,sidebar 等)不是用:ng-include 标注引入,而且通过服务器端写入,则在页面载入时,需要初始化全部 或者 部分。 取决于 通过服务器插入的部分。

全部通过服务端插入,使用 Layout.init();

(推荐:本人只是考虑  header,sidebar)部分通过服务端插入,写入相应部分,Layout.initHeader();  Layout.initSidebar();

/* Setup App Main Controller */

MetronicApp.controller('AppController', ['$scope', '$rootScope', function($scope, $rootScope) {
                 $scope.$on('$viewContentLoaded', function() {
                      Metronic.initComponents(); // init core components
                     //Layout.init();     // Init entire layout(header, footer, sidebar, etc) on page load

if the partials included in server side instead of loading with ng-include directive

Layout.initHeader();    // init header   初始化移动到此处。
                       Layout.initSidebar();                         初始化移动到此处。
                  });
            }]);

           同时,取消 各自控制器的初始化。如:

/* Setup Layout Part - Header */
              MetronicApp.controller('HeaderController', ['$scope', function($scope) {
                   $scope.$on('$includeContentLoaded', function() {
                      // Layout.initHeader(); // init header    取消此部分。
                   });
               }]);

/* Setup Layout Part - Sidebar */
              MetronicApp.controller('SidebarController', ['$scope', function($scope) {
                  $scope.$on('$includeContentLoaded', function() {
                     // Layout.initSidebar();   // init sidebar   取消此部分。
                  });
              }]);

7、控制器的修改,使用“点击展开菜单”出现立即关闭(缩回)的问题,实际是:引发了两次动作。

问题解决方法是:修改此“点击”引发的JS方法,只处理一次动作。

修改文件:/metronic/assets/admin/layout/scripts/layout.js  文件,此文件是返回一个对象,

return {} 中 initSidebar: function ()  就是前面谈到的 初始化方法。

1)在文件的开始处(layout 函数外),定义一个变量

var zxl = 0;

2)在 initSidebar 函数的开始,判断处理的次数,第二次,直接返回。

              initSidebar: function () {

                  zxl = zxl + 1;
                  if (zxl % 2 === 0) {
                     zxl = 1;
                    return;
                 }

//layout handlers
                。。。。。