EXC | DEV | Documentation | Version 1.0

Working with views and the stage

This topic applies to the Front-End framework.

Stage

The stage is what we call the layout where we display your UI. A stage is made of multiple views through which the user navigates.

The object exc.stage provides the functionality to manage the views and handle the basic navigation between your views.

Showing a View

	exc.stage.show(aView, options);

Parameters

aView is an instance of a view object or a string with the name of an existing view.

options is a plain object with options. This parameter is optional.

Option	Description
'modal'	boolean, indicates if view is displayed as a modal panel. default value is false.
'push'	boolean, indicates if view is added to the navigation stack. default value is true.

The function exc.stage.show() displays a view on the stage and adds it to the navigation stack.

Closing the current View

	exc.stage.closeCurrent();

Closes the current view on the stage and pops the previous one into view.

Events & Messages

Event	Parameters	Description
`viewShouldClose`	stage message	Tells the controller that a request to remove a view form the stage was received.
`viewWillEnterStage`	stage message	Tells the controller that a request to add the view to the stage was received.
`viewDidEnterStage`	stage message	Tells the controller that a view is on the stage.
`viewWillClose`	`view`	Tells the controller that view is about to close.
`viewShow`	`view`	Tells the controller that view displayed.
`viewChanged`	`view`	Tells the controller that a view's contents changed.

Stage Message

The parameter of message handler for a stage message is just a plain object with the members stage and an optional view.

	viewShouldClose: function(msg){
		console.log("Stage: %o", msg.stage);
		console.log("View: %o", msg.view);
	}