Ember Interactivity: Footer functionality, conditional rendering

To get the footer working, we need to implement the following three areas of functionality:

• A pending todo counter.
• Filters for all, active, and completed todos.
• A button to clear the completed todos.

1. Because we need access to our service from the footer component, we need to generate a class for the footer. Enter the following terminal command to do so:

   bash

   ember generate component-class footer
   

2. Next, go and find the newly-created todomvc/app/components/footer.js file and update it to the following:

   js

   import Component from "@glimmer/component";
   import { inject as service } from "@ember/service";
   
   export default class FooterComponent extends Component {
     @service("todo-data") todos;
   }
   

3. Now we need to go back to our todo-data.js file and add some functionality that will allow us to return the number of incomplete todos (useful for showing how many are left), and clear the completed todos out of the list (which is what the "Clear completed" functionality needs). In todo-data.js, add the following getter underneath the existing all() getter to define what the incomplete todos actually are:

   js

   get incomplete() {
     return this.todos.filterBy('isCompleted', false);
   }
   

   Using Ember's ArrayProxy.filterBy() method, we're able to easily filter Objects in our array based on simple equals conditions. Here we're asking for all the todo items where the isCompleted property is equal to false, and because isCompleted is @tracked in our Todo object, this getter will re-compute when the value changes on an Object in the array.
4. Next, add the following action underneath the existing add(text) action:

   js

   @action
   clearCompleted() {
     this.todos = this.incomplete;
   }
   

   This is rather nice for clearing the todos — we just need to set the todos array to equal the list of incomplete todos.
5. Finally, we need to make use of this new functionality in our footer.hbs template. Go to this file now.
6. First of all, replace this line:

   hbs

   <strong>0</strong> todos left
   

   With this, which populates the incomplete number with the length of the incomplete array:

   hbs

   <strong>{{this.todos.incomplete.length}}</strong> todos left
   

7. Next, replace this:

   hbs

   <button type="button" class="clear-completed">
   

   With this:

   hbs

   <button type="button" class="clear-completed" {{on 'click' this.todos.clearCompleted}}>
   

So now when the button is clicked, the clearCompleted() action we added earlier is run. However, if you try to click the "Clear Completed" button now, it won't appear to do anything, because there is currently no way to "complete" a todo. We need to wire up the todo.hbs template to the service, so that checking the relevant checkbox changes the state of each todo. We'll do that next.

The above is fine, but we have another small issue to contend with. The "todos left" indicator always says "x todos left", even when there is only one todo left, which is bad grammar!

To fix this, we need to update this part of the template to include some conditional rendering. In Ember, you can conditionally render parts of the template using conditional content; a simple block example looks something like this:

{{#if this.thingIsTrue}} Content for the block form of "if"
{{/if}}

So let's try replacing this part of footer.hbs:

<strong>{{this.todos.incomplete.length}}</strong> todos left

with the following:

<strong>{{this.todos.incomplete.length}}</strong>
{{#if this.todos.incomplete.length === 1}} todo
{{else}} todos
{{/if}} left

This will give us an error, however — in Ember, these simple if statements can currently only test for a truthy/falsy value, not a more complex expression such as a comparison. To fix this, we'll have to add a getter to todo-data.js to return the result of this.incomplete.length === 1, and then call that in our template.

Add the following new getter to todo-data.js, just below the existing getters. Note that here we need this.incomplete.length, not this.todos.incomplete.length, because we are doing this inside the service, where the incomplete() getter is available directly (in the template, the contents of the service has been made available as todos via the @service('todo-data') todos; line inside the footer class, hence it being this.todos.incomplete.length there).

get todoCountIsOne() {
  return this.incomplete.length === 1;
}

Then go back over to footer.hbs and update the previous template section we edited to the following:

<strong>{{this.todos.incomplete.length}}</strong>
{{#if this.todos.todoCountIsOne}}todo{{else}}todos{{/if}} left

Now save and test, and you'll see the correct pluralization used when you only have one todo item present!

Note that this is the block form of if in Ember; you could also use the inline form:

{{if this.todos.todoCountIsOne "todo" "todos"}}

As with the other components, we need a class to access the service.

1. Run the following command in your terminal:

   bash

   ember generate component-class todo
   

2. Now go to the newly-created todomvc/app/components/todo.js file and update the contents to look like so, to give the todo component access to the service:

   js

   import Component from "@glimmer/component";
   import { inject as service } from "@ember/service";
   
   export default class TodoComponent extends Component {
     @service("todo-data") todos;
   }
   

3. Next, go back again to our todo-data.js service file and add the following action just below the previous ones, which will allow us to toggle a completion state for each todo:

   js

   @action
   toggleCompletion(todo) {
     todo.isCompleted = !todo.isCompleted;
   }
   

Finally, we will edit the todo.hbs template such that the checkbox's value is now bound to the isCompleted property on the todo, and so that on change, the toggleCompletion() method on the todo service is invoked.

1. In todo.hbs, first find the following line:

   hbs

   <li>
   

   And replace it with this — you'll notice that here we're using some more conditional content to add the class value if appropriate:

   hbs

   <li class="{{ if @todo.isCompleted 'completed' }}">
   

2. Next, find the following line:

   hbs

   <input
     aria-label="Toggle the completion of this todo"
     class="toggle"
     type="checkbox"
   >
   

   And replace it with this:

   hbs

   <input
     class="toggle"
     type="checkbox"
     aria-label="Toggle the completion of this todo"
     checked={{ @todo.isCompleted }}
     {{ on 'change' (fn this.todos.toggleCompletion @todo) }}
   >
   

   Note: The above snippet uses a new Ember-specific keyword — fn. fn allows for partial application, which is similar to bind, but it never changes the invocation context; this is equivalent to using bind with a null first argument.

Try restarting the dev server and going to localhost:4200 again, and you'll now see that we have a fully-operational "todos left" counter and Clear button:

If you're asking yourself why we're not just doing the toggle on the component, since the function is entirely self-contained and not at all needing anything from the service, then you are 100% right to ask that question! However, because *eventually*, we'll want to persist or sync all changes to the todos list to local storage (see the final version of the app), it makes sense to have all persistent-state-changing operations be in the same place.

That's enough for now. At this point, not only can we mark todos as complete, but we can clear them as well. Now the only thing left to wire up the footer are the three filtering links: "All", "Active", and "Completed". We'll do that in the next article, using Routing.

• Previous
• Overview: Client-side JavaScript frameworks
• Next