#11: ⛓ Interface

We want to use TypeScript's abilities to know what kind of object we pass as an item to the todo-item component. We'll make sure that the item is of the right type. But its type is not a simple string, number or boolean. We'll define the item's type using an interface.

We've already seen an interface provided by Angular: the OnInit interface which includes the method ngOnInit. Every Class that implements this interface should define this method. Otherwise we'll get an error during compile time.

Interfaces exist only in TypeScript and are removed when the code is compiled to JavaScript. In JavaScript we cannot enforce type safety out of the box.

Create a TodoItem interface in a new interfaces folder with the Angular CLI:

ng g i interfaces/todo-item

i is short for... you guessed it - interface. Adding a path in the command to the Angular CLI generates the folders you specified if they do not already exist.

We'll use the Angular Generator to create the interface. Follow the instructions on the StackBlitz instructions page and return here to continue the worksheet.

In your IDE, open the newly created file src/app/interfaces/todo-item.ts:

src/app/interfaces/todo-item.ts
export interface TodoItem {
}

Now we can define what properties and/or methods every object of type TodoItem should have. At this point we'll add two members:

  • title which must be of type string

  • completed which is of type boolean and is an optional member

src/app/interfaces/todo-item.ts
export interface TodoItem {
  title: string;
  completed?: boolean;
}

Let's define the item @Input to be of the type we've created. This will allow the IDE to suggest us available members when we use item in the component class and template.

src/app/todo-item/todo-item.component.ts
export class TodoItemComponent implements OnInit {
  @Input() item: TodoItem;

You need to import the interface to this file.

src/app/todo-item/todo-item.component.ts
import { TodoItem } from '../interfaces/todo-item';

Now, let's define the list of todo items to contain objects of the TodoItem type.

src/app/app.component.ts
export class AppComponent {
  title = 'todo-list';
  todoList: TodoItem[] = [
    {title: 'install NodeJS'},
    {title: 'install Angular CLI'},
    {title: 'create new app'},
    {title: 'serve app'},
    {title: 'develop app'},
    {title: 'deploy app'},
  ];
}

Again, you need to import the interface to this file.

src/app/app.component.ts
import { TodoItem } from './interfaces/todo-item';

Now try to delete the title of one of the objects in the list. What happens?

💾 Save your code to GitHub

StackBlitz users - press Save in the toolbar and continue to the next section of the tutorial.

Commit all your changes by running this command in your project directory.

git add -A && git commit -m "Your Message"

Push your changes to GitHub by running this command in your project directory.

git push

Last updated