# Template-Driven Forms

The ListView provides options for editing its data by using the [Template-Driven Angular Forms](https://angular.dev/guide/forms#template-driven-forms).

## Basic Concepts

To implement the editing mode of the Kendo UI ListView for Angular in Template-Driven Forms, define the [`EditTemplateDirective`](https://www.telerik.com/kendo-angular-ui/components/listview/api/edittemplatedirective) for the ListView items.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/listview/editing/template/source.txt)

## Setup

> The editing of the ListView in template-driven forms is based on the item index. As a result, the Template Forms immediately update the value.

To enable the editing mode of the ListView in Template-Driven Forms:

1. Wrap the component in a form.

   ```html
   <form novalidate #myForm="ngForm">
       <kendo-listview>
           
       </kendo-listview>
   </form>
   ```

2. Pass an [editing template](https://www.telerik.com/kendo-angular-ui/components/listview/api/edittemplatedirective).

   ```html
   <kendo-listview>
       <ng-template kendoListViewEditTemplate let-dataItem="dataItem">
           <input [(ngModel)]="dataItem.ProductName" name="ProductName" class="k-textbox" required/>
       </ng-template>
   </kendo-listview>
   ```

3. Configure the commands. You need to define the command buttons inside the editing template.

   ```html
   <kendo-listview>
       <ng-template kendoListViewEditTemplate let-dataItem="dataItem" let-isNew="isNew">
           <input [(ngModel)]="dataItem.ProductName" name="ProductName" class="k-textbox" required/>
           <button kendoListViewSaveCommand>{{ isNew ? 'Add' : 'Update' }}</button>
           <button kendoListViewCancelCommand>{{ isNew ? 'Discard changes' : 'Cancel' }}</button>
       </ng-template>
   </kendo-listview>
   ```

4. Attach handlers for CRUD data operations.

   When the user clicks a command button, the ListView will emit the corresponding event. To instruct the component what action to perform, handle the event that is emitted.

   ```html
   <kendo-listview
     [data]="view | async"
     (add)="addHandler($event)"
     (edit)="editHandler($event)"
     (save)="saveHandler($event)" 
     (cancel)="cancelHandler($event)"
     (remove)="removeHandler($event)"
   >
   
   </kendo-listview>
   ```

## Toggling the Edit State

Inside the corresponding event handlers, you can toggle the edit state of the ListView by using the following events:

* [`edit`](https://www.telerik.com/kendo-angular-ui/components/listview/editing/editing-template-forms#editing-records)
* [`add`](https://www.telerik.com/kendo-angular-ui/components/listview/editing/editing-template-forms#adding-records)
* [`cancel`](https://www.telerik.com/kendo-angular-ui/components/listview/editing/editing-template-forms#cancelling-editing)
* [`save`](https://www.telerik.com/kendo-angular-ui/components/listview/editing/editing-template-forms#saving-records)
* [`remove`](https://www.telerik.com/kendo-angular-ui/components/listview/editing/editing-template-forms#removing-records)

### Editing Records

The [`edit`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#edit) event fires when the `kendoListViewEditCommand` is clicked. Inside the event handler, you can toggle the editing mode of the item by calling the [`editItem`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#edititem) method.

```ts
public editHandler({sender, itemIndex, dataItem}) {
    // Close the previously edited item.
    this.closeEditor(sender);

    // Track the most recently edited item.
    // It will be used in `closeEditor` for closing the previously edited item.
    this.editedItemIndex = itemIndex;

    // Clone the current - `[(ngModel)]` will modify the original item.
    // Use this copy to revert changes.
    this.editedProduct = Object.assign({}, dataItem);

    // Edit the item.
    sender.editItem(itemIndex);
}
```

### Adding Records

The [`add`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#add) event fires when the `kendoListViewAddCommand` is clicked. Inside the event handler, you can show the new item editor by calling the [`addItem`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#additem) method.

```ts
public addHandler({sender}) {
    // Close the previously edited item.
    this.closeEditor(sender);

    // Open a new item editor.
    sender.addItem(new Product());
}
```

### Cancelling Editing

The [`cancel`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#cancel) event fires when the `kendoListViewCancelCommand` is clicked. Inside the event handler, you can switch the item back to the view mode by calling the [`closeItem`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#closeitem) method.

```ts
public cancelHandler({sender, itemIndex}) {
    // Close the item editor and restore the previous state.
    this.closeEditor(sender, itemIndex);
}

private closeEditor(listview, itemIndex = this.editedItemIndex) {
    // Close the editor before restoring the original data.
    listview.closeItem(itemIndex);

    // Revert the data item to the original state.
    this.editService.resetItem(this.editedProduct, itemIndex);

    // Clear the edited item state after closing the editor.
    this.editedItemIndex = undefined;
    this.editedProduct = undefined;
}
```

### Saving Records

The [`save`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#save) event fires when the `kendoListViewSaveCommand` is clicked.

```ts
public saveHandler({sender, itemIndex, dataItem, isNew}) {
    // Update the data source.
    this.editService.save(dataItem, isNew);

    // Close the editor after saving the item.
    sender.closeItem(itemIndex);
}
```

### Removing Records

The [`remove`](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent#remove) event fires when the `kendoListViewRemoveCommand` is clicked. Inside the event handler, you can issue a request to remove the current data item from the data source.

```ts
public removeHandler({dataItem}) {
    // Remove the current data item through the service that owns the data source.
    this.editService.remove(dataItem);
}
```

## Suggested Links

* [Overview of Editing](https://www.telerik.com/kendo-angular-ui/components/listview/editing)
* [Editing in Reactive Forms](https://www.telerik.com/kendo-angular-ui/components/listview/editing/editing-reactive-forms)
* [API Index of the ListView](https://www.telerik.com/kendo-angular-ui/components/listview/api)
* [API Reference of the ListViewComponent](https://www.telerik.com/kendo-angular-ui/components/listview/api/listviewcomponent)
