Changes between Version 2 and Version 3 of DeveloperGuidelines/EdenMobile/Routing

Timestamp:

03/30/17 11:59:11 (8 years ago)

Author:

Dominic König

Comment:

--

DeveloperGuidelines/EdenMobile/Routing

@@ -43 +43 @@
 The role of controllers and views is equivalent to controllers/views in the Sahana Eden web application.
 
-The view template is rendered once when the state is entered the first time (unless reloading is enforced in $state.go), and the state controller executed every time when the state is entered.
+The view template is rendered, and the state controller executed when the state is first entered (unless reloading is enforced in $state.go, then both would be reloaded).
+
+Unlike Sahana Eden view templates, though, placeholders in EdenMobile views are updated whenever the corresponding {{{$scope}}} attribute changes, e.g. a template
+
+{{{#!xml
+<!-- in the view: -->
+<h1>{{title}}</h1>
+}}}
+
+...would replace the ''title'' placeholder with the value of {{{$scope.title}}}, similar to Sahana Eden views. But when the controller later changes {{{$scope.title}}} (e.g. in response to an event):
+
+{{{
+// in the controller:
+$scope.title = 'Something Else';
+}}}
+
+...then this will also update the view (instantly, more or less). 
+
+Equally, view elements (e.g. inputs) can be bound to {{{$scope}}} attributes (using the {{{ng-model}}} directive), so that every change of the input value will be reflected instantly in the {{{$scope}}}, thereby making it available for the controller:
+
+{{{#!xml
+<!-- in the view: -->
+<input type="text" ng-model="firstName"/>
+}}}
+
+...can be accessed as:
+{{{#!js
+// in the controller:
+var firstName = $scope.firstName;
+}}}
+
+Besides data, the {{{$scope}}} object can also hold functions:
+
+{{{#!js
+// in the controller:
+$scope.buttonClicked = function() {
+  // Do something
+};
+}}}
+
+...which can then e.g. be used in the view as event handlers:
+
+{{{#!xml
+<!-- in the view -->
+<button type="button" ng-click="buttonClicked()"/>
+}}}
 
 State controllers live in the www/controllers folder, and view templates in www/views.