Recently I’ve been working on and evaluating different JavaScript frameworks for the next big project I’ll be involved in, we want to build Single Page Application (SPA) while depending on a solid JavaScript framework, so I decided to get my hands dirty and try to build a demo application using one of the solid JS framework, and the decision was AngularJS!
I called the demo app “Foursquare Explorer”, it is built using Twitter Bootstrap, Web API, Foursquare API, and for sure AngularJS. I was amazed how fast I was able to produce functional and neat app.
Foursquare Explorer Web Application
At the beginning of the learning phase, I tried to read different articles and blog posts about Angular but I got lost and confused, until I watched this short 60 minutes tutorial done by Dan Wahlin, You won’t regret watching it if you are new to Angular.
Before discussing what we’ll build during this tutorial I would like to talk about some of the features and concepts of Angular:
- Two-way data binding:
AngularJS templating engine binds the data in two way, this means that it is auto-magically synchronize the data between the view and the model, so if you updated the view then the model is updated and vice verse. This feature will cut out lot of the code needed to update your DOM. You can check this out using this plunker live demo.
- Declarative v.s Imperative user interface:
AngularJS uses HTML to define user interface via Directives, those directives are responsible to set event handlers behind the scene (Directives detail below). So you have to question yourself when you start setting IDs for html elements and try to manipulate the DOM using Javascript or jQuery.
- Models are POJO:
Data models in AngularJS are just “Plain Old JavaScript Objects” without any setters or getters. Any changes done on the view are immediately pushed back to the model, thanks for the two–way data binding and the “scope” object.
- Scopes:
Scopes in AngularJS can be considered the glue between the controller and the view, controller should not know anything about the view, and the view can know about the controller via the scope object.
- Controllers:
Controller in AngularJS is function with two main responsibilities which they are implement business logic, and manipulating the scope, not the HTML DOM for sure.
- Directives:
Directives in AngularJS will let you teach HTML DOM elements what to do, you will be able to enhance the capabilities of DOM elements by creating your custom directives and promote code reuse.
- Services:
Services in AngularJS are singleton objects, they are responsible for the heavy lifting in your app, most of the time they provide methods responsible to push/pull data from the back-end server or services. As well you can use services to share common logic between different controllers.
- Filters:
Filters will enable you to filter the data before it is projected to on the view, it might involve something straight forward such as date or numbers formatting, or you can implement your own custom filters such as filtering data source.
I feel you now, I believe you are confused with those new concepts! But do not worry, we’ll cover those concepts deeply during this tutorial while we are building the app.
What we’ll build in this tutorial?
I’m big fan of Foursquare, I’ve been always using their iPhone app for finding cool places with good rating; so I decided to build sample web application which allows us to explore places by providing your city i.e.(Amman) and optional category, then you will be able to bookmark places you like to visit them later!
Use cases we will cover in this web app are:
- Explore places based on City (Mandatory) and Places Category (Optional).
- Display 10 places on the view and enable server side pagination so we keep our app snappy.
- Displaying the top 9 image thumbnails of the place as a popover.
- Allow users to bookmark the place for future visit. (For the sake of simplicity we will use username without password and if you refreshed the page the user context is flushed).
- Displaying the bookmarked places for users.
- Finally we want cool UX and UI which will adopt to different screen sizes (Response Design) so we will use bootstrap UI as it plays nicely with AngularJS.
I’ve decided to breakdown this series to three posts, posts are:
- Building SPA using AngularJS – Part 1
- Building SPA using AngularJS – Part 2
- Building SPA using AngularJS – Part 3
Update (2014-May-5) New post which covers adding GulpJS as Task Runner for our AngularJS application:
Update (2014-June-1) New post which covers Implementing AngularJS Token Authentication using ASP.NET Web API 2 and Owin middleware:
We’ll build this app incrementally so we will add feature by feature, the source code for this series is available on GitHub, feel free to download it locally or fork it, I’m open to ideas and suggestions to add more features to this app, Foursquare API is great and we can build many features on top of it. As well you can try a demo of the app.
If there is nothing clear or ambiguous please drop me a comment and I’ll do my best to reply your questions.
To get the best of this tutorial I recommend you to follow the posts one by one. Hope you’ll enjoy coding with AngularJS as much as I enjoyed 🙂
Good one, thanks. Got to read it soon and it’s a nice demo.
Thank you, glad you like it, will check your caching mechanism once i’m on laptop.
Hi man, the final app looks identical like the app of “Pluralsight Bootstrap 3 Course”.
Hi, those are free themes available on http://bootswatch.com, anyone can use them. So if you used theme “Amelia” you will get the same results.
Cool! Great job, I follow you.
I am new AngularJS and SPA. Can you please update your app by adding security so that for each call, whether its for getting HTML view from MVC controller or data from API controller, user get authenticated/authorized first.
Hello Haider, currently I’m working on another anagularjs tutorial which covers authentication with web API. You can use basic authentication with SSL by sending the username and password with each request, or you can piggyback on asp.net authentication, you can look on something similar on http://www.youtube.com/watch?v=o-F5sYdoiYo
I got a source code, opened solution in VS 2013 and tried running I got an error message :
Server Error in ‘/’ Application.
——————————————————————————–
The resource cannot be found.
Description: HTTP 404. The resource you are looking for (or one of its dependencies) could have been removed, had its name changed, or is temporarily unavailable. Please review the following URL and make sure that it is spelled correctly.
Requested URL: /
Hello Mark,
Try to type /index.html or comment out RouteConfig.RegisterRoutes(RouteTable.Routes); which you will find in Global.asax file and the home page should open.
Yes, /index.html did the trick. Can you also please explain how data is getting into the app? I mean, is there a local database file somewhere?
Thanks
In this tutorial I’m communicating with Foursquare API, so all the search you depends on Foursquare RESTful service, check the file “placesExplorerService.cs” using this link: https://github.com/tjoudeh/FoursquareAngularJS/blob/master/FoursquareAngularJS.Web/app/services/placesExplorerService.js and you will see how I’m constructing HTTP GET request.
Follow along with the tutorial and everything is described clearly. Hope this answers your question.
If I’d like to use your code but access different data altogether is there a way of removing a data layer completely to avoid any kind of duplicates before adding a new data model?
Thanks
Hello Mark,
What do you mean by accessing data altogether? could you please elaborate more? You can use any Data access layer to get your data using Angular services.
I’d like to bring a database and use EF database first. Will that conflict with existing data access code?
Absolutely not, as well this was covered in this tutorial, you can check the code for this here
Good luck in your project!
Can you please explain how an AngularJS controller communicates with an MVC (c#) controller to get data? If that’s what they do. Thanks
Very well done! I recommend this series to anyone who is a beginner at Angular.
Thank you brajpanda, feel free to share it with your peers in your network 🙂
Great articles. They are helping a lot. Thank you!
Hello Eni, Glad that posts were useful 🙂
Hi Taiseer,
Thanks for the great tutorial. Always helps to have working examples to jump into as you gain knowledge.
Just a “heads up”, but the FoursquareAngularJS.Web (others?) example code uses angular ui-bootstrap-tpls-0.9.0.js and works just fine. However, when I use the latest version (ui-bootstrap-tpls-0.11.0-tpls.js), I get an error in the pagination section:
Object # has no method ‘$render’ at line 2207:19
I’m new to Angular, so I can’t offer anything more than letting you know there might be changes which may effect your demo.
Anyway, thanks again.
Hi Dwight, glad you liked it, and it is always better to have working example so readers can play and test it out.
I know about this issue, the API for data-pagination in Angular Bootstrap UI 0.11.0 version has been changed, they simplify it more. I might update this soon once I’ve the time.
The fix for this is to change the controller as the below:
$scope.pageChanged = function () {
getPlaces();
};
And the properties in the that should be changed for data-pagination directive as below:
data-ng-change=”pageChanged()” data-ng-model=”currentPage”
Didn’t test it out but it should work.
Can’t thank you enough for the update. It really helps to have working examples when you are learning. Cheers!
Thank you so much. I was able to download the example app, compile and run it. I’ve been looking all over for an example that would “just work” that i could debug through to learn how to use AngularJS. Thanks for providing this great example.
Hi Scott, you are welcome 🙂 I recommend you to look at AngularJS authentication posts as well. They cover more advanced features.
Let me know if there is something unclear while you are debugging the code, good luck learning AngularJs 🙂
This is a very good tutorial. Something that could really get people started.
I do need a bit of some help though. Trying to extend this by adding a Delete functionality.
I’ve added a link to the myplaces.html and modified the js files on the app folder (\controllers\myPlacesController.js, \services\placesDataService.js).
I need some help implementing the Delete on the
PlacesController.cs
Or if you could provide some additional info on where to add the delete functionality, that would be great.
Thanks and looking forward to your reply.
I recommend you to read my other post which implements the delete functionality in Web API, after you implement it you need to use $http.delete as your are doing $http.get. very simple to implement.
This kind of stumps me.
How were you able to default the MVC app to the Index.html file in the root?
I was trying to do the same in my MVC app and it goes into Error 404.
When I added the line:
routes.IgnoreRoute(“”)
to the App_Start/RouteConfig.cs on my application, I was able to go to Index.html (of course the URL is just still http://localhost:1234/# (which I was expecting).
Appreciate any insight.
I think you need to remove “RouteConfig.RegisterRoutes(RouteTable.Routes);” from the application_start event in Global.asax file. check how it is done here
My recommendation now if you want to build SPA is to start with “emtpy” ASP.NET Web project with no dependancies at MVC, if you want to add Web API then you can use Owin middle ware or you add it from Nuget. Check how I’m doing this in my Token based authentication post here.
Nice work of teaching noobs like us on how to get started, helped me a lot. Quick question – Since this is a SPA how can I track user activities using google analytics on it. The URL stays the same through out – Google analytics won’t capture the activities if it’s a SPA. may you please guide me in the correct directio? Thanks.