Touch 2.0.2 Sencha Docs

Ext.app.Application

Hierarchy

Ext.Base
Ext.app.Controller
Ext.app.Application

Inherited mixins

Requires

Files

Ext.app.Application defines the set of Models, Controllers, Profiles, Stores and Views that an application consists of. It automatically loads all of those dependencies and can optionally specify a launch function that will be called when everthing is ready.

Sample usage:

Ext.application({
    name: 'MyApp',

    models: ['User', 'Group'],
    stores: ['Users'],
    controllers: ['Users'],
    views: ['Main', 'ShowUser'],

    launch: function() {
        Ext.create('MyApp.view.Main');
    }
});

Creating an Application instance is the only time in Sencha Touch 2 that we don't use Ext.create to create the new instance. Instead, the Ext.application function instantiates an Ext.app.Application internally, automatically loading the Ext.app.Application class if it is not present on the page already and hooking in to Ext.onReady before creating the instance itself. An alternative is to use Ext.create inside an Ext.onReady callback, but Ext.application is preferred.

Dependencies

Application follows a simple convention when it comes to specifying the controllers, views, models, stores and profiles it requires. By default it expects each of them to be found inside the app/controller, app/view, app/model, app/store and app/profile directories in your app - if you follow this convention you can just specify the last part of each class name and Application will figure out the rest for you:

Ext.application({
    name: 'MyApp',

    controllers: ['Users'],
    models: ['User', 'Group'],
    stores: ['Users'],
    views: ['Main', 'ShowUser']
});

The example above will load 6 files:

  • app/model/User.js
  • app/model/Group.js
  • app/store/Users.js
  • app/controller/Users.js
  • app/view/Main.js
  • app/view/ShowUser.js

Nested Dependencies

For larger apps it's common to split the models, views and controllers into subfolders so keep the project organized. This is especially true of views - it's not unheard of for large apps to have over a hundred separate view classes so organizing them into folders can make maintenance much simpler.

To specify dependencies in subfolders just use a period (".") to specify the folder:

Ext.application({
    name: 'MyApp',

    controllers: ['Users', 'nested.MyController'],
    views: ['products.Show', 'products.Edit', 'user.Login']
});

In this case these 5 files will be loaded:

  • app/controller/Users.js
  • app/controller/nested/MyController.js
  • app/view/products/Show.js
  • app/view/products/Edit.js
  • app/view/user/Login.js

Note that we can mix and match within each configuration here - for each model, view, controller, profile or store you can specify either just the final part of the class name (if you follow the directory conventions), or the full class name.

External Dependencies

Finally, we can specify application dependencies from outside our application by fully-qualifying the classes we want to load. A common use case for this is sharing authentication logic between multiple applications. Perhaps you have several apps that login via a common user database and you want to share that code between them. An easy way to do this is to create a folder alongside your app folder and then add its contents as dependencies for your app.

For example, let's say our shared login code contains a login controller, a user model and a login form view. We want to use all of these in our application:

Ext.Loader.setPath({
    'Auth': 'Auth'
});

Ext.application({
    views: ['Auth.view.LoginForm', 'Welcome'],
    controllers: ['Auth.controller.Sessions', 'Main'],
    models: ['Auth.model.User']
});

This will load the following files:

  • Auth/view/LoginForm.js
  • Auth/controller/Sessions.js
  • Auth/model/User.js
  • app/view/Welcome.js
  • app/controller/Main.js

The first three were loaded from outside our application, the last two from the application itself. Note how we can still mix and match application files and external dependency files.

Note that to enable the loading of external dependencies we just have to tell the Loader where to find those files, which is what we do with the Ext.Loader.setPath call above. In this case we're telling the Loader to find any class starting with the 'Auth' namespace inside our 'Auth' folder. This means we can drop our common Auth code into our application alongside the app folder and the framework will be able to figure out how to load everything.

Launching

Each Application can define a launch function, which is called as soon as all of your app's classes have been loaded and the app is ready to be launched. This is usually the best place to put any application startup logic, typically creating the main view structure for your app.

In addition to the Application launch function, there are two other places you can put app startup logic. Firstly, each Controller is able to define an init function, which is called before the Application launch function. Secondly, if you are using Device Profiles, each Profile can define a launch function, which is called after the Controller init functions but before the Application launch function.

Note that only the active Profile has its launch function called - for example if you define profiles for Phone and Tablet and then launch the app on a tablet, only the Tablet Profile's launch function is called.

  1. Controller#init functions called
  2. Profile#launch function called
  3. Application#launch function called
  4. Controller#launch functions called

When using Profiles it is common to place most of the bootup logic inside the Profile launch function because each Profile has a different set of views that need to be constructed at startup.

Adding to Home Screen

iOS devices allow your users to add your app to their home screen for easy access. iOS allows you to customize several aspects of this, including the icon that will appear on the home screen and the startup image. These can be specified in the Ext.application setup block:

Ext.application({
    name: 'MyApp',

    icon: 'resources/img/icon.png',
    glossOnIcon: false,
    phoneStartupScreen: 'resources/img/phone_startup.png',
    tabletStartupScreen: 'resources/img/tablet_startup.png'
});

When the user adds your app to the home screen, your resources/img/icon.png file will be used as the application icon. We also used the glossOnIcon configuration to turn off the gloss effect that is automatically added to icons in iOS. Finally we used the phoneStartupScreen and tabletStartupScreen configurations to provide the images that will be displayed while your application is starting up. See also phoneIcon, tabletIcon and statusBarStyle.

Find out more

If you are not already familiar with writing applications with Sencha Touch 2 we recommend reading the intro to applications guide, which lays out the core principles of writing apps with Sencha Touch 2.

Available since: 2.0.0

Defined By

Config options

Ext.app.Application
view source
: String
The path to the directory which contains all application's classes. ...

The path to the directory which contains all application's classes. This path will be registered via Ext.Loader.setPath for the namespace specified in the name config. Defaults to 'app'

Defaults to: 'app'

Available since: 2.0.0

The Application instance this Controller is attached to. ...

The Application instance this Controller is attached to. This is automatically provided when using the MVC architecture so should rarely need to be set directly.

Defaults to: {}

Available since: 2.0.0

Provides a mapping of Controller functions to filter functions that are run before them when dispatched to from a route. ...

Provides a mapping of Controller functions to filter functions that are run before them when dispatched to from a route. These are usually used to run pre-processing functions like authentication before a certain function is executed. They are only called when dispatching from a route. Example usage:

Ext.define('MyApp.controller.Products', {
    config: {
        before: {
            editProduct: 'authenticate'
        },

        routes: {
            'product/edit/:id': 'editProduct'
        }
    },

    //this is not directly because our before filter is called first
    editProduct: function() {
        //... performs the product editing logic
    },

    //this is run before editProduct
    authenticate: function(action) {
        MyApp.authenticate({
            success: function() {
                action.resume();
            },
            failure: function() {
                Ext.Msg.alert('Not Logged In', "You can't do that, you're not logged in");
            }
        });
    }
});

Defaults to: {}

Available since: 2.0.0

The event name to bubble, or an Array of event names.

The event name to bubble, or an Array of event names.

Available since: 2.0.0

Provides a mapping of Controller functions that should be called whenever certain Component events are fired. ...

Provides a mapping of Controller functions that should be called whenever certain Component events are fired. The Components can be specified using ComponentQuery selectors or refs. Example usage:

control: {
    'button[action=logout]': {
        tap: 'doLogout'
    },
    main: {
        activeitemchange: 'doUpdate'
    }
}

The first item uses a ComponentQuery selector to run the Controller's doLogout function whenever any Button with action=logout is tapped on. The second calls the Controller's doUpdate function whenever the activeitemchange event is fired by the Component referenced by our 'main' ref. In this case main is a tab panel (see refs for how to set that reference up).

Defaults to: {}

Available since: 2.0.0

Ext.app.Application
view source
: Arrayprivate
Used internally as the collection of instantiated controllers. ...

Used internally as the collection of instantiated controllers. Use getController instead

Defaults to: []

Available since: 2.0.0

Ext.app.Application
view source
: Array
The set of controllers to load for this Application. ...

The set of controllers to load for this Application. Each controller is expected to exist inside the app/controller directory and define a class following the convention AppName.controller.ControllerName. For example, in the code below, the classes AppName.controller.Users, AppName.controller.Groups and AppName.controller.Products will be loaded. Note that we are able to specify either the full class name (as with AppName.controller.Products) or just the final part of the class name and leave Application to automatically prepend AppName.controller.’ to each:

controllers: [
    'Users',
    'Groups',
    'AppName.controller.Products',
    'SomeCustomNamespace.controller.Orders'
]

Defaults to: []

Available since: 2.0.0

The Profile that is currently active for the Application. ...

The Profile that is currently active for the Application. This is set once, automatically by the Application before launch. Read only.

Available since: 2.0.0

Ext.app.Application
view source
: Booleanprivate
Private config to disable loading of Profiles at application construct time. ...

Private config to disable loading of Profiles at application construct time. This is used by Sencha's unit test suite to test Application.js in isolation and is likely to be removed in favor of a more pleasing solution by the time you use it.

Defaults to: true

Available since: 2.0.0

Ext.app.Application
view source
: Boolean

If set to false, the 'gloss' effect added to home screen icons on iOS devices will be removed.

If set to false, the 'gloss' effect added to home screen icons on iOS devices will be removed.

Available since: 2.0.0

Ext.app.Application
view source
: Ext.app.History
The global History instance attached to this Application. ...

The global History instance attached to this Application. Read only

Defaults to: {}

Available since: 2.0.0

Ext.app.Application
view source
: String/Object
Path to the .png image file to use when your app is added to the home screen on an iOS device. ...

Path to the .png image file to use when your app is added to the home screen on an iOS device. When passed in as a String, the same icon will be used for both phone and tablet devices. When passed as an abject, you can specify different sizes like so:

icon: {
   57: 'resources/icons/icon.png',
   72: 'resources/icons/icon-72.png',
   114: 'resources/icons/icon-114.png'
}

To set different icons for tablets and phones see the tabletIcon and phoneIcon configs.

Available since: 2.0.0

Called by the Controller's application to initialize the Controller. ...

Called by the Controller's application to initialize the Controller. This is always called before the Application launches, giving the Controller a chance to run any pre-launch logic. See also launch, which is called after the Application's launch function

Available since: 2.0.0

Ext.app.Application
view source
: Function
An optional function that will be called when the Application is ready to be launched. ...

An optional function that will be called when the Application is ready to be launched. This is normally used to render any initial UI required by your application

Available since: 2.0.0

Overrides: Ext.app.Controller.launch

A config object containing one or more event handlers to be added to this object during initialization. ...

A config object containing one or more event handlers to be added to this object during initialization. This should be a valid listeners config object as specified in the addListener example for attaching multiple handlers at once.

See the Event guide for more

Note it is bad practice to specify a listeners config when you are defining a class using Ext.define. Instead, only specify listeners when you are instantiating your class with Ext.create.

Available since: 1.1.0

The set of models to load for this Application. ...

The set of models to load for this Application. Each model is expected to exist inside the app/model directory and define a class following the convention AppName.model.ModelName. For example, in the code below, the classes AppName.model.User, AppName.model.Group and AppName.model.Product will be loaded. Note that we are able to specify either the full class name (as with AppName.model.Product) or just the final part of the class name and leave Application to automatically prepend AppName.model. to each:

models: [
    'User',
    'Group',
    'AppName.model.Product',
    'SomeCustomNamespace.model.Order'
]

Defaults to: []

Available since: 2.0.0

Ext.app.Application
view source
: String
The name of the Application. ...

The name of the Application. This should be a single word without spaces or periods because it is used as the Application's global namespace. All classes in your application should be namespaced undef the Application's name - for example if your application name is 'MyApp', your classes should be named 'MyApp.model.User', 'MyApp.controller.Users', 'MyApp.view.Main' etc

Available since: 2.0.0

Ext.app.Application
view source
: String

Path to the .png image file to use when your app is added to the home screen on an iOS phone device (iPhone or iPod).

Path to the .png image file to use when your app is added to the home screen on an iOS phone device (iPhone or iPod).

Available since: 2.0.0

Path to the .png image file that will be displayed while the app is starting up once it has been added to the home sc...

Path to the .png image file that will be displayed while the app is starting up once it has been added to the home screen of an iOS phone device (iPhone or iPod). This .png file should be 320px wide and 460px high.

Available since: 2.0.0

Ext.app.Application
view source
: Arrayprivate
Used internally as the collection of instantiated profiles ...

Used internally as the collection of instantiated profiles

Defaults to: []

Available since: 2.0.0

Ext.app.Application
view source
: Array
The set of profiles to load for this Application. ...

The set of profiles to load for this Application. Each profile is expected to exist inside the app/profile directory and define a class following the convention AppName.profile.ProfileName. For example, in the code below, the classes AppName.profile.Phone and AppName.profile.Tablet will be loaded. Note that we are able to specify either the full class name (as with AppName.profile.Tablet) or just the final part of the class name and leave Application to automatically prepend AppName.profile.’ to each:

profiles: [
    'Phone',
    'AppName.profile.Tablet',
    'SomeCustomNamespace.profile.Desktop'
]

Defaults to: []

Available since: 2.0.0

A collection of named ComponentQuery selectors that makes it easy to get references to key Components on your page. ...

A collection of named ComponentQuery selectors that makes it easy to get references to key Components on your page. Example usage:

refs: {
    main: '#mainTabPanel',
    loginButton: '#loginWindow button[action=login]',

    infoPanel: {
        selector: 'infopanel',
        xtype: 'infopanel',
        autoCreate: true
    }
}

The first two are simple ComponentQuery selectors, the third (infoPanel) also passes in the autoCreate and xtype options, which will first run the ComponentQuery to see if a Component matching that selector exists on the page. If not, it will automatically create one using the xtype provided:

someControllerFunction: function() {
    //if the info panel didn't exist before, calling its getter will instantiate
    //it automatically and return the new instance
    this.getInfoPanel().show();
}

Defaults to: {}

Available since: 2.0.0

Ext.app.Application
view source
: Boolean
An array of extra dependencies, to be required after this application's name config has been processed properly, but ...

An array of extra dependencies, to be required after this application's name config has been processed properly, but before anything else to ensure overrides get executed first

Defaults to: []

Available since: 2.0.0

Ext.app.Application
view source
: Ext.app.Router
The global Router instance attached to this Application. ...

The global Router instance attached to this Application. Read only.

Defaults to: {}

Available since: 2.0.0

Provides a mapping of urls to Controller actions. ...

Provides a mapping of urls to Controller actions. Whenever the specified url is matched in the address bar, the specified Controller action is called. Example usage:

routes: {
    'login': 'showLogin',
    'users/:id': 'showUserById'
}

The first route will match against http://myapp.com/#login and call the Controller's showLogin function. The second route contains a wildcard (':id') and will match all urls like http://myapp.com/#users/123, calling the showUserById function with the matched ID as the first argument.

Defaults to: {}

Available since: 2.0.0

Ext.app.Application
view source
: String
Allows you to set the style of the status bar when your app is added to the home screen on iOS devices. ...

Allows you to set the style of the status bar when your app is added to the home screen on iOS devices. Defaults to 'black'. Alternative is to set to 'black-translucent', which turns the status bar semi-transparent and overlaps the app content. This is usually not a good option for web apps

Available since: 2.0.0

The set of stores to load for this Application. ...

The set of stores to load for this Application. Each store is expected to exist inside the app/store directory and define a class following the convention AppName.store.StoreName. For example, in the code below, the AppName.store.Users class will be loaded. Note that we are able to specify either the full class name (as with AppName.store.Groups) or just the final part of the class name and leave Application to automatically prepend AppName.store.’ to each:

stores: [
    'Users',
    'AppName.store.Groups',
    'SomeCustomNamespace.store.Orders'
]

Defaults to: []

Available since: 2.0.0

Ext.app.Application
view source
: String

Path to the .png image file to use when your app is added to the home screen on an iOS tablet device (iPad).

Path to the .png image file to use when your app is added to the home screen on an iOS tablet device (iPad).

Available since: 2.0.0

Path to the .png image file that will be displayed while the app is starting up once it has been added to the home sc...

Path to the .png image file that will be displayed while the app is starting up once it has been added to the home screen of an iOS tablet device (iPad). This .png file should be 768px wide and 1004px high.

Available since: 2.0.0

The set of views to load for this Application. ...

The set of views to load for this Application. Each view is expected to exist inside the app/view directory and define a class following the convention AppName.view.ViewName. For example, in the code below, the classes AppName.view.Users, AppName.view.Groups and AppName.view.Products will be loaded. Note that we are able to specify either the full class name (as with AppName.view.Products) or just the final part of the class name and leave Application to automatically prepend AppName.view. to each:

views: [
    'Users',
    'Groups',
    'AppName.view.Products',
    'SomeCustomNamespace.view.Orders'
]

Defaults to: []

Available since: 2.0.0

Properties

Defined By

Instance properties

...

Defaults to: 'ext-'

Available since: 2.0.0

...

Defaults to: '-'

Available since: 2.0.0

...

Defaults to: /\.|[^\w\-]/g

Available since: 2.0.0

...

Defaults to: true

Available since: 2.0.0

...

Defaults to: true

Available since: 1.1.0

...

Defaults to: /^(?:delegate|single|delay|buffer|args|prepend)$/

Available since: 2.0.0

...

Defaults to: {id: 'observable', hooks: {destroy: 'destroy'}}

Available since: 2.0.0

...

Defaults to: 'identifiable'

Available since: 2.0.0

...

Defaults to: '#'

Available since: 2.0.0

...

Defaults to: 'observable'

Available since: 2.0.0

Get the reference to the current class from which this object was instantiated. ...

Get the reference to the current class from which this object was instantiated. Unlike statics, this.self is scope-dependent and it's meant to be used for dynamic inheritance. See statics for a detailed comparison

Ext.define('My.Cat', {
    statics: {
        speciesName: 'Cat' // My.Cat.speciesName = 'Cat'
    },

    constructor: function() {
        alert(this.self.speciesName); / dependentOL on 'this'
    },

    clone: function() {
        return new this.self();
    }
});


Ext.define('My.SnowLeopard', {
    extend: 'My.Cat',
    statics: {
        speciesName: 'Snow Leopard'         // My.SnowLeopard.speciesName = 'Snow Leopard'
    }
});

var cat = new My.Cat();                     // alerts 'Cat'
var snowLeopard = new My.SnowLeopard();     // alerts 'Snow Leopard'

var clone = snowLeopard.clone();
alert(Ext.getClassName(clone));             // alerts 'My.SnowLeopard'

Available since: 2.0.0

...

Defaults to: /^([\w\-]+)$/

Available since: 2.0.0

Defined By

Static properties

...

Defaults to: []

Available since: 2.0.0

Methods

Defined By

Instance methods

Ext.app.Application
view source
new( config ) : Ext.app.Application
Constructs a new Application instance ...

Constructs a new Application instance

Available since: 2.0.0

Parameters

Returns

Fires

    Overrides: Ext.app.Controller.constructor

    ( eventName, fn, [scope], [options] )
    Appends an after-event handler. ...

    Appends an after-event handler.

    Same as addListener with order set to 'after'.

    Available since: 2.0.0

    Parameters

    • eventName : String

      The name of the event to listen for.

    • fn : Function

      The method the event invokes.

    • scope : Object (optional)

      The scope for fn.

    • options : Object (optional)

      An object containing handler configuration.

    Fires

      ( eventName, fn, [scope], [options] )
      Appends a before-event handler. ...

      Appends a before-event handler. Returning false from the handler will stop the event.

      Same as addListener with order set to 'before'.

      Available since: 2.0.0

      Parameters

      • eventName : String

        The name of the event to listen for.

      • fn : Function

        The method the event invokes.

      • scope : Object (optional)

        The scope for fn.

      • options : Object (optional)

        An object containing handler configuration.

      Fires

        ( selector, name, fn, scope, options, order )private
        ...

        Available since: 2.0.0

        Parameters

        Fires

          Adds the specified events to the list of events which this Observable may fire. ...

          Adds the specified events to the list of events which this Observable may fire.

          Available since: 1.1.0

          This method has been deprecated since 2.0

          It's no longer needed to add events before firing.

          Parameters

          • eventNames : Object/String...

            Either an object with event names as properties with a value of true or the first event name string if multiple event names are being passed as separate parameters.

          ( eventName, fn, [scope], [options], [order] )
          Appends an event handler to this object. ...

          Appends an event handler to this object. You can review the available handlers by looking at the 'events' section of the documentation for the component you are working with.

          Combining Options

          Using the options argument, it is possible to combine different types of listeners:

          A delayed, one-time listener:

          container.on('tap', this.handleTap, this, {
              single: true,
              delay: 100
          });
          

          Attaching multiple handlers in 1 call

          The method also allows for a single argument to be passed which is a config object containing properties which specify multiple events. For example:

          container.on({
              tap  : this.onTap,
              swipe: this.onSwipe,
          
              scope: this // Important. Ensure "this" is correct during handler execution
          });
          

          One can also specify options for each event handler separately:

          container.on({
              tap  : { fn: this.onTap, scope: this, single: true },
              swipe: { fn: button.onSwipe, scope: button }
          });
          

          See the Events Guide for more.

          Available since: 1.1.0

          Parameters

          • eventName : String

            The name of the event to listen for. May also be an object who's property names are event names.

          • fn : Function

            The method the event invokes. Will be called with arguments given to fireEvent plus the options parameter described below.

          • scope : Object (optional)

            The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

          • options : Object (optional)

            An object containing handler configuration.

            This object may contain any of the following properties:

            • scope : Object

              The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

            • delay : Number

              The number of milliseconds to delay the invocation of the handler after the event fires.

            • single : Boolean

              True to add a handler to handle just the next firing of the event, and then remove itself.

            • order : String

              The order of when the listener should be added into the listener queue.

              If you set an order of before and the event you are listening to is preventable, you can return false and it will stop the event.

              Available options are before, current and after. Defaults to current.

            • buffer : Number

              Causes the handler to be delayed by the specified number of milliseconds. If the event fires again within that time, the original handler is not invoked, but the new handler is scheduled in its place.

            • element : String

              Allows you to add a listener onto a element of this component using the elements reference.

              Ext.create('Ext.Component', {
                  listeners: {
                      element: 'element',
                      tap: function() {
                          console.log('element tap!');
                      }
                  }
              });
              

              All components have the element reference, which is the outer most element of the component. Ext.Container also has the innerElement element which contains all children. In most cases element is adequate.

            • delegate : String

              Uses Ext.ComponentQuery to delegate events to a specified query selector within this item.

              // Create a container with a two children; a button and a toolbar
              var container = Ext.create('Ext.Container', {
                  items: [
                      {
                         xtype: 'toolbar',
                         docked: 'top',
                         title: 'My Toolbar'
                      },
                      {
                         xtype: 'button',
                         text: 'My Button'
                      }
                  ]
              });
              
              container.on({
                  // Ext.Buttons have an xtype of 'button', so we use that are a selector for our delegate
                  delegate: 'button',
              
                  tap: function() {
                      alert('Button tapped!');
                  }
              });
              
          • order : String (optional)

            The order of when the listener should be added into the listener queue. Possible values are before, current and after.

            Defaults to: 'current'

          Fires

            ( object, eventName, [fn], [scope], [options] )deprecated
            Adds listeners to any Observable object (or Element) which are automatically removed when this Component is destroyed. ...

            Adds listeners to any Observable object (or Element) which are automatically removed when this Component is destroyed.

            Available since: 1.1.0

            This method has been deprecated since 2.0

            All listeners are now automatically managed where necessary. Simply use addListener.

            Parameters

            • object : Ext.mixin.Observable/HTMLElement

              The item to which to add a listener/listeners.

            • eventName : Object/String

              The event name, or an object containing event name properties.

            • fn : Function (optional)

              If the eventName parameter was an event name, this is the handler function.

            • scope : Object (optional)

              If the eventName parameter was an event name, this is the scope in which the handler function is executed.

            • options : Object (optional)

              If the eventName parameter was an event name, this is the addListener options.

            Massages the before filters into an array of function references for each controller action ...

            Massages the before filters into an array of function references for each controller action

            Available since: 2.0.0

            Parameters

            ...

            Available since: 2.0.0

            Parameters

            Fires

              ...

              Available since: 2.0.0

              Parameters

              Fires

                Ext.app.Application
                view source
                ( controllers )private
                As a convenience developers can locally qualify controller names (e.g. ...

                As a convenience developers can locally qualify controller names (e.g. 'MyController' vs 'MyApp.controller.MyController'). This just makes sure everything ends up fully qualified

                Available since: 2.0.0

                Parameters

                Fires

                  Ext.app.Application
                  view source
                  ( config )private
                  ...

                  Available since: 2.0.0

                  Parameters

                  Fires

                    ...

                    Available since: 2.0.0

                    Parameters

                    Fires

                      As a convenience developers can locally qualify model names (e.g. ...

                      As a convenience developers can locally qualify model names (e.g. 'MyModel' vs 'MyApp.model.MyModel'). This just makes sure everything ends up fully qualified

                      Available since: 2.0.0

                      Parameters

                      Fires

                        Ext.app.Application
                        view source
                        ( name )private
                        Checks that the name configuration has any whitespace, and trims them if found. ...

                        Checks that the name configuration has any whitespace, and trims them if found.

                        Available since: 2.0.0

                        Parameters

                        Ext.app.Application
                        view source
                        ( profiles )private
                        As a convenience developers can locally qualify profile names (e.g. ...

                        As a convenience developers can locally qualify profile names (e.g. 'MyProfile' vs 'MyApp.profile.MyProfile'). This just makes sure everything ends up fully qualified

                        Available since: 2.0.0

                        Parameters

                        Fires

                          ...

                          Available since: 2.0.0

                          Parameters

                          Fires

                            Ext.app.Application
                            view source
                            ( config )private
                            ...

                            Available since: 2.0.0

                            Parameters

                            Fires

                              Adds any routes specified in this Controller to the global Application router ...

                              Adds any routes specified in this Controller to the global Application router

                              Available since: 2.0.0

                              Parameters

                              Fires

                                As a convenience developers can locally qualify store names (e.g. ...

                                As a convenience developers can locally qualify store names (e.g. 'MyStore' vs 'MyApp.store.MyStore'). This just makes sure everything ends up fully qualified

                                Available since: 2.0.0

                                Parameters

                                Fires

                                  As a convenience developers can locally qualify view names (e.g. ...

                                  As a convenience developers can locally qualify view names (e.g. 'MyView' vs 'MyApp.view.MyView'). This just makes sure everything ends up fully qualified

                                  Available since: 2.0.0

                                  Parameters

                                  Fires

                                    Call the original method that was previously overridden with override Ext.define('My.Cat', { constructor: functi...

                                    Call the original method that was previously overridden with override

                                    Ext.define('My.Cat', {
                                        constructor: function() {
                                            alert("I'm a cat!");
                                        }
                                    });
                                    
                                    My.Cat.override({
                                        constructor: function() {
                                            alert("I'm going to be a cat!");
                                    
                                            var instance = this.callOverridden();
                                    
                                            alert("Meeeeoooowwww");
                                    
                                            return instance;
                                        }
                                    });
                                    
                                    var kitty = new My.Cat(); // alerts "I'm going to be a cat!"
                                                              // alerts "I'm a cat!"
                                                              // alerts "Meeeeoooowwww"
                                    

                                    Available since: 2.0.0

                                    Parameters

                                    • args : Array/Arguments

                                      The arguments, either an array or the arguments object from the current method, for example: this.callOverridden(arguments)

                                    Returns

                                    • Object

                                      Returns the result of calling the overridden method

                                    Call the "parent" method of the current method. ...

                                    Call the "parent" method of the current method. That is the method previously overridden by derivation or by an override (see Ext.define).

                                     Ext.define('My.Base', {
                                         constructor: function (x) {
                                             this.x = x;
                                         },
                                    
                                         statics: {
                                             method: function (x) {
                                                 return x;
                                             }
                                         }
                                     });
                                    
                                     Ext.define('My.Derived', {
                                         extend: 'My.Base',
                                    
                                         constructor: function () {
                                             this.callParent([21]);
                                         }
                                     });
                                    
                                     var obj = new My.Derived();
                                    
                                     alert(obj.x);  // alerts 21
                                    

                                    This can be used with an override as follows:

                                     Ext.define('My.DerivedOverride', {
                                         override: 'My.Derived',
                                    
                                         constructor: function (x) {
                                             this.callParent([x*2]); // calls original My.Derived constructor
                                         }
                                     });
                                    
                                     var obj = new My.Derived();
                                    
                                     alert(obj.x);  // now alerts 42
                                    

                                    This also works with static methods.

                                     Ext.define('My.Derived2', {
                                         extend: 'My.Base',
                                    
                                         statics: {
                                             method: function (x) {
                                                 return this.callParent([x*2]); // calls My.Base.method
                                             }
                                         }
                                     });
                                    
                                     alert(My.Base.method(10);     // alerts 10
                                     alert(My.Derived2.method(10); // alerts 20
                                    

                                    Lastly, it also works with overridden static methods.

                                     Ext.define('My.Derived2Override', {
                                         override: 'My.Derived2',
                                    
                                         statics: {
                                             method: function (x) {
                                                 return this.callParent([x*2]); // calls My.Derived2.method
                                             }
                                         }
                                     });
                                    
                                     alert(My.Derived2.method(10); // now alerts 40
                                    

                                    Available since: 2.0.0

                                    Parameters

                                    • args : Array/Arguments

                                      The arguments, either an array or the arguments object from the current method, for example: this.callParent(arguments)

                                    Returns

                                    • Object

                                      Returns the result of calling the parent method

                                    ( operation, eventName, fn, scope, options, order )private
                                    ...

                                    Available since: 2.0.0

                                    Parameters

                                    Removes all listeners for this object. ...

                                    Removes all listeners for this object.

                                    Available since: 1.1.0

                                    Fires

                                      ...

                                      Available since: 1.1.0

                                      Parameters

                                      Fires

                                        Ext.app.Application
                                        view source
                                        ( selectors, controller )private
                                        (documented on Controller's control config) ...

                                        (documented on Controller's control config)

                                        Available since: 2.0.0

                                        Parameters

                                        Fires

                                          Overrides: Ext.app.Controller.control

                                          ...

                                          Available since: 2.0.0

                                          Parameters

                                          Fires

                                            Creates an event handling function which refires the event from this object as the passed event name. ...

                                            Creates an event handling function which refires the event from this object as the passed event name.

                                            Available since: 2.0.0

                                            Parameters

                                            Returns

                                            Fires

                                              ...

                                              Available since: 2.0.0

                                              Fires

                                              • destroy

                                              Overrides: Ext.Base.destroy

                                              Ext.app.Application
                                              view source
                                              ( action, addToHistory )
                                              Dispatches a given Ext.app.Action to the relevant Controller instance. ...

                                              Dispatches a given Ext.app.Action to the relevant Controller instance. This is not usually called directly by the developer, instead Sencha Touch's History support picks up on changes to the browser's url and calls dispatch automatically.

                                              Available since: 2.0.0

                                              Parameters

                                              • action : Ext.app.Action

                                                The action to dispatch

                                              • addToHistory : Boolean

                                                True by default, sets the browser's url to the action's url

                                              Fires

                                                ( name, fn, scope, options )private
                                                ...

                                                Available since: 2.0.0

                                                Parameters

                                                Fires

                                                  ( eventName, args, action, connectedController )private
                                                  ...

                                                  Available since: 2.0.0

                                                  Parameters

                                                  Fires

                                                    ( name, fn, scope, options, order )private
                                                    ...

                                                    Available since: 2.0.0

                                                    Parameters

                                                    Fires

                                                      Enables events fired by this Observable to bubble up an owner hierarchy by calling this.getBubbleTarget() if present. ...

                                                      Enables events fired by this Observable to bubble up an owner hierarchy by calling this.getBubbleTarget() if present. There is no implementation in the Observable base class.

                                                      Available since: 1.1.0

                                                      Parameters

                                                      • events : String/String[]

                                                        The event name to bubble, or an Array of event names.

                                                      Fires

                                                        ( action, skipFilters )private
                                                        Executes an Ext.app.Action by giving it the correct before filters and kicking off execution ...

                                                        Executes an Ext.app.Action by giving it the correct before filters and kicking off execution

                                                        Available since: 2.0.0

                                                        Parameters

                                                        Fires

                                                          ( eventName, args, fn, scope )
                                                          Fires the specified event with the passed parameters and execute a function (action) at the end if there are no liste...

                                                          Fires the specified event with the passed parameters and execute a function (action) at the end if there are no listeners that return false.

                                                          Available since: 2.0.0

                                                          Parameters

                                                          • eventName : String

                                                            The name of the event to fire.

                                                          • args : Array

                                                            Arguments to pass to handers

                                                          • fn : Function

                                                            Action

                                                          • scope : Object

                                                            scope of fn

                                                          Fires

                                                            Fires the specified event with the passed parameters (minus the event name, plus the options object passed to addList...

                                                            Fires the specified event with the passed parameters (minus the event name, plus the options object passed to addListener).

                                                            The first argument is the name of the event. Every other argument passed will be available when you listen for the event.

                                                            Example

                                                            Firstly, we set up a listener for our new event.

                                                            this.on('myevent', function(arg1, arg2, arg3, arg4, options, e) {
                                                                console.log(arg1); // true
                                                                console.log(arg2); // 2
                                                                console.log(arg3); // { test: 'foo' }
                                                                console.log(arg4); // 14
                                                                console.log(options); // the options added when adding the listener
                                                                console.log(e); // the event object with information about the event
                                                            });
                                                            

                                                            And then we can fire off the event.

                                                            this.fireEvent('myevent', true, 2, { test: 'foo' }, 14);
                                                            

                                                            An event may be set to bubble up an Observable parent hierarchy by calling enableBubble.

                                                            Available since: 1.1.0

                                                            Parameters

                                                            • eventName : String

                                                              The name of the event to fire.

                                                            • args : Object...

                                                              Variable number of parameters are passed to handlers.

                                                            Returns

                                                            • Boolean

                                                              returns false if any of the handlers return false otherwise it returns true.

                                                            Fires

                                                              Ext.app.Application
                                                              view source
                                                              ( )private
                                                              Gathers up all of the previously computed MVCS dependencies into a single array that we can pass to Ext.require ...

                                                              Gathers up all of the previously computed MVCS dependencies into a single array that we can pass to Ext.require

                                                              Available since: 2.0.0

                                                              Fires

                                                                Ext.app.Application
                                                                view source
                                                                ( ) : String
                                                                Returns the value of appFolder. ...

                                                                Returns the value of appFolder.

                                                                Available since: 2.0.0

                                                                Returns

                                                                Returns the value of application. ...

                                                                Returns the value of application.

                                                                Available since: 2.0.0

                                                                Returns

                                                                Returns the value of before. ...

                                                                Returns the value of before.

                                                                Available since: 2.0.0

                                                                Returns

                                                                Returns the value of bubbleEvents. ...

                                                                Returns the value of bubbleEvents.

                                                                Available since: 2.0.0

                                                                Returns

                                                                ...

                                                                Available since: 2.0.0

                                                                ...

                                                                Available since: 2.0.0

                                                                Parameters

                                                                Returns the value of control. ...

                                                                Returns the value of control.

                                                                Available since: 2.0.0

                                                                Returns

                                                                Ext.app.Application
                                                                view source
                                                                ( name, profileName )private
                                                                Returns the Controller instance for the given controller name ...

                                                                Returns the Controller instance for the given controller name

                                                                Available since: 2.0.0

                                                                Parameters

                                                                • name : String

                                                                  The name of the Controller

                                                                • profileName : String

                                                                  Optional profile name. If passed, this is the same as calling getController('profileName.controllerName')

                                                                Fires

                                                                  Overrides: Ext.app.Controller.getController

                                                                  Ext.app.Application
                                                                  view source
                                                                  ( ) : Arrayprivate
                                                                  Returns the value of controllerInstances. ...

                                                                  Returns the value of controllerInstances.

                                                                  Available since: 2.0.0

                                                                  Returns

                                                                  Ext.app.Application
                                                                  view source
                                                                  ( ) : Array
                                                                  Returns the value of controllers. ...

                                                                  Returns the value of controllers.

                                                                  Available since: 2.0.0

                                                                  Returns

                                                                  ...

                                                                  Available since: 2.0.0

                                                                  Returns the value of currentProfile. ...

                                                                  Returns the value of currentProfile.

                                                                  Available since: 2.0.0

                                                                  Returns

                                                                  Ext.app.Application
                                                                  view source
                                                                  ( ) : Booleanprivate
                                                                  Returns the value of enableLoader. ...

                                                                  Returns the value of enableLoader.

                                                                  Available since: 2.0.0

                                                                  Returns

                                                                  ...

                                                                  Available since: 2.0.0

                                                                  Fires

                                                                    Returns the fully qualified name for any class name variant. ...

                                                                    Returns the fully qualified name for any class name variant. This is used to find the FQ name for the model, view, controller, store and profiles listed in a Controller or Application.

                                                                    Available since: 2.0.0

                                                                    Parameters

                                                                    • items : String[]

                                                                      The array of strings to get the FQ name for

                                                                    • namespace : String

                                                                      If the name happens to be an application class, add it to this namespace

                                                                    Returns

                                                                    • String

                                                                      The fully-qualified name of the class

                                                                    Fires

                                                                      Ext.app.Application
                                                                      view source
                                                                      ( ) : Ext.app.History
                                                                      Returns the value of history. ...

                                                                      Returns the value of history.

                                                                      Available since: 2.0.0

                                                                      Returns

                                                                      Retrieves the id of this component. ...

                                                                      Retrieves the id of this component. Will autogenerate an id if one has not already been set.

                                                                      Available since: 2.0.0

                                                                      Returns

                                                                      Fires

                                                                        Returns the initial configuration passed to constructor. ...

                                                                        Returns the initial configuration passed to constructor.

                                                                        Available since: 2.0.0

                                                                        Parameters

                                                                        • name : String (optional)

                                                                          When supplied, value for particular configuration option is returned, otherwise the full config object is returned.

                                                                        Returns

                                                                        Ext.app.Application
                                                                        view source
                                                                        ( ) : Function
                                                                        Returns the value of launch. ...

                                                                        Returns the value of launch.

                                                                        Available since: 2.0.0

                                                                        Returns

                                                                        Returns the value of listeners. ...

                                                                        Returns the value of listeners.

                                                                        Available since: 2.0.0

                                                                        Returns

                                                                        ...

                                                                        Available since: 2.0.0

                                                                        Parameters

                                                                        Returns a reference to a Model. ...

                                                                        Returns a reference to a Model.

                                                                        Available since: 2.0.0

                                                                        This method has been deprecated since 2.0.0

                                                                        Considered bad practice - please just use the Model name instead (e.g. MyApp.model.User vs this.getModel('User')).

                                                                        Parameters

                                                                        Fires

                                                                          Returns the value of models. ...

                                                                          Returns the value of models.

                                                                          Available since: 2.0.0

                                                                          Returns

                                                                          Ext.app.Application
                                                                          view source
                                                                          ( ) : String
                                                                          Returns the value of name. ...

                                                                          Returns the value of name.

                                                                          Available since: 2.0.0

                                                                          Returns

                                                                          ...

                                                                          Available since: 2.0.0

                                                                          Fires

                                                                            ...

                                                                            Available since: 2.0.0

                                                                            ...

                                                                            Available since: 2.0.0

                                                                            Ext.app.Application
                                                                            view source
                                                                            ( ) : Arrayprivate
                                                                            Returns the value of profileInstances. ...

                                                                            Returns the value of profileInstances.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            Ext.app.Application
                                                                            view source
                                                                            ( ) : Array
                                                                            Returns the value of profiles. ...

                                                                            Returns the value of profiles.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            ( ref, info, config )private
                                                                            ...

                                                                            Available since: 2.0.0

                                                                            Parameters

                                                                            Returns the value of refs. ...

                                                                            Returns the value of refs.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            Ext.app.Application
                                                                            view source
                                                                            ( ) : Boolean
                                                                            Returns the value of requires. ...

                                                                            Returns the value of requires.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            Ext.app.Application
                                                                            view source
                                                                            ( ) : Ext.app.Router
                                                                            Returns the value of router. ...

                                                                            Returns the value of router.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            Returns the value of routes. ...

                                                                            Returns the value of routes.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            Returns the value of stores. ...

                                                                            Returns the value of stores.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            ...

                                                                            Available since: 2.0.0

                                                                            ...

                                                                            Available since: 2.0.0

                                                                            Returns the value of views. ...

                                                                            Returns the value of views.

                                                                            Available since: 2.0.0

                                                                            Returns

                                                                            ...

                                                                            Available since: 2.0.0

                                                                            Parameters

                                                                            Checks to see if this object has any listeners for a specified event ...

                                                                            Checks to see if this object has any listeners for a specified event

                                                                            Available since: 1.1.0

                                                                            Parameters

                                                                            • eventName : String

                                                                              The name of the event to check for

                                                                            Returns

                                                                            • Boolean

                                                                              True if the event is being listened for, else false

                                                                            Fires

                                                                              ...

                                                                              Available since: 2.0.0

                                                                              Parameters

                                                                              ( instanceConfig ) : Objectchainableprotected
                                                                              Initialize configuration for this class. ...

                                                                              Initialize configuration for this class. a typical example:

                                                                              Ext.define('My.awesome.Class', {
                                                                                  // The default config
                                                                                  config: {
                                                                                      name: 'Awesome',
                                                                                      isAwesome: true
                                                                                  },
                                                                              
                                                                                  constructor: function(config) {
                                                                                      this.initConfig(config);
                                                                                  }
                                                                              });
                                                                              
                                                                              var awesome = new My.awesome.Class({
                                                                                  name: 'Super Awesome'
                                                                              });
                                                                              
                                                                              alert(awesome.getName()); // 'Super Awesome'
                                                                              

                                                                              Available since: 2.0.0

                                                                              Parameters

                                                                              Returns

                                                                              • Object

                                                                                mixins The mixin prototypes as key - value pairs

                                                                              Fires

                                                                                Ext.app.Application
                                                                                view source
                                                                                ( )private
                                                                                Called once all of our controllers have been loaded ...

                                                                                Called once all of our controllers have been loaded

                                                                                Available since: 2.0.0

                                                                                Fires

                                                                                  Ext.app.Application
                                                                                  view source
                                                                                  ( )private
                                                                                  Should be called after dependencies are loaded, instantiates all of the Stores specified in the stores config. ...

                                                                                  Should be called after dependencies are loaded, instantiates all of the Stores specified in the stores config. For each item in the stores array we make sure the Store is instantiated. When strings are specified, the corresponding app/store/StoreName.js was loaded so we now instantiate a MyApp.store.StoreName, giving it the id StoreName.

                                                                                  Available since: 2.0.0

                                                                                  Fires

                                                                                    Ext.app.Application
                                                                                    view source
                                                                                    ( )private
                                                                                    Controllers can also specify dependencies, so we grab them all here and require them ...

                                                                                    Controllers can also specify dependencies, so we grab them all here and require them

                                                                                    Available since: 2.0.0

                                                                                    Fires

                                                                                      ( object, eventName, [fn], [scope], [options] )deprecated
                                                                                      Alias for addManagedListener. ...

                                                                                      Alias for addManagedListener.

                                                                                      Available since: 2.0.0

                                                                                      This method has been deprecated since 2.0.0

                                                                                      This is now done automatically

                                                                                      Parameters

                                                                                      • object : Ext.mixin.Observable/HTMLElement

                                                                                        The item to which to add a listener/listeners.

                                                                                      • eventName : Object/String

                                                                                        The event name, or an object containing event name properties.

                                                                                      • fn : Function (optional)

                                                                                        If the eventName parameter was an event name, this is the handler function.

                                                                                      • scope : Object (optional)

                                                                                        If the eventName parameter was an event name, this is the scope in which the handler function is executed.

                                                                                      • options : Object (optional)

                                                                                        If the eventName parameter was an event name, this is the addListener options.

                                                                                      ( object, eventName, [fn], [scope] )deprecated
                                                                                      Alias for removeManagedListener. ...

                                                                                      Alias for removeManagedListener.

                                                                                      Available since: 2.0.0

                                                                                      This method has been deprecated since 2.0.0

                                                                                      This is now done automatically

                                                                                      Parameters

                                                                                      • object : Ext.mixin.Observable/HTMLElement

                                                                                        The item to which to add a listener/listeners.

                                                                                      • eventName : Object/String

                                                                                        The event name, or an object containing event name properties.

                                                                                      • fn : Function (optional)

                                                                                        If the eventName parameter was an event name, this is the handler function.

                                                                                      • scope : Object (optional)

                                                                                        If the eventName parameter was an event name, this is the scope in which the handler function is executed.

                                                                                      ( eventName, fn, [scope], [options], [order] )
                                                                                      Alias for addListener. ...

                                                                                      Alias for addListener.

                                                                                      Available since: 1.1.0

                                                                                      Parameters

                                                                                      • eventName : String

                                                                                        The name of the event to listen for. May also be an object who's property names are event names.

                                                                                      • fn : Function

                                                                                        The method the event invokes. Will be called with arguments given to fireEvent plus the options parameter described below.

                                                                                      • scope : Object (optional)

                                                                                        The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

                                                                                      • options : Object (optional)

                                                                                        An object containing handler configuration.

                                                                                        This object may contain any of the following properties:

                                                                                        • scope : Object

                                                                                          The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

                                                                                        • delay : Number

                                                                                          The number of milliseconds to delay the invocation of the handler after the event fires.

                                                                                        • single : Boolean

                                                                                          True to add a handler to handle just the next firing of the event, and then remove itself.

                                                                                        • order : String

                                                                                          The order of when the listener should be added into the listener queue.

                                                                                          If you set an order of before and the event you are listening to is preventable, you can return false and it will stop the event.

                                                                                          Available options are before, current and after. Defaults to current.

                                                                                        • buffer : Number

                                                                                          Causes the handler to be delayed by the specified number of milliseconds. If the event fires again within that time, the original handler is not invoked, but the new handler is scheduled in its place.

                                                                                        • element : String

                                                                                          Allows you to add a listener onto a element of this component using the elements reference.

                                                                                          Ext.create('Ext.Component', {
                                                                                              listeners: {
                                                                                                  element: 'element',
                                                                                                  tap: function() {
                                                                                                      console.log('element tap!');
                                                                                                  }
                                                                                              }
                                                                                          });
                                                                                          

                                                                                          All components have the element reference, which is the outer most element of the component. Ext.Container also has the innerElement element which contains all children. In most cases element is adequate.

                                                                                        • delegate : String

                                                                                          Uses Ext.ComponentQuery to delegate events to a specified query selector within this item.

                                                                                          // Create a container with a two children; a button and a toolbar
                                                                                          var container = Ext.create('Ext.Container', {
                                                                                              items: [
                                                                                                  {
                                                                                                     xtype: 'toolbar',
                                                                                                     docked: 'top',
                                                                                                     title: 'My Toolbar'
                                                                                                  },
                                                                                                  {
                                                                                                     xtype: 'button',
                                                                                                     text: 'My Button'
                                                                                                  }
                                                                                              ]
                                                                                          });
                                                                                          
                                                                                          container.on({
                                                                                              // Ext.Buttons have an xtype of 'button', so we use that are a selector for our delegate
                                                                                              delegate: 'button',
                                                                                          
                                                                                              tap: function() {
                                                                                                  alert('Button tapped!');
                                                                                              }
                                                                                          });
                                                                                          
                                                                                      • order : String (optional)

                                                                                        The order of when the listener should be added into the listener queue. Possible values are before, current and after.

                                                                                        Defaults to: 'current'

                                                                                      ( eventName, fn, [scope], [options] )
                                                                                      Alias for addAfterListener. ...

                                                                                      Alias for addAfterListener.

                                                                                      Available since: 2.0.0

                                                                                      Parameters

                                                                                      • eventName : String

                                                                                        The name of the event to listen for.

                                                                                      • fn : Function

                                                                                        The method the event invokes.

                                                                                      • scope : Object (optional)

                                                                                        The scope for fn.

                                                                                      • options : Object (optional)

                                                                                        An object containing handler configuration.

                                                                                      ( eventName, fn, [scope], [options] )
                                                                                      Alias for addBeforeListener. ...

                                                                                      Alias for addBeforeListener.

                                                                                      Available since: 2.0.0

                                                                                      Parameters

                                                                                      • eventName : String

                                                                                        The name of the event to listen for.

                                                                                      • fn : Function

                                                                                        The method the event invokes.

                                                                                      • scope : Object (optional)

                                                                                        The scope for fn.

                                                                                      • options : Object (optional)

                                                                                        An object containing handler configuration.

                                                                                      ...

                                                                                      Available since: 2.0.0

                                                                                      Parameters

                                                                                      Fires

                                                                                        Overrides: Ext.mixin.Mixin.onClassExtended

                                                                                        ( names, callback, scope )private
                                                                                        ...

                                                                                        Available since: 2.0.0

                                                                                        Parameters

                                                                                        Ext.app.Application
                                                                                        view source
                                                                                        ( )private
                                                                                        Callback that is invoked when all of the Application, Controller and Profile dependencies have been loaded. ...

                                                                                        Callback that is invoked when all of the Application, Controller and Profile dependencies have been loaded. Launches the controllers, then the profile and application

                                                                                        Available since: 2.0.0

                                                                                        Fires

                                                                                          Ext.app.Application
                                                                                          view source
                                                                                          ( url )private
                                                                                          ...

                                                                                          Available since: 2.0.0

                                                                                          Parameters

                                                                                          Fires

                                                                                            Ext.app.Application
                                                                                            view source
                                                                                            ( )private
                                                                                            Callback that is invoked when all of the configured Profiles have been loaded. ...

                                                                                            Callback that is invoked when all of the configured Profiles have been loaded. Detects the current profile and gathers any additional dependencies from that profile, then loads all of those dependencies.

                                                                                            Available since: 2.0.0

                                                                                            Fires

                                                                                              Ext.app.Application
                                                                                              view source
                                                                                              ( url )
                                                                                              Redirects the browser to the given url. ...

                                                                                              Redirects the browser to the given url. This only affects the url after the #. You can pass in either a String or a Model instance - if a Model instance is defined its toUrl function is called, which returns a string representing the url for that model. Internally, this uses your application's Router to decode the url into a matching controller action and then calls dispatch.

                                                                                              Available since: 2.0.0

                                                                                              Parameters

                                                                                              Fires

                                                                                                Overrides: Ext.app.Controller.redirectTo

                                                                                                1.x-inspired ref implementation ...

                                                                                                1.x-inspired ref implementation

                                                                                                Available since: 2.0.0

                                                                                                Parameters

                                                                                                ...

                                                                                                Available since: 2.0.0

                                                                                                Parameters

                                                                                                Fires

                                                                                                  Relays selected events from the specified Observable as if the events were fired by this. ...

                                                                                                  Relays selected events from the specified Observable as if the events were fired by this.

                                                                                                  Available since: 1.1.0

                                                                                                  Parameters

                                                                                                  • object : Object

                                                                                                    The Observable whose events this object is to relay.

                                                                                                  • events : String/Array/Object

                                                                                                    Array of event names to relay.

                                                                                                  Returns

                                                                                                  Fires

                                                                                                    ( eventName, fn, [scope], [options] )
                                                                                                    Removes a before-event handler. ...

                                                                                                    Removes a before-event handler.

                                                                                                    Same as removeListener with order set to 'after'.

                                                                                                    Available since: 2.0.0

                                                                                                    Parameters

                                                                                                    • eventName : String

                                                                                                      The name of the event the handler was associated with.

                                                                                                    • fn : Function

                                                                                                      The handler to remove.

                                                                                                    • scope : Object (optional)

                                                                                                      The scope originally specified for fn.

                                                                                                    • options : Object (optional)

                                                                                                      Extra options object.

                                                                                                    Fires

                                                                                                      ( eventName, fn, [scope], [options] )
                                                                                                      Removes a before-event handler. ...

                                                                                                      Removes a before-event handler.

                                                                                                      Same as removeListener with order set to 'before'.

                                                                                                      Available since: 2.0.0

                                                                                                      Parameters

                                                                                                      • eventName : String

                                                                                                        The name of the event the handler was associated with.

                                                                                                      • fn : Function

                                                                                                        The handler to remove.

                                                                                                      • scope : Object (optional)

                                                                                                        The scope originally specified for fn.

                                                                                                      • options : Object (optional)

                                                                                                        Extra options object.

                                                                                                      Fires

                                                                                                        ( selector, name, fn, scope, order )private
                                                                                                        ...

                                                                                                        Available since: 2.0.0

                                                                                                        Parameters

                                                                                                        Fires

                                                                                                          ( eventName, fn, [scope], [options], [order] )
                                                                                                          Removes an event handler. ...

                                                                                                          Removes an event handler.

                                                                                                          Available since: 1.1.0

                                                                                                          Parameters

                                                                                                          • eventName : String

                                                                                                            The type of event the handler was associated with.

                                                                                                          • fn : Function

                                                                                                            The handler to remove. This must be a reference to the function passed into the addListener call.

                                                                                                          • scope : Object (optional)

                                                                                                            The scope originally specified for the handler. It must be the same as the scope argument specified in the original call to addListener or the listener will not be removed.

                                                                                                          • options : Object (optional)

                                                                                                            Extra options object. See addListener for details.

                                                                                                          • order : String (optional)

                                                                                                            The order of the listener to remove. Possible values are before, current and after.

                                                                                                            Defaults to: 'current'

                                                                                                          Fires

                                                                                                            ( object, eventName, [fn], [scope] )deprecated
                                                                                                            Adds listeners to any Observable object (or Element) which are automatically removed when this Component is destroyed. ...

                                                                                                            Adds listeners to any Observable object (or Element) which are automatically removed when this Component is destroyed.

                                                                                                            Available since: 1.1.0

                                                                                                            This method has been deprecated since 2.0

                                                                                                            All listeners are now automatically managed where necessary. Simply use removeListener.

                                                                                                            Parameters

                                                                                                            • object : Ext.mixin.Observable/HTMLElement

                                                                                                              The item to which to add a listener/listeners.

                                                                                                            • eventName : Object/String

                                                                                                              The event name, or an object containing event name properties.

                                                                                                            • fn : Function (optional)

                                                                                                              If the eventName parameter was an event name, this is the handler function.

                                                                                                            • scope : Object (optional)

                                                                                                              If the eventName parameter was an event name, this is the scope in which the handler function is executed.

                                                                                                            Resumes firing events (see suspendEvents). ...

                                                                                                            Resumes firing events (see suspendEvents).

                                                                                                            If events were suspended using the queueSuspended parameter, then all events fired during event suspension will be sent to any listeners now.

                                                                                                            Available since: 1.1.0

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( appFolder )
                                                                                                            Sets the value of appFolder. ...

                                                                                                            Sets the value of appFolder.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of application. ...

                                                                                                            Sets the value of application.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of before. ...

                                                                                                            Sets the value of before.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of bubbleEvents. ...

                                                                                                            Sets the value of bubbleEvents.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            ( config, applyIfNotSet ) : Ext.Basechainableprivate
                                                                                                            ...

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Returns

                                                                                                            Sets the value of control. ...

                                                                                                            Sets the value of control.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( controllerInstances )private
                                                                                                            Sets the value of controllerInstances. ...

                                                                                                            Sets the value of controllerInstances.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            • controllerInstances : Array
                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( controllers )
                                                                                                            Sets the value of controllers. ...

                                                                                                            Sets the value of controllers.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( currentProfile )
                                                                                                            Sets the value of currentProfile. ...

                                                                                                            Sets the value of currentProfile.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( enableLoader )private
                                                                                                            Sets the value of enableLoader. ...

                                                                                                            Sets the value of enableLoader.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( history )
                                                                                                            Sets the value of history. ...

                                                                                                            Sets the value of history.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            ...

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( launch )
                                                                                                            Sets the value of launch. ...

                                                                                                            Sets the value of launch.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of listeners. ...

                                                                                                            Sets the value of listeners.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of models. ...

                                                                                                            Sets the value of models.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( name )
                                                                                                            Sets the value of name. ...

                                                                                                            Sets the value of name.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( profileInstances )private
                                                                                                            Sets the value of profileInstances. ...

                                                                                                            Sets the value of profileInstances.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            • profileInstances : Array
                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( profiles )
                                                                                                            Sets the value of profiles. ...

                                                                                                            Sets the value of profiles.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of refs. ...

                                                                                                            Sets the value of refs.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( requires )
                                                                                                            Sets the value of requires. ...

                                                                                                            Sets the value of requires.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( router )
                                                                                                            Sets the value of router. ...

                                                                                                            Sets the value of router.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of routes. ...

                                                                                                            Sets the value of routes.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of stores. ...

                                                                                                            Sets the value of stores.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Sets the value of views. ...

                                                                                                            Sets the value of views.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Get the reference to the class from which this object was instantiated. ...

                                                                                                            Get the reference to the class from which this object was instantiated. Note that unlike self, this.statics() is scope-independent and it always returns the class from which it was called, regardless of what this points to during run-time

                                                                                                            Ext.define('My.Cat', {
                                                                                                                statics: {
                                                                                                                    totalCreated: 0,
                                                                                                                    speciesName: 'Cat' // My.Cat.speciesName = 'Cat'
                                                                                                                },
                                                                                                            
                                                                                                                constructor: function() {
                                                                                                                    var statics = this.statics();
                                                                                                            
                                                                                                                    alert(statics.speciesName);     // always equals to 'Cat' no matter what 'this' refers to
                                                                                                                                                    // equivalent to: My.Cat.speciesName
                                                                                                            
                                                                                                                    alert(this.self.speciesName);   // dependent on 'this'
                                                                                                            
                                                                                                                    statics.totalCreated++;
                                                                                                                },
                                                                                                            
                                                                                                                clone: function() {
                                                                                                                    var cloned = new this.self;                      // dependent on 'this'
                                                                                                            
                                                                                                                    cloned.groupName = this.statics().speciesName;   // equivalent to: My.Cat.speciesName
                                                                                                            
                                                                                                                    return cloned;
                                                                                                                }
                                                                                                            });
                                                                                                            
                                                                                                            
                                                                                                            Ext.define('My.SnowLeopard', {
                                                                                                                extend: 'My.Cat',
                                                                                                            
                                                                                                                statics: {
                                                                                                                    speciesName: 'Snow Leopard'     // My.SnowLeopard.speciesName = 'Snow Leopard'
                                                                                                                },
                                                                                                            
                                                                                                                constructor: function() {
                                                                                                                    this.callParent();
                                                                                                                }
                                                                                                            });
                                                                                                            
                                                                                                            var cat = new My.Cat();                 // alerts 'Cat', then alerts 'Cat'
                                                                                                            
                                                                                                            var snowLeopard = new My.SnowLeopard(); // alerts 'Cat', then alerts 'Snow Leopard'
                                                                                                            
                                                                                                            var clone = snowLeopard.clone();
                                                                                                            alert(Ext.getClassName(clone));         // alerts 'My.SnowLeopard'
                                                                                                            alert(clone.groupName);                 // alerts 'Cat'
                                                                                                            
                                                                                                            alert(My.Cat.totalCreated);             // alerts 3
                                                                                                            

                                                                                                            Available since: 2.0.0

                                                                                                            Returns

                                                                                                            Suspends the firing of all events. ...

                                                                                                            Suspends the firing of all events. (see resumeEvents)

                                                                                                            Available since: 1.1.0

                                                                                                            Parameters

                                                                                                            • queueSuspended : Boolean

                                                                                                              Pass as true to queue up suspended events to be fired after the resumeEvents call instead of discarding all suspended events.

                                                                                                            ( eventName, fn, [scope], [options], [order] )
                                                                                                            Alias for removeListener. ...

                                                                                                            Alias for removeListener.

                                                                                                            Available since: 1.1.0

                                                                                                            Parameters

                                                                                                            • eventName : String

                                                                                                              The type of event the handler was associated with.

                                                                                                            • fn : Function

                                                                                                              The handler to remove. This must be a reference to the function passed into the addListener call.

                                                                                                            • scope : Object (optional)

                                                                                                              The scope originally specified for the handler. It must be the same as the scope argument specified in the original call to addListener or the listener will not be removed.

                                                                                                            • options : Object (optional)

                                                                                                              Extra options object. See addListener for details.

                                                                                                            • order : String (optional)

                                                                                                              The order of the listener to remove. Possible values are before, current and after.

                                                                                                              Defaults to: 'current'

                                                                                                            ( eventName, fn, [scope], [options] )
                                                                                                            Alias for removeAfterListener. ...

                                                                                                            Alias for removeAfterListener.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            • eventName : String

                                                                                                              The name of the event the handler was associated with.

                                                                                                            • fn : Function

                                                                                                              The handler to remove.

                                                                                                            • scope : Object (optional)

                                                                                                              The scope originally specified for fn.

                                                                                                            • options : Object (optional)

                                                                                                              Extra options object.

                                                                                                            ( eventName, fn, [scope], [options] )
                                                                                                            Alias for removeBeforeListener. ...

                                                                                                            Alias for removeBeforeListener.

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            • eventName : String

                                                                                                              The name of the event the handler was associated with.

                                                                                                            • fn : Function

                                                                                                              The handler to remove.

                                                                                                            • scope : Object (optional)

                                                                                                              The scope originally specified for fn.

                                                                                                            • options : Object (optional)

                                                                                                              Extra options object.

                                                                                                            Ext.app.Application
                                                                                                            view source
                                                                                                            ( newName )private
                                                                                                            Makes sure the app namespace exists, sets the app property of the namespace to this application and sets its loading ...

                                                                                                            Makes sure the app namespace exists, sets the app property of the namespace to this application and sets its loading path (checks to make sure the path hadn't already been set via Ext.Loader.setPath)

                                                                                                            Available since: 2.0.0

                                                                                                            Parameters

                                                                                                            Fires

                                                                                                              Defined By

                                                                                                              Static methods

                                                                                                              ( config, fullMerge )privatestatic
                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( members )chainableprivatestatic
                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( name, member )chainableprivatestatic
                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( members )chainablestatic
                                                                                                              Add methods / properties to the prototype of this class. ...

                                                                                                              Add methods / properties to the prototype of this class.

                                                                                                              Ext.define('My.awesome.Cat', {
                                                                                                                  constructor: function() {
                                                                                                                      ...
                                                                                                                  }
                                                                                                              });
                                                                                                              
                                                                                                               My.awesome.Cat.implement({
                                                                                                                   meow: function() {
                                                                                                                      alert('Meowww...');
                                                                                                                   }
                                                                                                               });
                                                                                                              
                                                                                                               var kitty = new My.awesome.Cat;
                                                                                                               kitty.meow();
                                                                                                              

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( members ) : Ext.Basechainablestatic
                                                                                                              Add / override static properties of this class. ...

                                                                                                              Add / override static properties of this class.

                                                                                                              Ext.define('My.cool.Class', {
                                                                                                                  ...
                                                                                                              });
                                                                                                              
                                                                                                              My.cool.Class.addStatics({
                                                                                                                  someProperty: 'someValue',      // My.cool.Class.someProperty = 'someValue'
                                                                                                                  method1: function() { ... },    // My.cool.Class.method1 = function() { ... };
                                                                                                                  method2: function() { ... }     // My.cool.Class.method2 = function() { ... };
                                                                                                              });
                                                                                                              

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              Returns

                                                                                                              ( xtype )chainableprivatestatic
                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( fromClass, members ) : Ext.Basechainableprivatestatic
                                                                                                              Borrow another class' members to the prototype of this class. ...

                                                                                                              Borrow another class' members to the prototype of this class.

                                                                                                              Ext.define('Bank', {
                                                                                                                  money: '$$$',
                                                                                                                  printMoney: function() {
                                                                                                                      alert('$$$$$$$');
                                                                                                                  }
                                                                                                              });
                                                                                                              
                                                                                                              Ext.define('Thief', {
                                                                                                                  ...
                                                                                                              });
                                                                                                              
                                                                                                              Thief.borrow(Bank, ['money', 'printMoney']);
                                                                                                              
                                                                                                              var steve = new Thief();
                                                                                                              
                                                                                                              alert(steve.money); // alerts '$$$'
                                                                                                              steve.printMoney(); // alerts '$$$$$$$'
                                                                                                              

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              • fromClass : Ext.Base

                                                                                                                The class to borrow members from

                                                                                                              • members : Array/String

                                                                                                                The names of the members to borrow

                                                                                                              Returns

                                                                                                              ( args )privatestatic
                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              Create a new instance of this Class. ...

                                                                                                              Create a new instance of this Class.

                                                                                                              Ext.define('My.cool.Class', {
                                                                                                                  ...
                                                                                                              });
                                                                                                              
                                                                                                              My.cool.Class.create({
                                                                                                                  someConfig: true
                                                                                                              });
                                                                                                              

                                                                                                              All parameters are passed to the constructor of the class.

                                                                                                              Available since: 2.0.0

                                                                                                              Returns

                                                                                                              ( alias, origin )static
                                                                                                              Create aliases for existing prototype methods. ...

                                                                                                              Create aliases for existing prototype methods. Example:

                                                                                                              Ext.define('My.cool.Class', {
                                                                                                                  method1: function() { ... },
                                                                                                                  method2: function() { ... }
                                                                                                              });
                                                                                                              
                                                                                                              var test = new My.cool.Class();
                                                                                                              
                                                                                                              My.cool.Class.createAlias({
                                                                                                                  method3: 'method1',
                                                                                                                  method4: 'method2'
                                                                                                              });
                                                                                                              
                                                                                                              test.method3(); // test.method1()
                                                                                                              
                                                                                                              My.cool.Class.createAlias('method5', 'method3');
                                                                                                              
                                                                                                              test.method5(); // test.method3() -> test.method1()
                                                                                                              

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( parent )privatestatic
                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              Get the current class' name in string format. ...

                                                                                                              Get the current class' name in string format.

                                                                                                              Ext.define('My.cool.Class', {
                                                                                                                  constructor: function() {
                                                                                                                      alert(this.self.getName()); // alerts 'My.cool.Class'
                                                                                                                  }
                                                                                                              });
                                                                                                              
                                                                                                              My.cool.Class.getName(); // 'My.cool.Class'
                                                                                                              

                                                                                                              Available since: 2.0.0

                                                                                                              Returns

                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              ( name, mixinClass )privatestatic
                                                                                                              Used internally by the mixins pre-processor ...

                                                                                                              Used internally by the mixins pre-processor

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( fn, scope )chainableprivatestatic
                                                                                                              ...

                                                                                                              Available since: 2.0.0

                                                                                                              Parameters

                                                                                                              ( members ) : Ext.Basechainabledeprecatedstatic
                                                                                                              Override members of this class. ...

                                                                                                              Override members of this class. Overridden methods can be invoked via callParent.

                                                                                                              Ext.define('My.Cat', {
                                                                                                                  constructor: function() {
                                                                                                                      alert("I'm a cat!");
                                                                                                                  }
                                                                                                              });
                                                                                                              
                                                                                                              My.Cat.override({
                                                                                                                  constructor: function() {
                                                                                                                      alert("I'm going to be a cat!");
                                                                                                              
                                                                                                                      var instance = this.callParent(arguments);
                                                                                                              
                                                                                                                      alert("Meeeeoooowwww");
                                                                                                              
                                                                                                                      return instance;
                                                                                                                  }
                                                                                                              });
                                                                                                              
                                                                                                              var kitty = new My.Cat(); // alerts "I'm going to be a cat!"
                                                                                                                                        // alerts "I'm a cat!"
                                                                                                                                        // alerts "Meeeeoooowwww"
                                                                                                              

                                                                                                              As of 4.1, direct use of this method is deprecated. Use Ext.define instead:

                                                                                                              Ext.define('My.CatOverride', {
                                                                                                                  override: 'My.Cat',
                                                                                                                  constructor: function() {
                                                                                                                      alert("I'm going to be a cat!");
                                                                                                              
                                                                                                                      var instance = this.callParent(arguments);
                                                                                                              
                                                                                                                      alert("Meeeeoooowwww");
                                                                                                              
                                                                                                                      return instance;
                                                                                                                  }
                                                                                                              });
                                                                                                              

                                                                                                              The above accomplishes the same result but can be managed by the Ext.Loader which can properly order the override and its target class and the build process can determine whether the override is needed based on the required state of the target class (My.Cat).

                                                                                                              Available since: 2.0.0

                                                                                                              This method has been deprecated since 4.1.0

                                                                                                              Please use Ext.define instead

                                                                                                              Parameters

                                                                                                              • members : Object

                                                                                                                The properties to add to this class. This should be specified as an object literal containing one or more properties.

                                                                                                              Returns

                                                                                                              ...

                                                                                                              Available since: 2.0.0