如何让程序员更容易的开发Web界面?重构SmartAdmin展示TinyUI框架

微笑、不失礼 提交于 2019-12-09 12:04:11

序言

如何让程序员更容易的开发Web界面,是一个持久的话题,所有的从事相关开发的公司都会碰到这个问题,并且被这个问题所深深困扰。

Tiny框架也不得不直视这个问题,确实来说,想解决这个问题,也是非常有难度与深度的,业界也有各种各样的尝试,这也是有各种各样不同框架出现的原因。

Tiny框架构建者认为,完全采用一种框架解决所有问题,是不现实的。而且即使目前找得到一种非常好的框架,暂时可以满足应用需要,但是随着技术的发展,业务的进化,就会慢慢变得不再满足业务需要。因此,Tiny框架构建从不再把做一套UI组件去适各种需求作为自己的目标。

反过来,我们看看在做Web应用中,可能会碰到的问题:

  1. UI中JS的引入与顺序,JS合并的问题
  2. UI中css的引入与顺序,CSS合并的问题
  3. UI中碰到性能问题时的影响范围,比如:一个树出现问题,要改动许多用到树的地方
  4. 代码重复的问题,同样的内容在许多地方都有,如果要改动就要改动许多个地方
  5. 整体布局调整困难的问题
  6. 程序员需要关注的内容太多的问题,JS,CSS,布局,后台业务,前台展现,尼玛界面工程师必须得是全才才可以搞得定所有问题。
  7. 开发效率的问题
  8. 执行效率的问题,前台响应要求速度更快
  9. 集群的问题
  10. 国际化的问题
  11. ...

因此,我在以前写过一篇文章:UI开发的终极解决方案感兴趣的同学,可以去看看,今天的目标是利用TinyUI框架的重构SmartAdmin,使得更容易被使用。

SmartAdmin初识


SmartAdmin是一套基于JQuery,Bootstrap构建的UI组件库,说直白些,它就是个大杂烩,它把各种JQuery插件和Bootstrap整合到一起,提供了一整套基本完整的应用开发UI库,基本是拿着它就可以用来非常专业的应用系统了。

下面是界面,当然它内嵌提供了四套皮肤,可以进行切换的:

由于SmartAdmin是商业产品,需要购买,因此不能提供其Copy,据说在Baidu可以搜到,据说可以下载。如果只是想看一下的话,请点击此链接:http://192.241.236.31/test4.smartadmin/

SmartAdmin分析

通过对SmartAdmin的分析,发现其复用了大量的开源插件,并且利用了Ajax加载技术,在运行期加载了大量的JS插件或CSS,整个页面采用Html+JS整合而成,许多JS与页面还是分离的,也就是说对本页面中的Dom元素的处理的JS不一定在当前html文件中,所以要想看得懂是非常困难的,如果想把它应用在自己的项目当中,也是非常困难的一件事情。

举个例子来说,要显示一个小部件,需要写这么一段内容:

<div class="jarviswidget" id="wid-id-0">
 <!-- widget options:
 usage: <div class="jarviswidget" id="wid-id-0" data-widget-editbutton="false">
 
 data-widget-colorbutton="false" 
 data-widget-editbutton="false"
 data-widget-togglebutton="false"
 data-widget-deletebutton="false"
 data-widget-fullscreenbutton="false"
 data-widget-custombutton="false"
 data-widget-collapsed="true" 
 data-widget-sortable="false"
 
 -->
 <header>
 <h2><strong>Default</strong> <i>Widget</i></h2> 
 
 </header>


 <!-- widget div-->
 <div>
 
 <!-- widget edit box -->
 <div class="jarviswidget-editbox">
 <!-- This area used as dropdown edit box -->
 <input class="form-control" type="text">
 <span class="note"><i class="fa fa-check text-success"></i> Change title to update and save instantly!</span>
 
 </div>
 <!-- end widget edit box -->
 
 <!-- widget content -->
 <div class="widget-body">
 
 <p> Widget comes with a default 10 padding to the body which can be removed by adding the class <code>.no-padding</code> 
 to the <code>.widget-body</code> class. The default widget also comes with 5 widget buttons as displayed on top right 
 corner of the widget header. </p>
 <a href="javascript:void(0);" class="btn btn-default btn-lg"> <strong>Big</strong> <i>Button</i> </a>
 
 </div>
 <!-- end widget content -->
 
 </div>
 <!-- end widget div -->
 
</div>
这个程序员处理起来还是相当有难度的,好吧,这还不算过分的。

执行下面的命令:

dir *.js /s /w
运行结果:
所列文件总数:
        310 个文件      6,043,053 字节

执行下面的命令:

dir *.css /s /w
运行结果:
所列文件总数:
         36 个文件      1,511,412 字节
里面有这么多的JS,有这么多的CSS,它们的引入顺序也是非常重要的,稍有差错,就会有js错误的问题。

再来看看,JS加载过程:


可以看到,要访问大量的js,CSS,对于服务器的压力是比较大的,客户端加载时间也是比较长的,程序员要厘清这些关系,也是非常困难的。

SmartAdmin重构

对SmartAdmin重构,是指按照Tiny框架的体系结构来进行重构。

第一步,厘清关系

通过整理,发现smartadmin中使用的js插件有如下之多:

bootstrap
bootstrapProgressbar
bootstrapSlider
bootstrapTags
bootstrapTimepicker
bootstraptree
bootstrapWizard
ckeditor
colorhelpers
colorpicker
datatables
delete-table-row
dropzone
easyPieChart
excanvas
fastclick
flot
FontAwesome
fueluxwizard
fullcalendar
ie-placeholder
ion-slider
jquery
jquery-form
jquery-nestable
jquery-touch
jqueryui
jqueryvalidate
js-migrate
jstorage
knob
markdown
maskedInput
maxlength
morris
msieFix
multiselect
notification
noUiSlider
pace
prettify
raphael
select2
selectToUISlider
smartadmin
smartwidgets
sparkline
summernote
superbox
throttle-denounce
typeahead
vectormap
x-editable

第二步:UI插件,组件包化:

比如JQuery组件包化,就是编写下面的文件:jquery.ui.xml

<ui-components>
    <ui-component name="jquery">
        <js-resource>/jquery/jquery-1.11.0.js</js-resource>
    </ui-component>
</ui-components>

比如JQueryUI组修的包化,就是编写下面的文件:jqueryui.ui.xml

<ui-components>
    <ui-component name="jqueryui" dependencies="jquery">
        <js-resource>/jqueryui/js/jquery-ui-1.10.4.custom.js</js-resource>
        <css-resource>/jqueryui/css/smoothness/jquery-ui-1.10.4.custom.css</css-resource>
    </ui-component>
</ui-components>

比如BootStrap组件包化,就是写下面的文件:bootstrap.ui.xml

<ui-components>
    <ui-component name="bootstrap" dependencies="jqueryui">
        <css-resource>/bootstrap/css/bootstrap.min.css</css-resource>
        <js-resource>/bootstrap/js/bootstrap.js</js-resource>
    </ui-component>
</ui-components>

其它类推,最主要的目的就是要分清,用到哪些JS,哪些CSS,并且整理组件包之间的依赖关系,比如,上面BootStrap就依赖了jqueryui,当然jqueryui依赖了JQuery

通过上面的依赖树Tiny框架就可以自动构建好CSS及JS资源。

因为这些资源都是放在Jar工程的main/resources目录中,因此就直接打进jar包了。

第三步,编写宏

比如,原来的Tab,需要涉及到html,js,编写后续使用的宏如下:

#**
 * JqueryUI Tab
 * juiTab[1..1]
 *      juiTabHeader[1..1]
 *          juiTabHeaderItem[1..n]
 *      juiTabContentItem[1..n]
 *#

#macro(juiTab $juiTabId)
<div id="$juiTabId">
$bodyContent
</div>
<script>
    $(document).ready(function(){
        $('#$juiTabId').tabs();
    });
</script>
#end

#macro(juiTabHeader)
<ul>
$bodyContent
</ul>
#end

#macro(juiTabHeaderItem $juiTabContentItemId)
<li>
    <a href="#$juiTabContentItemId">$bodyContent</a>
</li>
#end

#macro(juiTabContentItem $juiTabContentItemId)
<div id="$juiTabContentItemId">
$bodyContent
</div>
#end

以后的程序员就可以以如下方式编写一个Tab页了:

#@juiTab("tabs")
    #@juiTabHeader()
        #@juiTabHeaderItem("tabs-a")First#end
        #@juiTabHeaderItem("tabs-b")Second#end
        #@juiTabHeaderItem("tabs-c")Third#end
    #end
    #@juiTabContentItem("tabs-a")
        tabs-a content
    #end
    #@juiTabContentItem("tabs-b")
        tabs-b content
    #end
    #@juiTabContentItem("tabs-c")
        tabs-c content
    #end
#end

通过上面的处理,封闭了代码的具体实现,而换之以容易理解的宏,在提升开发人员开发效率方面,提升代码的易维护性方面都有显著提升。尤其是在需要变化的时候,只要接口不变化,很多的时候,只要修改宏定义即可,对于程序员写的界面文件,完全可以做到透明化处理。

重构之后的结果

可以看到,重构之后的界面样式与原来没有任何变化。

接下来看看,JS的加载:从原来的许多个js文件,变成只加载两个,说明js文件已经被合并并压缩传输。

再来看看css的加载,可以看到,也是只需要一个就可以了:

重构之后写个小组件,是下面的样子:

#@jarvisWidget("wid-id-0" '<strong>Default</strong> <i>Widget</i>')

    #@jarvisWidgetHeader()
    #end
    #@jarvisWidgetBody()
        #@widgetEditBox()
        <input class="form-control" type="text">
        <span class="note"><i class="fa fa-check text-success"></i> Change title to update and save instantly!</span>
        #end
        #@widgetBody()
        <p> Widget comes with a default 10 padding to the body which can be removed by adding the class
            <code>.no-padding</code>
            to the <code>.widget-body</code> class. The default widget also comes with 5 widget buttons as
            displayed on top right
            corner of the widget header. </p>
        <a href="javascript:void(0);" class="btn btn-default btn-lg"> <strong>Big</strong> <i>Button</i>
        </a>
        #end
    #end
#end

总结

通过对SmartAdmin进行重构,成功的理清了smartadmin中的css,js关系,便于进行后续复用。

通过编写宏,可以在组件开发人员与页面开发人员之间进行隔离。由组件开发人员与js,css等打交道,而让页面开发人员只关注业务展现。


易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!