Ext JS 6开发实例 :主界面设计

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Ext JS 6开发实例 :主界面设计相关的知识,希望对你有一定的参考价值。

在上文中,已经将CMD创建的应用程序导入到项目里了,而且也看到默认的主界面了,今天的主要工作就是修改这个主界面,以符合项目的需要。除了设计主界面,还有一些其他的东西需要配置一下。

添加本地化包

打开app.json文件,找到requires,代码如下:

    "requires": [      "font-awesome"

    ],12341234

以上代码说明项目默认已经引用了Font Awesome的图标,可以在项目中直接使用。这个在项目的后续开发中会经常使用到。

本地化文件从Ext JS 5开始,就已经采用包的方式来提供了,也就是说,在执行sencha app build的时候,会将引用的本地化包也打包到最终的app.js文件中,不再需要在页面中使用SCRIPT标记来另外加载了。

要添加本地化包,需要在requires对应的数组中添加“locale”项,然后添加一个locale配置,用来声明需要引用哪些本地化包,这里只需要引用中文,所以只需要把“zh_CN”作为locale配置的值就行了。

添加本地化包的最终代码如下:

    "requires": [        "font-awesome",        "locale"
     ],    "locale": "zh_CN",123456123456

好了,现在执行一次sencha app build重新生成一下应用程序,然后在浏览器中打开应用程序,如果在firebug的网络面板中看到已加载ext-locale-zh_CN.js文件,说明本地化文件已可以正确加载,可以使用了。

主界面设计

从上文最后一张图片可以看到,默认创建的主界面是一个左右结构的界面。研究下app\view\main目录下的Main.js可以清楚的知道,整 个界面其实是用标签面板(Ext.tab.Panel)实现的,只不过是将标签放置在了左边而已。这可以说是目前比较流行的一种界面结构了。不过,我还是 希望能有一个顶栏用来显示项目名称和退出按钮等东西。

要添加一个顶栏,我比较倾向的方式是使用垂直盒子(VBox)布局来将一个容器划分为上下两个部分,当然,如果习惯使用边框布局(Border)的,也可以用,问题不大,能实现自己所需就行了。

为了实现以上修改,我打算添加一个视区视图,在视区视图内,使用垂直盒子布局来将它划分为上下两个部分,在上半部分,还需要添加一个顶部视图用来控制顶部视图的显示,而下半部分继续使用现在的主视图。

定义主视图

在app/view目录下添加一个名为Viewport.js的文件,然后添加基本的定义代码:

Ext.define(‘SimpleCMS.view.Viewport‘, {
    extend: ‘Ext.container.Container‘,    requires: [        ‘Ext.layout.container.VBox‘,        ‘Ext.plugin.Viewport‘,
    ],    layout: {
        type: ‘vbox‘,        align: ‘stretch‘
    },

});1234567891011121312345678910111213

由于在Ext JS 6,Viewport类使用了插件的形式来实现,因而这里也遵守这种方式。在这里引用了Ext.layout.container.VBox类,用来实现垂直盒子布局。

在layout配置项中,定义了这里将使用垂直盒子布局,align配置项的作用是告诉父组件,子组件的宽度将填满父组件的宽度。

接下来是添加子组件,代码如下:

    items: [
        {
            xtype: ‘app-header‘,
            height: 65,
            id: ‘app-header‘
        },
        {
            xtype: ‘app-main‘, flex: 1
        }
    ]1234567891012345678910

尽管顶部视图还没定义,不过还是可以先把app-header作为顶部视图的xtype值。在这里,顶部视图的高度将被定位为65个像素。为顶部视图定义一个id的目的是为了便于编写顶部的视图的样式。

在下半部分,将显示原来的主视图。在这里使用了flex配置项,它的作用是告诉父组件,该子视图的高度将填满父组件减去顶部视图后余下的高度。

定义顶部视图

在app/view目录下创建一个名为header的目录,然后在该目录下添加名字为Main.js的文件。

下面先来定义视图,视图与Ext JS 4版本一样,将使用工具栏来实现,在左边显示项目的标题,在右边显示修改密码和退出按钮,代码如下:

Ext.define("SimpleCMS.view.header.Main",{
    extend: "Ext.toolbar.Toolbar",

    cls: ‘toolbar-btn-shadow‘,

    xtype: ‘app-header‘,

    items: [
        { xtype: ‘tbtext‘, text: ‘简单的CMS系统‘, id: ‘app-header-title‘ },        ‘->‘,
        { tooltip: ‘修改密码‘, iconCls: ‘x-fa fa-key header-button-color‘, cls: ‘simplecms-header-button‘, handler: ‘onChangePassword‘ },
        { tooltip: ‘退出‘, cls: ‘simplecms-header-button‘, iconCls: ‘x-fa fa-sign-out header-button-color‘, handler: ‘onExit‘ }    ]});12345678910111213141234567891011121314

在工具栏内,在左边使用Ext.toolbar.TextItem组件来显示项目标题。为标题定义一个id是为了便于定义样式。

在定义中,“->”表示这里将使用Ext.toolbar.Fill来填充空间,以便实现子组件显示在右边。

在定义的两个按钮中,使用了FONT AWESOME的字体图标来作为图标。FONT AWESOME有许多图标,该如何选择并使用呢?其实很简单,在浏览器中打开http://fontawesome.io/icons/ ,就可以看到在FONT AWESOME中有哪些图标了,当选中一个图标,如car,会在页面中看到如下示例代码:

<i class="fa fa-car" aria-hidden="true"></i>11

在代码中的“fa fa-car”就是所需的样式名,在Ext JS 6中使用,只需要在第一fa前添加“x-”就可以了,如类定义代码中的“x-fa fa-key”。

使用FONT AWESOME图标,默认情况下与页面中看到的情形一样,图标都是黑色的,这时候,可以通过样式来改变字体颜色,在上面代码中,样式”header-button-color“就是用来定义字体颜色的。

由于Ext JS的按钮在默认情况下是有背景颜色的,因而在上门代码中,使用了cls配置项来添加一个样式”simplecms-header-button“以便去除背景颜色。

哪为什么要使用cls配置项来去除背景,而不是直接在iconCls中实现呢?如果你研究过一个按钮的html实现,就会发现它的结构是这样的:

<a>
    <span>
        <span>
            <span></span>
            <span></span>
        </span>
    </span></a>1234567812345678

在这个结构中,A元素是顶级元素,按钮的背景颜色等,是在这一层定义的。而按钮的图标和文字使用最深层的两个SPAN元素来实现的,其中第一个 SPAN元素是用来显示图标的,第二个SPAN元素是用来显示文字的。iconCls配置项的作用是定义按钮图标,因而为它定义的样式只会应用于最深层的 第一个SPAN元素,这样,在这里添加样式是取消不了按钮的背景颜色的。而cls配置项则不同,它的作用就是用来定义按钮的整体样式的,会将样式应用于A 元素。

大家可能注意到,在这里并没有为顶部视图定义它的控制器和视图模型,主要是因为该类比较简单,也不涉及数据绑定,因而只定义一个视图文件就足够了。

为顶部视图添加样式

在顶部视图定义了不少样式,下面来定义这些样式。定义方法与Ext JS 4是一样的。在应用程序目录下有一个sass目录,这个目录就是用来定义样式的。在该目录下有etc、example、src和var这4个目录,其 中,src目录是直接用来定义样式的,而var目录就是用来定义样式变量的,具体就是API中所看到CSS Vars中的变量,当然,也可以定义自己的变量,在这里并不需要用到,因而就不展开了。

在src目录下要定义某个视图的样式,首先,要做的就是保持与视图一样的目录结构,如顶部视图的目录结构是view/header,那么在src 下,也应该在view/header目录下定义顶部视图的样式。其次,就是文明名除了扩展名外,也必须是相同的,如现在顶部视图的文件名为 Main.js,则顶部视图对应的样式文件是Main.sass。

在src/view/header目录下创建Main.sass文件后,添加以下样式代码:

#app-header{    background-color:#6A9A1F;    border-bottom:1px solid #0d1218 !important,}.toolbar-btn-shadow {    box-shadow: 0 1px 2px rgba(13, 18, 24, 0.2);}#app-header-title {    color: #fff;    font-size: 18px;    padding: 10px 0 10px;}.simplecms-header-button{    border:none;    background:none;}.header-button-color{    color:orange;}1234567891011121314151617181920212212345678910111213141516171819202122

修改app.js文件

由于在app.js文件中,默认是使用SimpleCMS.view.main.Main作为主视图的,而主视图现在已经修改为SimpleCMS.view.Viewport,因而需要进行修改。

结果

现在执行一次sencha app build,然后刷新浏览器,就应该能看到如下图的效果了。

技术分享

从图中可以看到,整体效果已经出来了,下一步要做的就是调整下半部视图的显示了,这个下文再说。


以上是关于Ext JS 6开发实例 :主界面设计的主要内容,如果未能解决你的问题,请参考以下文章

Ext JS 6开发实例

Ext JS 6学习文档-第8章-主题和响应式设计

[020]Sencha Ext JS 6.0使用教程2

Ext JS 6开发实例 :使用CMD创建应用程序

Ext JS 6学习文档-第3章-基础组件

什么是 ext.js