Class: Controller

maria. Controller

new Controller()

A constructor function to create new controller objects.

Controller objects are usually created lazily on demand by a view object but you can create one explicitly. You might want to do this if you want to exercise the strategy pattern and dynamically change a view's controller.

var controller = new maria.Controller();

A controller object has a view object. The view will automatically sets itself as the controller's view when the view creates the controller or when view.setController is called with the controller. You can set the view object explicitely but you may never have a need to do this.

var view = new maria.View();
controller.setView(view);

You can get the controller's view object when needed and you will do this frequently in the methods of the controller.

controller.getView();

A controller object also has a model object. A controller-view pair will usually have the same model object and the view object will keep the controller object's model in sync with the view object's model object. The model is usually set automatically by the view when the view creates the controller or when view.setController is called with the controller. You can set the model object explicitely but you many never have a need to do this.

var model = new maria.Model();
controller.setModel(model);

You can get the controller's model object when needed and you will do this frequently in the methods of the controller.

controller.getModel();

A particularly useful pattern is using maria.Controller as the "superclass" of your application's controller. The following example shows how this can be done at a low level for a to-do application. See maria.Controller.subclass for a more compact way to accomplish the same.

checkit.TodoController = function() {
    maria.Controller.apply(this, arguments);
};
checkit.TodoController.superConstructor = maria.Controller;
checkit.TodoController.prototype = maria.create(maria.Controller.prototype);
checkit.TodoController.prototype.constructor = checkit.TodoController;
checkit.TodoController.prototype.onClickCheck = function() {
    this.getModel().toggleDone();
};
checkit.TodoController.prototype.onDblclickDisplay = function() {
    this.getView().showEdit();
};
checkit.TodoController.prototype.onKeyupInput = function() {
    var view = this.getView();
    if (checkit.isBlank(view.getInputValue())) {
        view.hideToolTip();
    } else {
        view.showToolTip();
    }
};
checkit.TodoController.prototype.onKeypressInput = function(evt) {
    if (evt.keyCode === 13) {
        this.onBlurInput();
    }
};
checkit.TodoController.prototype.onBlurInput = function() {
    var view = this.getView();
    var value = view.getInputValue();
    view.hideToolTip();
    view.showDisplay();
    if (!checkit.isBlank(value)) {
        this.getModel().setContent(value);
    }
};
Source:
  • maria.js, line 3221

Members

<static> superConstructor

Properties:
Name Type Description
maria.Controller.superConstructor
Source:
  • maria.js, line 3228

Methods

<static> subclass()

A function that makes subclassing maria.Controller more compact.

The following example creates a checkit.TodoController constructor function equivalent to the more verbose example shown in the documentation for maria.Controller.

maria.Controller.subclass(checkit, 'TodoController', {
    properties: {
        onClickCheck: function() {
            this.getModel().toggleDone();
        },
        onDblclickDisplay: function() {
            this.getView().showEdit();
        },
        onKeyupInput: function() {
            var view = this.getView();
            if (checkit.isBlank(view.getInputValue())) {
                view.hideToolTip();
            } else {
                view.showToolTip();
            }
        },
        onKeypressInput: function(evt) {
            if (evt.keyCode === 13) {
                this.onBlurInput();
            }
        },
        onBlurInput: function() {
            var view = this.getView();
            var value = view.getInputValue();
            view.hideToolTip();
            view.showDisplay();
            if (!checkit.isBlank(value)) {
                this.getModel().setContent(value);
            }
        }
    }
});
Source:
  • maria.js, line 3673

destroy()

The destroy method.

Source:
  • maria.js, line 3235

getModel() → {maria.Model}

Returns the current model object of the controller.

Source:
  • maria.js, line 3250
Returns:

The model object.

Type
maria.Model

getView() → {maria.View}

Returns the current view object of the controller.

Source:
  • maria.js, line 3275
Returns:

The view object.

Type
maria.View

setModel(model)

*Pretend you do not know that this method even exists. setModel is intended to be called only by the view _setModelAndController method. Do otherwise at your own risk!**

Parameters:
Name Type Description
model maria.Model

The model object.
Source:
  • maria.js, line 3264

setView(view)

*Pretend you do not know that this method even exists. setView is intended to be called only by the view _setModelAndController method. Do otherwise at your own risk!**

Parameters:
Name Type Description
view maria.View

The view object.
Source:
  • maria.js, line 3289