fishcharlie/angular_routing_lab

##Angular Routing Lab

Objectives
Explore Routing in Single Page Apps
Create route-specific view templates and controllers.
Create RESTful Index and Show routes for a (Wine) resource.

In this lab we will be working with templates and routing in angular.

When a user goes to / they should see a list of wines (wines#index). When a user goes to /wines/:id they should see a single wine (wines#show).

Our data (a list of wines) lives at the bottom of app.js. Eventually we will use AJAX to retrieve this so we can perform all CRUD operations, but for now it's hardcoded.

Step 1. Setup

Clone this repo. Consider doing a git checkout -b in-progress or something similar to work there.
Make sure to bower install.
Note: We will need to run a local server once we start playing with routing.
- In the application directory run python -m SimpleHTTPServer. (You can do http-server or budo app.js --open instead, if you have them installed.)
- Then open your browser to "localhost:8000" (or similar).
- The Developer console should display: Angular is working.

Step 2. ng-route

A Single Page App needs a way of responding to user navigation. In order to perform "frontend routing", we need a way to capture URL changes and respond to them. For example, if the user clicks on a link to "/wines/1414", we need our Angular application to know how to respond (what templates, controllers, and resources to use). What we don't want to happen is for the request to reach the server.

Include angular-route:
- Run bower install -s angular-route in your terminal.
  - You may get a prompt like, ? Answer. If so, you are being asked which version of angular-route you want. You can Google this question and find additional information. I've found that typing 1 and hitting enter usually lets you proceed and you can confirm that angular-route has installed properly if the folder appears in your bower_components folder.
- Go to index.html and uncomment the angular-route script (index.html line 14).
- Add an ng-view attribute to the div on index.html, line 23.

Configure your routes:

In app.js, we need to add the ngRoute module:

    var app = angular.module('wineApp', ['ngRoute']);

Next, we need to add our first route:

    app.config(function($routeProvider){
      $routeProvider
        .when('/', {
          template: 'Home!'
        })
    })

Fire up your server:
- From your application directory, run python -m SimpleHTTPServer.
- Then open your browser to "localhost:8000" (or similar).
- You should see "Home!"
Use a template file instead of a string:
- Change template: 'Home!' to templateUrl: '/templates/wines-index.html'
- Refresh, you should see the content of /templates/wines-index.html.

Set up a controller:

It's time to attach a template to a specific controller, all we have to do is modify our route so that it looks like this:

    app.config(function($routeProvider){
      $routeProvider
        .when('/', {
          // template: 'Home!',
          templateUrl: '/templates/wines-index.html',
          controller: 'WinesIndexCtrl'
        })
    })

Now let's add a single value to WineIndexCtrl (in app.js):

    app.controller('WinesIndexCtrl', function($scope){
      console.log("Wine Index");
      $scope.hello = "wine index controller is working!";
    })

And update our template to include:
- {{hello}}
When you refresh you should see: "wine index controller is working!"

Step 3. Wine List Challenge

Can you display a list of all the wines on the wines index page? (Start by using the mock data object called ALL_WINES at the bottom of app.js).

What directive would you use to loop through a list of wines?

Can you get it working using the WineService, without using ALL_WINES directly?

How would you inject the WineService into WineIndexCtrl?
How would you query all of the wines?

Step 4. HTML5 Mode

Add the following in your route configuration so that we don't have to use the query hash for navigation:

    $locationProvider.html5Mode({
      enabled: true,
      requireBase: false
    });

Now instead of linking to #/wines/1424 we can link to "/wines/1424".

Step 5. Wine Show Challenge

To setup a wines#show route, we need to first figure out how to capture the id parameter in the URL.

For each of your wines on the wines#index page, let's add a link:

    <h5><a href="/wines/{{wine.id}}">{{wine.name}}</a></h5>

When a user navigates to /wines/:id we want to display the wine with the matching id!

First, update the route:

$routeProvider
  .when('/', {
    templateUrl: 'templates/wines-index.html',
    controller: 'WinesIndexCtrl'
  })
  .when('/wines/:id', { // the "id" parameter 
    templateUrl: 'templates/wines-show.html',
    controller: 'WinesShowCtrl'
  })

Next, we need to inject a new module into WinesShowCtrl called $routeParams:

app.controller('WinesShowCtrl', function ($scope, WineService, $routeParams) {
    console.log($routeParams.id);
});

Can you get it working now that you know how to grab the correct id? How would you display only that individual wine?

Stretch: Prettify

Go crazy. Use Bootstrap to make a fancy index and show page, listing out all the wine info, and showing an image for each of them.

Here are some of the wine fields we have to work with:

{
    "id": 1429,
    "created_at": "2015-10-13T01:30:28.631Z",
    "updated_at": "2015-10-13T01:30:28.631Z",
    "name": "CHATEAU LE DOYENNE",
    "year": "2005",
    "grapes": "Merlot",
    "country": "France",
    "region": "Bordeaux",
    "price": 12,
    "description": "Though dense and chewy, this wine does not overpower with its finely balanced depth and structure. It is a truly luxurious experience for the senses.",
    "picture": "http://s3-us-west-2.amazonaws.com/sandboxapi/le_doyenne.jpg"
}

Stretch 2: AJAX

Take a look at the $http lab from yesterday. Can you remove the WineService and replace with an $http call instead?

The endpoint is here: http://daretoexplore.herokuapp.com/wines/

The solution will be published on a separate branch at the end of this lab.

Licensing

All content is licensed under a CCBYNCSA 4.0 license. All software code is licensed under GNU GPLv3. For commercial use or alternative licensing, please contact legal@ga.co.

fishcharlie / angular_routing_lab