插件文档

【仅供内部供应商使用，不提供对外解答和培训】

Page tree

Versions Compared

Old Version 11

changes.mady.by.user richie-季明华

Saved on

compared with

New Version Current

changes.mady.by.user finedev

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagexml
fs-theme-[主题名]  (注：主题名建议使用非中文)
        |----style.css   //导入样式
        |----theme.js      //导入脚本
        |----cover.png   //主题包封面( 建议尺寸240*170 )
        |----其他目录(包括需要使用到的一些自定义资源文件)

 

组件开放接口

框架中总共有5大组件，分别是框架布局，目录树组件，多tab组件，Navigation组件和Gallery组件。如果需要的接口没有，可以到开发者龙门群里提（群号：179499938）。

...

Code Block
titleNavigation配置属性
config4navigation = {
    onBeforeInit: null,  //初始化前事件
    onAfterInit: null,   //初始化后事件
	naviComponents: null //自定义导航栏组件, 可以往里面push自定义组件, 自定义render和onClick事件;
}

自定义导航栏组件示例

Code Block
titleGallery配置属性
config4Gallery: {
    region: null   //默认所在区域
}

主题包开发

自定义主题包实为引入的外部js、css以及资源文件等。

为了使用主题接口，首先我们在theme.js里需要对FS.Theme配置进行扩展，具体代码如下：

Code Block
(function ($) {
    FS.THEME = $.extend(true, FS.THEME, {
其中：
naviComponents = [	//默认有三项，可以覆写实现自己的样式，也可以往里面push自定义组件
    navi : {...},  	//可以覆写包括消息盒子用户信息和收藏
      search: {...},  /**需要扩展的配置属性**/可以覆写搜索框
	reg: {...} 		//注册情况
]
// naviComponents.item形如以下
{
	renderEl: });
})(jQuery);

内置Classic主题采用默认配置：

Code Block
{
    config4frameJquery对象
	render:Function
	onClick:Function
	visible:Boolean
}
注意：naviComponents中的接口有待完善，所以使用的时候尽量使用原class和id，以保证能够收到系统消息等。

自定义导航栏组件示例

Code Block
titleGallery配置属性
config4Gallery: {
        resizableregion: true,
     null   //上区域
        north: 默认所在区域
} 

主题扩展接口 

框架中新增了对应主题自定义图标的接口，原有的图标均为图标字体形式，扩展后可以支持png图标的自定义配置。如果需要的接口没有，可以到开发者龙门群里提（群号：179499938）。

 

Code Block
title自定义图标接口
collapsetrue
FS.Plugin.CustomIcon.push({
   //获取菜单节点的自定义图标
   getMenuNodeCustomIcon: function     visible: true //是否可见
(icon) {
       return null;
   },
        //下区域添加自定义图标到图标列表
   addCustomIconItem : function(configSetting){
   south: {
},
   //删除之前选中的自定义图标
   removePreCustomIconSelected : function(folders) {
   },
 visible: false //是否可见添加自定义图标到目录节点上
   addItem2Folders : function(eachFolder, $folders) {
   },
        //左区域初始化已经选中的自定义图标
   initSelectedCustomIcon :    west: function(selectedFolder) {
   },
   //获取自定义图标的附件ID
   getCustomIconAttachID : function width: 230 //宽度(folder) {
       return },null;
   }
});


主题包开发

自定义主题包实为引入的外部js、css以及资源文件等。

为了使用主题接口，首先我们在theme.js里需要对FS.Theme配置进行扩展，具体代码如下：

Code Block
(function     //右区域($) {
    FS.THEME =   east:$.extend(true, FS.THEME, {}
    },
    config4Gallery: {/**需要扩展的配置属性**/
    });
})(jQuery);

内置Classic主题采用默认配置：

Code Block
{
    regionconfig4frame: null{
    },
    config4MenuTreeresizable: {true,
        region: 'west'//上区域
    },
    config4tabPanenorth: {
        region: 'east',
   visible:     style: 'bravo',true //是否可见
        isCollapsible: false},
        hasHomepageBtn: true//下区域
    },
    config4navigationsouth: {
        onBeforeInit: null,
   visible: false //是否可见
   onAfterInit: null
    }
}

 

内置Modern主题采用如下配置：

...

,

...

...

//左区域

...

west:

...

{

...

width: 230

...

//宽度
        },

...

  //右区域
        east: {}
    },
    config4Gallery: {
        region:

...

null
    },
    config4MenuTree: {

...

region: 'west'
    },
    config4tabPane: {
        region: 'east',

...

...

...

...

...

style: 'bravo',

...

isCollapsible:

...

false,
        hasHomepageBtn: true

...

 },
    config4navigation: {

...

onBeforeInit: null,
        onAfterInit:

...

null

...

}
}

 

内置Modern主题采用如下配置：
Code Block
{
    config4tabPaneconfig4frame: {
        styleresizable: 'alpha'false,
        region: 'south',
   south: {
     isCollapsible       visible: true,
        hasHomepageBtn: false}
    }
}
主题包Demo:

 

Code Block
titlestyle.css
collapsetrue
.node-navi{
	position: relative;
	float: right;
	right: 30px;
	list-style: none;
	height: 60px;
	top: 0;
}

.node-navi li{
	position: relative;
	float: left;
	left: 0;
	display: block;
	height: 60px;
	line-height: 60px;
	color: #fff;
	font-size: 14px;
	padding: 0 15px;
	cursor: pointer;
}

.node-navi li:hover{
	color: #6fd3ff;
}

.node-pane{
	position: absolute;
	top: 60px;
	left: 0;
	-webkit-border-radius: 0 0 3px 3px;
	-moz-border-radius: 0 0 3px 3px;
	z-Index: 10000;
}
.node-pane-inner{
	position: relative;
	_height: 200px;
	overflow-x: hidden;
	overflow-y: auto;
	background: rgb(41, 90, 148);
	background: rgba(41, 90, 148, 0.85);
	*width:200px;
}
.node-select{
	background: #295a94;
}

.node-pane a, .node-title{
	position: relative;
	white-space: nowrap;
	text-overflow: ellipsis;
	overflow: hidden;
	display: block;
	min-width: 160px;
	_width:180px;
	height: 20px;
	line-height: 20px;
	font-size: 14px;
	color: white;
	padding: 3px 5px 3px 12px;
	cursor: pointer;
}

.node-pane a:hover{
	background: rgb(41, 90, 148);
}
.node-title{
	padding: 5px 5px 5px 4px;
	cursor: default;
	color: #6fd3ff;
	font-weight: bold;
}
Code Block
titletheme.js
collapsetrue
(function ($) { FS.THEME = $.extend(true, FS.THEME, { config4navigation: { onAfterInit: function () { var self = this; $('#fs-frame-search').remove(); var $reg = $('#fs-frame-reg'); if ($reg.length > 0) { 
,
    config4Gallery: {
        region: 'east'
    },
    config4MenuTree: {
        onNodeExpand: function (node, $node, $parent) {
            return node.level !== 0;
        },
        onNodeClick: function (node, $node, $parent) {
            $('#fs-frame-wrapper') .empty();
            return false;
        }
    },
    config4tabPane: {
        style: 'alpha',
        region: 'south',
        isCollapsible: true,
        hasHomepageBtn: false
    }
}

主题包Demo:

 

Code Block
titlestyle.css
collapsetrue
.node-navi{
	position: relative;
	float: right;
	right: 30px;
	list-style: none;
	height: 60px;
	top: 0;
}

.node-navi li{
	position: relative;
	float: left;
	left: 0;
	display: block;
	height: 60px;
	line-height: 60px;
	color: #fff;
	font-size: 14px;
	padding: 0 15px;
	cursor: pointer;
}

.node-navi li:hover{
	color: #6fd3ff;
}

.node-pane{
	position: absolute;
	top: 60px;
	left: 0;
	-webkit-border-radius: 0 0 3px 3px;
	-moz-border-radius: 0 0 3px 3px;
	z-Index: 10000;
}
.node-pane-inner{
	position: relative;
	_height: 200px;
	overflow-x: hidden;
	overflow-y: auto;
	background: rgb(41, 90, 148);
	background: rgba(41, 90, 148, 0.85);
	*width:200px;
}
.node-select{
	background: #295a94;
}

.node-pane a, .node-title{
	position: relative;
	white-space: nowrap;
	text-overflow: ellipsis;
	overflow: hidden;
	display: block;
	min-width: 160px;
	_width:180px;
	height: 20px;
	line-height: 20px;
	font-size: 14px;
	color: white;
	padding: 3px 5px 3px 12px;
	cursor: pointer;
}

.node-pane a:hover{
	background: rgb(41, 90, 148);
}
.node-title{
	padding: 5px 5px 5px 4px;
	cursor: default;
	color: #6fd3ff;
	font-weight: bold;
}
Code Block
titletheme.js
collapsetrue
(function ($) {
   FS.THEME = $.extend(true, FS.THEME, {
       config4navigation: {
           onAfterInit: function $reg.remove(); {
               }var self = this;
               $.ajax({('#fs-frame-search').remove();
               var $reg = $('#fs-frame-reg');
  url: FR.servletURL + "?op=fs_main&cmd=module_getrootreports",
          if ($reg.length > 0) {
     type: 'POST',
             $reg.remove();
      data: {id: -1},
       }
            success: function (res, status) {
                       var nodes = $.parseJSON(res);
                       $.ajax({
                          url: FR.servletURL + "?op=fs_main&cmd=getmoduleitemsmodule_getrootreports",
                          type: 'POST',
                   data:       async: false{id: -1},
                   success: function      data: {id: 1},(res, status) {
                       var nodes  success: function= $.parseJSON(res){;
                       $.ajax({
       nodes.push($.parseJSON(res));
                   url: FR.servletURL + "?op=fs_main&cmd=getmoduleitems",
    }
                        });type: 'POST',
                       var $ul = $('<ul class="node-navi"/>').appendTo($('#fs-frame-header')); async: false,
                       $.each(nodes, function (index, root) data: {id: 1},
                           var $node = $('<li class="node-navi-li"/>').appendTo($ul);
success: function(res){
                              nodes.push($('<div/>').text(root.text).parseJSON(res));
                          }
     .appendTo($node)
                   });
            .click(function () {
         var $ul = $('<ul class="node-navi"/>').appendTo($('#fs-frame-header'));
                       if($node$.hasClass('node-select')){
    each(nodes, function (index, root) {
                           var $node = $('<li class="node-navi-li"/>').appendTo($ul);
     return;
                      $('<div/>').text(root.text)
                    }
           .appendTo($node)
                               $ul.find('.node-select').removeClass('node-select');click(function () {
                                   if($node.addClasshasClass('node-select'));{
                                    var $dropdown = $(this).data('DATA') return;
                                   if (!$dropdown) {}
                                       $dropdown = $('<div class="node-pane"/>$ul.find('.node-select').appendTo($noderemoveClass('node-select');
                                       $(this).data('DATA', $dropdown$node.addClass('node-select');
                                       var $pane$dropdown = $(this).data('<div class="node-pane-inner"/>DATA');
                                   if (!$dropdown) {
                                       $dropdown = $('<div class="node-pane"/>').appendTo($node);
                                       $(this).data('DATA', $dropdown);
                                       var $pane = $('<div class="node-pane-inner"/>')
                                           .css({
                                               'max-height': document.body.clientHeight - 90
                                           }).appendTo($dropdown);
                                       if (root.hasChildren && root.ChildNodes) {
                                           var $other = $('<div class="node-wrapper"/>').appendTo($pane);
                                           $.each(root.ChildNodes, function (index, child) {
                                               if (child.hasChildren) {
                                                   var $w = $('<div class="node-wrapper"/>').appendTo($pane);
                                                   $('<div class="node-title"/>').text(child.text).appendTo($w);
                                                   var childs = [];
                                                   _collectAllChildNodes(child, childs);
                                                   $.each(childs, function (i, n) {
                                                       _createItem(n, $dropdown, $node).appendTo($w);
                                                   });
                                               } else {
                                                   _createItem(child, $dropdown, $node).appendTo($other);
                                               }
                                           });
                                       } else {
                                           return;
                                       }
                                   }
                                   $dropdown.fadeIn('fast');
                                   $(document).bind('mouseover.nodepane', function (e) {
                                       var $t = $(e.target);
                                       if ($t.closest('.node-pane').length <= 0) {
                                           $node.removeClass('node-select');
                                           $dropdown.fadeOut('fast');
                                           $(document).unbind('mouseover.nodepane');
                                       }
                                   });
                               }
                           );
                       });
                   }
               });
           }
       },
       config4frame: {
           west: {
               width: 0 
           }
       }
   });
   var _createItem = function (node, $pane, $node) {
       return $('<a href="#"/>').text(node.text)
           .click(function () {
               FS.tabPane.addItem(node);
               $node.removeClass('node-select');
               $pane.hide();
               $(document).unbind('mousedown.nodepane');
           });
   };
   var _collectAllChildNodes = function (node, childs) {
       var self = this;
       if (!node.ChildNodes) {
           return;
       }
       $.each(node.ChildNodes, function (index, child) {
           if (child.hasChildren) {
               _collectAllChildNodes(child, childs);
           } else {
               childs.push(child);
           }
       });
   };
})(jQuery);

效果图如下：

Image Added

 

为了使用主题扩展接口，首先我们在theme.js里需要对FS.Plugin.CustomIcon配置进行扩展，theme.js的代码代码如下：

Code Block
title自定义图标接口
collapsetrue
(function($){
	//主题配置属性
	FS.THEME = $.extend(true, FS.THEME, {
        /**需要扩展的配置属性**/
    });
	
	//自定义图标需要扩展的接口
	FS.Plugin.CustomIcon.push({
		/*获取菜单节点的自定义图标*/
		getMenuNodeCustomIcon: function (icon) {
			return null;
		},
		/*添加自定义图标到图标列表*/
		addCustomIconItem : function(configSetting){
		},
		/*删除之前选中的自定义图标*/
		removePreCustomIconSelected : function(folders) {
		},
		/*添加自定义图标到目录节点上*/
		addItem2Folders : function(eachFolder, $folders) {
		},
		/*初始化已经选中的自定义图标*/
		initSelectedCustomIcon : function(selectedFolder) {
		},
		/*获取自定义图标的附件ID*/
		getCustomIconAttachID : function (folder) {
			return null;
		}
	});
})(jQuery);

自定义图标的demo：

theme.js

Code Block
languagejs
title自定义图标demo
linenumberstrue
collapsetrue
(function ($) {

      FS.Plugin.LookAndFeelSettings.push({
        item:   .css(function(ctx) {
            return {
                title: FR.i18nText(""),
                 'max-height': document.body.clientHeight - 90content: $("<div />")
            };
        },
        action: function (tabPane) {
        }
    }).appendTo($dropdown);

    FS.THEME =                $.extend(true, FS.THEME, {
		/**需要扩展的配置属性**/
    });
	
    FS.Plugin.CustomIcon.push({
        getMenuNodeCustomIcon:  iffunction (root.hasChildren && root.ChildNodesicon) {
            /*这边定义了一个op,用于处理图标图片的文件读取和加载，不同的主题op不能相同，否则会有冲突！*/
            /*这边定义了一个cmd=read_img,把png图标从文件中读入到内存以及缓存中*/
            var config =  {
   var $other = $('<div class="node-wrapper"/>').appendTo($pane);
          url: FR.servletURL + '?op=custom_icon&cmd=read_img',
                data: {
             $.each(root.ChildNodes, function (index, child) {
   id : icon
                }
            };
            var attach if= (child.hasChildren) {
FS.Sync.ajax(config);
            var $icon = $('<span/>').addClass("fs-menu-icon");
            /*这边定义了一个cmd=getattach,从缓存中获取之前读入的附件png图标，图片的文件名存入img的alt属性中，后续保存的时候也可以方便处理*/
            var url = FR.servletURL + ('?op=custom_icon&cmd=get_attach&id=' + attach.attachid + '&isAdjust=false');
          var $w = $('<img>').attr('src',url).attr('alt'<div class="node-wrapper"/>, attach.attachfile).addClass('fs-menu-node-icon').appendTo($pane$icon);
             return $icon;
        },
        removePreCustomIconSelected : function(folders) {
            //选择之前先删除之前的选择
      $('<div class="node-title"/>').text(child.text).appendTo($w);
     var curFolder = $('.fs-icon-folder-item.selected .folder-icon', folders);
            $('.fs-icon-folder-item.selected .fs-folder-customIcon-selected', folders).remove();
            curFolder.removeAttr('style');
        },
       var childsaddCustomIconItem = [];: function(configSetting){
            var self = configSetting;

            var config = {
                url: FR.servletURL    _collectAllChildNodes(child, childs);+ '?op=custom_icon&cmd=read_img',
                                 data: {
                  $.each(childs, function (i, n) {id : ''
                }
            };
            var completeFn = function (res, status) {
         _createItem(n, $dropdown, $node).appendTo($w);
     var result = FR.jsonDecode(res.responseText);
                $.each(result, function(index, attach){
                    var $icon = $('<div  });class="fs-icon-item"/>').hover(function () {
                        $(this).addClass('icon-hover');
                    }, function () } else {
                        if (!$(this).hasClass('selected')) {
                          _createItem(child, $dropdown, $node$(this).appendTo($otherremoveClass('icon-hover');
                        }
                    }).click(function ()  }
                  {
                         }self.selectIconItem($(this));
                    });
                   } elsevar {
url = FR.servletURL + ('?op=custom_icon&cmd=get_attach&id=' + attach.attachid + '&isAdjust=false');
                    $('<img>').attr('src',               returnurl).attr('alt', attach.attachfile).addClass('fs-customIcon-list-item').appendTo($icon);
                    $icon.data('ENTRY', {text: attach,onSelect: function                }($icon) {
                        var curFolder = $('.fs-icon-folder-item.selected        }
          .folder-icon', self.$folders);
                         $dropdown.fadeIn('fast');//选择之前先删除之前的选择
                        $('.fs-icon-folder-item.selected .fs-folder-customIcon-selected', self.$folders).remove();
         $(document).bind('mouseover.nodepane', function (e) {
               curFolder.removeAttr('style');

                        var $turl = $(e.target('.fs-customIcon-list-item', $icon).attr('src');
                        var altText = $('.fs-customIcon-list-item', $icon).attr('alt');
           if ($t.closest('.node-pane').length <= 0) {
         var img =     $('<img>').attr('src',url).attr('alt', altText).addClass('fs-folder-customIcon-selected');
                           $node.removeClass('node-select')curFolder.attr('style', 'padding-left:0px').html("");
                        img.insertBefore($('.fs-icon-folder-item.selected .folder-icon', self.$folders));
                   $dropdown.fadeOut('fast' }});
                    $icon.appendTo(self.$icons);
                });
           $(document).unbind('mouseover.nodepane') };
            FS.Async.ajax(config, completeFn);
        },
        addItem2FolderNodes : function(eachFolder, $folders) {
      }
      var config = {
                url: FR.servletURL + '?op=custom_icon&cmd=read_img',
       });
         data: {
                    id : }eachFolder.value
                }
            )};
            var attach = FS.Sync.ajax(config);
            if(attach.attachid && });attach.attachfile) {
                var url = }
FR.servletURL + ('?op=custom_icon&cmd=get_attach&id=' + attach.attachid           }+ '&isAdjust=false');
           }
       },
       config4frame: {$('<img>').attr('src', url).attr('alt', attach.attachfile).addClass('fs-folder-customIcon-selected').appendTo($folders);
           west: {
    $('<i           width: 0 
           }
class="folder-icon"/>').attr('style', 'padding-left:0px').html("").appendTo($folders);
         }
   });
   var _createItem = function (node, $pane},
 $node) {
      initSelectedCustomIcon return: $function('<a href="#"/>').text(node.text)
selectedFolder) {
            var altText = .click(function () {$('.fs-folder-customIcon-selected', selectedFolder).attr('alt');
               FS.tabPane.addItem(node);$.each(FSCS.View.$icons.children(), function(i, folderIcon){
               $node.removeClass('node-select');
 if (($('.fs-customIcon-list-item', folderIcon).attr('alt'))) {
                    if  $pane.hide();
  (altText === ($('.fs-customIcon-list-item', folderIcon).attr('alt'))) {
             $(document).unbind('mousedown.nodepane');
            }FSCS.View.selectIconItem(FSCS.View.$icons.children().eq(i));
   };
        var _collectAllChildNodes = function (node, childs) {
   }
    var self = this;
       if (!node.ChildNodes) {
 }
            return;})
        },
         $.each(node.ChildNodes,getCustomIconAttachID : function (index, childfolder) {
           if (child.hasChildren) {
  //寻找自定义的图标img的alt值
            return  _collectAllChildNodes(child, childs($('.fs-folder-customIcon-selected', $(folder)).attr('alt'));
        }
    } else});

})(jQuery);

style.css

Code Block
languagecss
title自定义图标demo
linenumberstrue
collapsetrue
.fs-menu-node-icon {
    width: 25px;
    height: 16px;
}

.fs-folder-customIcon-selected {
     childs.push(child)width:25px;
    height:16px;
       }
 padding-left:10px;
}

.fs-customIcon-list-item {
      })width:80px;
    };
})(jQuery);

效果图如下：

Image Removed
height:80px
}

对应的后台处理以及完整的代码见示例demo

View file
nameplugin-theme_custom_icon-master@d0dd99c3ef5.zip
height250

效果图如下：

在编辑目录图标的下方可以识别指定目录下的png图片，然后加载进来，以供选择，图片的大小尺寸请自行调整（示例上是80*80）

Image Added

 

系统配色

系统配色主要有4种：高亮色、图标外框色、底栏色和文字色，可通过复写css来修改任意地方的样式或者配色

 

 

  1. 颜色1——高亮色。“收藏”“消息”“个人中心”三个图标选中状态及tab选中项提亮色，
  2. 颜色2——图标外框色。导航栏图标外围色；
  3. 颜色3——底栏色。左侧导航栏激活项背景色以及Tab栏背景颜色；
  4. 颜色4——文字色。字体颜色。

系统配色分别对应如下css样式：

 

Code Block
languagecss
title高亮色
.fui-bsb{
  background-color: @color;
}
.fui-bsc{
  color: @color;
}
.fui-bsd{
  border-color: @color;
}
Code Block
languagecss
title图标外框色
.fui-fhc{
  color: @color;
}
.fui-fht{
  text-shadow: 0 0 3px @color;
}
Code Block
languagecss
title底栏色
.fui-seb{
  background-color: @color;
}
Code Block
languagecss
title文字色
.fui-fbc{
  color: @color;
}
.fui-fbt{
  text-shadow: 0 0 1px @color;
}

请求接口

获取管理系统节点

请求参数
FR.servletURL + "?op=fs_main&cmd=getmoduleitems"{id: -1}

获取目录树节点

请求参数
FR.servletURL + "?op=fs_main&cmd=module_getrootreports"{id: -1}

（BI）获取我创建的列表

请求参数callback
FR.servletURL + "?op=fr_bi&cmd=get_folder_report_list"{}[{lastModify:1466402196217,pId:"-1","id":"1",text:"功能演示",value:"348602efbb80f686"}]

（BI）新建分析

请求参数callback
FR.servletURL + "?op=fr_bi&cmd=add_report"{reportName:'模板名', reportLocation: '我是模板文件夹的id', realTime: false}{"reportId":23}

（BI）模板超链

请求参数callback
FR.servletURL + "?op=fr_bi&cmd=init_dezi_pane&reportId=23&edit=_bi_edit_"  

（BI）数据配置超链

请求参数callback
FR.servletURL + "?op=fr_bi_configure&cmd=init_configure_pane"  

标签页单独集成

FS.loadModule(render, moduleName)
方法：根据模块名加载对应模块配置页面，用于集成独立页面
参数： render 渲染dom
      moduleName 模块名
例如：FS.loadModule($('<div/>').appendTo('body'), 'report');

集成并加载指定标签模块，模块名列表如下：

模块名参数值
报表管理report
用户管理user
权限管理privilege
定时调度schedule
系统管理sysmgr
平台外观lookandfeel
注册信息register
系统监控monitor
移动平台mobile


注: 必须先做单点登录，只有登录FS才有访问标签页的权限。注：必须先做单点登录，只有登录FS才有访问标签页的权限。

用户注销

FS.signOut()
方法：注销当前登录的用户，并返回登录页面。
参数：无。