【翻译】在Ext JS中创建特定主题的重写

原文：http://www.sencha.com/blog/creating-theme-specific-overrides-in-ext-js/

作者：Lee Boonstra
                                   Lee is a technical trainer at Sencha. She’s located in Amsterdam and has experience in both front-end and back-end development. Lee spends her spare time developing web and mobile apps. She is writing a cookbook for O'Reilly about Sencha Touch.

Ext JS提供了大量的功能来使类的创建和处理变得简单，还提供了一系列的功能来扩展和重新现有的Javascript类。这意味着可以为类添加行为和创建属于自己的类，或者重写某些函数的行为。在本文，将展示如何实现特定主题类的重写。

可能你已经知道如何创建Ext JS类的重写。例如，希望改变默认行为或修补框架。在这种情况下，可以使用以下代码来创建类的重写：

Ext.define('SomeClassName', {
    override : 'Ext.panel.Panel'
                                                                                                                                                   
    //the override: by default, all panels will have a 200px width
    width : 200
});

上面的代码带来的首个问题是：怎么命名这个重写的类，以及要将它放在哪里。有时候会需要为重写的类指定特定的主题。如果将这个javascript重写与自定义主题捆绑在一起，岂不是更好？例如，在自定义主题中，所有面板都会有阴影。又或者，创建了一个很棒的CSS3动画用于打开弹出窗口的时候。不幸的是，老版本的IE不能处理CSS3，因此需要一个备用的javascript。在这两种情况下，默认功能的改变是可见的，因此，怎样安排这些重写的文件结构，才不会破坏任何原有的主题呢？

这里的诀窍就是overrides文件夹。使用Sencha Cmd 3.1，使应用程序和包在overrides文件夹中保持类的重写成为可能。默认情况下，在生成（主题）包的时候，已经包含了这样一个文件，且已被设置为支撑重写。

下面来创建一个这样的javascript备用。这是一个简单的动画，在打开弹出窗口的时候会动画处理不透明度。

在主题包中创建以下文件结构（这里假设此宝的名称为MyTheme）：

packages
> MyTheme
> > overrides
> > > window
> > > > Window.js

文件结构对应了Ext.window.Window的框架文件结构。

下面来定义类：

Ext.define('MyTheme.window.Window', {
                                                                                                               
});

类将重写Ext.window.Window：

Ext.define('MyTheme.window.Window', {
    override : 'Ext.window.Window'
                                                                                                         
});

下面来测试一下重写工作。首先，在命令行运行以下命令：

sencha app refresh

到目前为止，之前的代码还没有改变任何功能，因此，这里将使用console log在类创建的时候输出一些信息，就可在浏览器进行测试了：

Ext.define('MyTheme.window.Window', {
    override : 'Ext.window.Window'
                                                                                            
}, function(){
    console.log("Oh yes, my override works!");
});

下面来创建自定义行为。这里的重写会在监听窗口的beforeshow事件时添加一个动画：

listeners: {
    beforeshow: function(mywindow){
                                                                                    
    }
}

在beforeshow监听中要创建一个新的动画（Ext.fx.Anim），因而需要添加对该类的引用：

requires: ['Ext.fx.Anim'],

下一步，要在beforeshow事件中添加创建动画的代码。现在，创建一个非常简单的动画，在显示窗口（mywindow）时将不透明度（opacity）从隐藏平滑的过渡到100%：

Ext.create('Ext.fx.Anim', {
    target: mywindow, //argument of the beforeshow event
    duration: 1000, //ms
    from: {
        opacity: 0
    },
    to: {
        opacity: 1
    }
});

现在，看可以测试一下动画是否能工作了。


非常糟糕的是，下面要创建的CSS3动画只支持现代浏览器。因此，需要做一个判断，只有在IE（IE9或更低）是旧版本的时候才执行这个Ext JS动画。

if(Ext.isIE9m) {
                                               
}

确保代码如以下所示：

Ext.define('MyTheme.window.Window', {
    override : 'Ext.window.Window',
                                        
    requires: ['Ext.fx.Anim'],
    closeAction: 'hide',
    listeners: {
        beforeshow: function(mywindow){
                                        
            if(Ext.isIE9m) {
                Ext.create('Ext.fx.Anim', {
                    target: mywindow,
                    duration: 1000,
                    from: {
                        opacity: 0
                    },
                    to: {
                        opacity: 1
                    }
                });
            }
        }
    }
});

这里唯一的问题是，对于CSS3动画，需要使用Sass代码，为此，需要使用到Compass。

在主题包，要在packages/MyTheme/sass/src/window/Window.scss文件中添加以下Sass代码。下面的代码与javascript文件中的代码的效果是相同的。

@import "compass/css3/transition";
                               
.x-window.x-hide-offsets {
    @include opacity(0);
}
                               
.x-window {
    @include single-transition(opacity, 1000ms);
    @include opacity(1);
}

需要将Sass样式表编译到生产使用的CSS代码中。由于这包含在Sencha Cmd和Sencha的生成过程中，所以在使用Sencha Cmd生成应用程序时2，Sass样式表会自动编译。

现在，还不需要生成整个应用程序，只需要快速测试动画，因而只编译一下样式表就行了。要实现这个，在命令行运行以下命令就行了：

sencha ant sass

或者

sencha app watch

第一个命令会运行Apache Ant任何来编译一次Sass。第二个命令功能更强大，不过它要求下载并安装Java开发工具包7。可以对比一下sencha app watch和Compass命令compass watch。Sencha Cmd会监视应用程序，每当但单击保存的时候，Sencha Cmd就会编译应用程序并编译Sass样式表。当改变被检测到的时候，只会执行最低限度的工作，以便更新应用程序和CSS，并重新生成Sass。

瞧……动画已经可以在旧和新的浏览器中工作了。。

如果想聊更多的高级Ext JS主题技术，请关注Ext JS高级主题课程。通过查阅http://www.sencha.com/training/来参加遍布世界各地的高级主题课程。