X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/0494b8d9b9bb03ab6c22b34dae81261e3cd7e3e6..7a654f8d43fdb43d78b63d90528bed6e86b608cc:/docs/api/Ext.app.Application.html diff --git a/docs/api/Ext.app.Application.html b/docs/api/Ext.app.Application.html new file mode 100644 index 00000000..6c3f95f4 --- /dev/null +++ b/docs/api/Ext.app.Application.html @@ -0,0 +1,124 @@ +Ext.app.Application | Ext JS 4.0 Documentation +
For up to date documentation and features, visit +http://docs.sencha.com/ext-js/4-0

Sencha Documentation

+ + + + + +

Hierarchy

Ext.app.Controller
Ext.app.Application

Represents an Ext JS 4 application, which is typically a single page app using a Viewport. +A typical Ext.app.Application might look like this:

+ +
Ext.application({
+    name: 'MyApp',
+    launch: function() {
+        Ext.create('Ext.container.Viewport', {
+            items: {
+                html: 'My App'
+            }
+        });
+    }
+});
+
+ +

This does several things. First it creates a global variable called 'MyApp' - all of your Application's classes (such +as its Models, Views and Controllers) will reside under this single namespace, which drastically lowers the chances +of colliding global variables.

+ +

When the page is ready and all of your JavaScript has loaded, your Application's launch function is called, +at which time you can run the code that starts your app. Usually this consists of creating a Viewport, as we do in +the example above.

+ +

Telling Application about the rest of the app

+ +

Because an Ext.app.Application represents an entire app, we should tell it about the other parts of the app - namely +the Models, Views and Controllers that are bundled with the application. Let's say we have a blog management app; we +might have Models and Controllers for Posts and Comments, and Views for listing, adding and editing Posts and Comments. +Here's how we'd tell our Application about all these things:

+ +
Ext.application({
+    name: 'Blog',
+    models: ['Post', 'Comment'],
+    controllers: ['Posts', 'Comments'],
+
+    launch: function() {
+        ...
+    }
+});
+
+ +

Note that we didn't actually list the Views directly in the Application itself. This is because Views are managed by +Controllers, so it makes sense to keep those dependencies there. The Application will load each of the specified +Controllers using the pathing conventions laid out in the application +architecture guide - in this case expecting the controllers to reside in app/controller/Posts.js and +app/controller/Comments.js. In turn, each Controller simply needs to list the Views it uses and they will be +automatically loaded. Here's how our Posts controller like be defined:

+ +
Ext.define('MyApp.controller.Posts', {
+    extend: 'Ext.app.Controller',
+    views: ['posts.List', 'posts.Edit'],
+
+    //the rest of the Controller here
+});
+
+ +

Because we told our Application about our Models and Controllers, and our Controllers about their Views, Ext JS will +automatically load all of our app files for us. This means we don't have to manually add script tags into our html +files whenever we add a new class, but more importantly it enables us to create a minimized build of our entire +application using the Ext JS 4 SDK Tools.

+ +

For more information about writing Ext JS 4 applications, please see the +application architecture guide.

+
Defined By

Config Options

Other Configs

 
The path to the directory which contains all application's classes. +This path will be registered via Ext.Loader.setPa...

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'

+
 

Automatically loads and instantiates AppName.view.Viewport before firing the launch function.

+

Automatically loads and instantiates AppName.view.Viewport before firing the launch function.

+
 

When the app is first loaded, this url will be redirected to. Defaults to undefined

+

When the app is first loaded, this url will be redirected to. Defaults to undefined

+
 

True to automatically set up Ext.tip.QuickTip support (defaults to true)

+

True to automatically set up Ext.tip.QuickTip support (defaults to true)

+
 

The id of this controller. You can use this id when dispatching.

+

The id of this controller. You can use this id when dispatching.

+
 
The name of your application. This will also be the namespace for your views, controllers +models and stores. Don't us...

The name of your application. This will also be the namespace for your views, controllers +models and stores. Don't use spaces or special characters in the name.

+
 

The scope to execute the launch function in. Defaults to the Application +instance.

+

The scope to execute the launch function in. Defaults to the Application +instance.

+
Defined By

Properties

 
Called automatically when the page has completely loaded. This is an empty function that should be +overridden by each...

Called automatically when the page has completely loaded. This is an empty function that should be +overridden by each application that needs to take action on page load

+
Defined By

Methods

 

 

+

Returns

  • void    +
\ No newline at end of file