I've finally had some time to put Angular to use this week in a small project I'm working on for fun. Angular's routing is great and makes it real easy to map URL routes to controllers and model data into views. But what if you don't actually need a
view, if you effectively need a headless
controller that just runs code, but doesn't render a view?Preserve the ViewWhen Angular navigates a route and and presents a new
view, it loads the
controller and then renders the
view from scratch. Views are not cached or stored, but displayed and then removed. So if you have routes configured like this:'use strict';
// Declare app level module which depends on filters, and services
window.myApp = angular.module('myApp', ['myApp.filters', 'myApp.services', 'myApp.directives', 'myApp.controllers']).
config(['$routeProvider', function($routeProvider) {
$routeProvider.when('/map',
{
template: "partials/map.html ", controller: 'mapController',
reloadOnSearch: false,
animation: 'slide'
});
… $routeProvider.otherwise({redirectTo: '/map'});
}]);
Angular routes to the mapController and then re-renders the map.html template with the new data from the $scope filled in.But, but… I don't want a new View!Now in most cases this works just fine. If I'm rendering plain DOM content, or textboxes in a form interface that is all fine and dandy - it's perfectly fine to completely re-render the UI.But in some cases, the UI that's being managed has state and shouldn't be redrawn. In this case the main page in question has a Google Map on it. The map is going to be manipulated throughout the lifetime of the application and the rest of the pages. In my application I have a toolbar on the bottom and the rest of the content is replaced/switched out by the Angular Views:The problem is that the map shouldn't be redrawn each time the Location
view is activated. It should maintain its state, such as the current position selected (which can move), and shouldn't redraw due to the overhead of re-rendering the initial map.Originally I set up the map, exactly like all my other views - as a partial, that is rendered with a separate file, but that didn't work.The Workaround -
Controller Only RoutesThe workaround for this goes decidedly against Angular's way of doing things:Setting up a Template-less RouteIn-lining the map
view directly into the main pageHiding and showing the map
view manuallyLet's see how this works.
Controller Only RouteThe template-less route is basically a route that doesn't have any template to render. This is not directly supported by Angular, but thankfully easy to fake. The end goal here is that I want to simply have the
Controller fire and then have the
controller manage the display of the already active
view by hiding and showing the map and any other
view content, in effect bypassing Angular's
view display management.In short - I want a
controller action, but no
view rendering.The controller-only or template-less route looks like this: $routeProvider.when('/map',
{
template: " ", // just fire
controller
controller: 'mapController',
animation: 'slide'
});Notice I'm using the template property rather than templateUrl (used in the first example above), which allows specifying a string template, and leaving it blank. The template property basically allows you to provide a templated string using Angular's HandleBar like binding syntax which can be useful at times. You can use plain strings or strings with template code in the template, or as I'm doing here a blank string to essentially fake 'just clear the
view'. In-lined ViewSo if there's no
view where does the HTML go? Because I don't want Angular to manage the
view the map markup is in-lined directly into the page. So instead of rendering the map into the Angular
view container, the content is simply set up as inline HTML to display as a sibling to the
view container.<div id="MapContent" data-icon="LocationIcon"
ng-controller="mapController" style="display:none">
<div class="headerbar">
<div class="right-header" style="float:right">
<a id="btnShowSaveLocationDialog"
class="iconbutton btn btn-sm"
href="#/saveLocation" style="margin-right: 2px;">
<i class="icon-ok icon-2x" style="color: lightgreen; "></i>
Save Location
</a>
</div>
<div class="left-header">GeoCrumbs</div>
</div>
<div class="clearfix"></div>
<div id="Message">
<i id="MessageIcon"></i>
<span id="MessageText"></span>
</div>
<div id="Map" class="content-area">
</div>
</div>
<div id="ViewPlaceholder" ng-view></div>Note that there's the #MapContent element and the #ViewPlaceHolder. The #MapContent is my static map
view that is always 'live' and is initially hidden. It is initially hidden and doesn't get made visible until the MapController
controller activates it which does the initial rendering of the map. After that the element is persisted with the map data already loaded and any future access only updates the map with new locations/pins etc.Note that default route is assigned to the mapController, which means that the mapController is fired right as the page loads, which is actually a good thing in this case, as the map is the cornerstone of this app that is manipulated by some of the other controllers/views.The
Controller handles some UISince there's effectively no
view activation with the template-less route, the
controller unfortunately has to take over some UI interaction directly. Specifically it has to swap the hidden state between the map and any of the other views.Here's what the
controller looks like:myApp.controller('mapController', ["$scope", "$routeParams", "locationData",
function($scope, $routeParams, locationData) {
$scope.locationData = locationData.location;
$scope.locationHistory = locationData.locationHistory;
if ($routeParams.mode == "currentLocation") {
bc.getCurrentLocation(false);
}
bc.showMap(false,"#LocationIcon");
}]);bc.showMap is responsible for a couple of display tasks that hide/show the views/map and for activating/deactivating icons. The code looks like this:this.showMap = function (hide,selActiveIcon) {
if (!hide)
$("#MapContent").show();
else {
$("#MapContent").hide();
}
self.fitContent();
if (selActiveIcon) {
$(".iconbutton").removeClass("active");
$(selActiveIcon).addClass("active");
}
};Each of the other controllers in the app also call this function when they are activated to basically hide the map and make the
View Content area visible. The map
controller makes the map.This is UI code and calling this sort of thing from controllers is generally not recommended, but I couldn't figure out a way using directives to make this work any more easily than this. It'd be easy to hide and show the map and
view container using a flag an ng-show, but it gets tricky because of scoping of the $scope. I would have to resort to storing this setting on the $rootscope which I try to avoid. The same issues exists with the icons.It sure would be nice if Angular had a way to explicitly specify that a
View shouldn't be destroyed when another
view is activated, so currently this workaround is required. Searching around, I saw a number of whacky hacks to get around this, but this solution I'm using here seems much easier than any of that I could dig up even if it doesn't quite fit the 'Angular way'.Angular nice, until it's notOverall I really like Angular and the way it works although it took me a bit of time to get my head around how all the pieces fit together. Once I got the idea how the app/routes, the controllers and views snap together, putting together Angular pages becomes fairly straightforward. You can get quite a bit done never going beyond those basics. For most common things Angular's default routing and
view presentation works very well.But, when you do something a bit more complex, where there are multiple dependencies or as in this case where Angular doesn't appear to support a feature that's absolutely necessary, you're on your own. Finding information on more advanced topics is not trivial especially since versions are changing so rapidly and the low level behaviors are changing frequently so finding something that works is often an exercise in trial and error. Not that this is surprising. Angular is a complex piece of kit as are all the frameworks that try to hack JavaScript into submission to do something that it was really never designed to. After all everything about a framework like Angular is an elaborate hack. A lot of shit has to happen to make this all work together and at that Angular (and Ember, Durandel etc.) are pretty amazing pieces of JavaScript code. So no harm, no foul, but I just can't help feeling like working in toy sandbox at times :-)© Rick Strahl, West Wind Technologies, 2005-2013Posted in Angular JavaScript
Tweet
!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");
(function() {
var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true;
po.src = 'https://apis.google.com/js/plusone.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);
})();
