DevExtreme v26.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Angular Form - Smart Paste

The DevExtreme Form ships with AI-powered Smart Paste functionality. When a user copies unstructured text from external sources such as documents, spreadsheets, web pages, or emails, Smart Paste processes clipboard data and populates related form fields automatically.

Backend API
<div id="form-container"> <div class="instruction" id="textarea-label" >Copy text from the editor below to the clipboard. Edit the text to see how your changes affect Smart Paste result.</div > <div class="instruction" >Paste text from the clipboard to populate the form. Press Ctrl+Shift+V (when the form is focused) or use the "Smart Paste" button under the form.</div > <div class="textarea-container"> <dx-button id="copy" text="Copy Text" icon="copy" stylingMode="contained" type="default" width="fit-content" (onClick)="onCopy()" ></dx-button> <dx-text-area id="textarea" [elementAttr]="{ 'aria-labelledby': 'textarea-label' }" [(value)]="text" stylingMode="filled" height="100%" ></dx-text-area> </div> <dx-form id="form" labelMode="outside" labelLocation="top" [showColonAfterLabel]="false" [minColWidth]="220" [aiIntegration]="aiIntegration" stylingMode="filled" > <dxi-form-item itemType="group" [colCountByScreen]="colCountByScreen" caption="Billing Summary" > <dxi-form-item dataField="Amount Due" editorType="dxTextBox" [editorOptions]="amountDueEditorOptions" [aiOptions]="amountDueAIOptions" ></dxi-form-item> <dxi-form-item dataField="Statement Date" editorType="dxDateBox" [editorOptions]="statementDueEditorOptions" [aiOptions]="statementDueAIOptions" ></dxi-form-item> </dxi-form-item> <dxi-form-item itemType="group" [colCountByScreen]="colCountByScreen" caption="Billing Information" > <dxi-form-item dataField="First Name" editorType="dxTextBox" [editorOptions]="textEditorOptions" ></dxi-form-item> <dxi-form-item dataField="Last Name" editorType="dxTextBox" [editorOptions]="textEditorOptions" ></dxi-form-item> <dxi-form-item dataField="Phone Number" editorType="dxTextBox" [editorOptions]="phoneEditorOptions" [aiOptions]="phoneAIOptions" > </dxi-form-item> <dxi-form-item dataField="Email" editorType="dxTextBox" [editorOptions]="textEditorOptions" [aiOptions]="emailAIOptions" > <dxi-form-validation-rule type="email"></dxi-form-validation-rule> </dxi-form-item> </dxi-form-item> <dxi-form-item itemType="group" [colCountByScreen]="colCountByScreen" caption="Billing Address" > <dxi-form-item dataField="Street Address" editorType="dxTextBox" [editorOptions]="textEditorOptions" ></dxi-form-item> <dxi-form-item dataField="City" editorType="dxTextBox" [editorOptions]="textEditorOptions" ></dxi-form-item> <dxi-form-item dataField="State/Province/Region" editorType="dxTextBox" [editorOptions]="textEditorOptions" ></dxi-form-item> <dxi-form-item dataField="ZIP" editorType="dxNumberBox" [editorOptions]="zipEditorOptions" [aiOptions]="zipAIOptions" ></dxi-form-item> </dxi-form-item> <dxi-form-item itemType="group" cssClass="buttons-group" [colCountByScreen]="colCountByScreen" > <dxi-form-item itemType="button" name="smartPaste" [buttonOptions]="smartPasteButtonOptions" ></dxi-form-item> <dxi-form-item itemType="button" name="reset" [buttonOptions]="resetButtonOptions" ></dxi-form-item> </dxi-form-item> </dx-form> </div>
import { bootstrapApplication } from '@angular/platform-browser'; import { Component, ViewChild, enableProdMode, provideZoneChangeDetection } from '@angular/core'; import { AzureOpenAI, type OpenAI } from 'openai'; import { DxTextAreaModule } from 'devextreme-angular'; import { AIIntegration, RequestParams, Response, } from 'devextreme-angular/common/ai-integration'; import { DxButtonModule, type DxButtonTypes } from 'devextreme-angular/ui/button'; import { DxFormModule, DxFormComponent } from 'devextreme-angular/ui/form'; import notify from 'devextreme/ui/notify'; import { Service } from './app.service'; if (!/localhost/.test(document.location.host)) { enableProdMode(); } const stylingMode = 'filled'; type AIMessage = (OpenAI.ChatCompletionUserMessageParam | OpenAI.ChatCompletionSystemMessageParam) & { content: string; }; const showNotification = (message: string, of: string, isError?: boolean, offset?: string) => { notify({ message, position: { my: 'bottom center', at: 'bottom center', of, offset: offset ?? '0 -50', }, width: 'fit-content', maxWidth: 'fit-content', minWidth: 'fit-content', }, isError ? 'error' : 'info', 1500); }; @Component({ selector: 'demo-app', templateUrl: './app.component.html', styleUrls: ['./app.component.css'], providers: [Service], imports: [ DxButtonModule, DxFormModule, DxTextAreaModule, ], }) export class AppComponent { @ViewChild(DxFormComponent, { static: false }) form: DxFormComponent; colCountByScreen = { xs: 2, sm: 2, md: 2, lg: 2, }; amountDueEditorOptions = { placeholder: '$0.00', stylingMode }; amountDueAIOptions = { instruction: 'Format as the following: $0.00' }; statementDueEditorOptions = { placeholder: 'MM/DD/YYYY', stylingMode }; statementDueAIOptions = { instruction: 'Format as the following: MM/DD/YYYY' }; textEditorOptions = { stylingMode }; phoneEditorOptions = { placeholder: '(000) 000-0000', stylingMode }; phoneAIOptions = { instruction: 'Format as the following: (000) 000-0000' }; emailAIOptions = { instruction: 'Do not fill this field if the text contains an invalid email address. A valid email is in the following format: email@example.com' }; zipEditorOptions = { stylingMode, mode: 'text' }; zipAIOptions = { instruction: 'If the text does not contain a ZIP, determine the ZIP code from the provided address.' }; resetButtonOptions: DxButtonTypes.Properties = { stylingMode: 'outlined', type: 'normal', }; smartPasteButtonOptions: DxButtonTypes.Properties = { stylingMode: 'contained', type: 'default', }; azureOpenAIConfig: any; aiService: AzureOpenAI; aiIntegration: AIIntegration; valueContent: string; text: string; constructor(service: Service) { this.azureOpenAIConfig = service.getAzureOpenAIConfig(); this.aiService = new AzureOpenAI(this.azureOpenAIConfig); this.aiIntegration = new AIIntegration({ sendRequest: this.sendRequest.bind(this), }); this.text = service.getDefaultText(); } ngAfterViewInit() { const form = this.form.instance; form.registerKeyHandler('V', (event: KeyboardEvent) => { if (event.ctrlKey && event.shiftKey) { navigator.clipboard.readText() .then((clipboardText) => { if (clipboardText) { form.smartPaste(clipboardText); } else { showNotification('Clipboard is empty. Copy text before pasting', '#form'); } }) .catch(() => { showNotification('Could not access the clipboard', '#form'); }); } }); } sendRequest({ prompt }: RequestParams): Response { const controller = new AbortController(); const signal = controller.signal; const aiPrompt: AIMessage[] = [ { role: 'system', content: prompt.system }, { role: 'user', content: prompt.user }, ]; const promise = this.getAIResponse(aiPrompt, signal); promise.catch(() => { showNotification('Something went wrong. Please try again.', '#form', true); }); const result: Response = { promise, abort: () => { controller.abort(); }, }; return result; } async getAIResponse(messages: AIMessage[], signal: AbortSignal) { const params = { messages, model: this.azureOpenAIConfig.deployment, max_completion_tokens: 1000, temperature: 0.7, }; const response = await this.aiService.chat.completions.create(params, { signal }); const result = response.choices[0].message?.content; return result; } onCopy() { navigator.clipboard.writeText(this.text); showNotification('Text copied to clipboard', '#textarea', false, '0 -20'); } } bootstrapApplication(AppComponent, { providers: [ provideZoneChangeDetection({ eventCoalescing: true, runCoalescing: true }), ], });
#form-container { display: grid; grid-template-columns: 1fr 2fr; grid-template-rows: auto auto; gap: 24px 40px; min-width: 720px; max-width: 900px; margin: auto; } .instruction { color: var(--dx-texteditor-color-label); } .textarea-container { display: flex; flex-direction: column; gap: 16px; } ::ng-deep .dx-layout-manager .dx-field-item.dx-last-row { padding-top: 4px; } ::ng-deep .dx-toast-info .dx-toast-icon { display: none; } ::ng-deep .buttons-group { display: flex; width: 100%; justify-content: end; } ::ng-deep .buttons-group .dx-item-content { gap: 8px; } ::ng-deep .buttons-group .dx-field-item:not(.dx-first-col), ::ng-deep .buttons-group .dx-field-item:not(.dx-last-col) { padding: 0; } ::ng-deep .buttons-group .dx-item { flex: unset !important; }
import { Injectable } from '@angular/core'; const AzureOpenAIConfig = { dangerouslyAllowBrowser: true, deployment: 'demo-mini', apiVersion: '2024-02-01', endpoint: 'https://public-api.devexpress.com/demo-openai', apiKey: 'DEMO', }; const defaultText = `Payment: Amount - $123.00 Statement Date: 10/15/2024 Name: John Smith Contact: (123) 456-7890 Email: john@myemail.com Address: - 123 Elm St Apt 4B - New York, NY 10001 `; @Injectable({ providedIn: 'root', }) export class Service { getDefaultText() { return defaultText; } getAzureOpenAIConfig() { return AzureOpenAIConfig; } }
<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/26.1.5/css/dx.light.css" /> </head> <body class="dx-viewport"> <div class="demo-container"> <demo-app>Loading...</demo-app> </div> <script src="https://cdn.jsdelivr.net/npm/zone.js@0.16.2/bundles/zone.umd.js"></script> <script src="./bundle.js" type="module"></script> </body> </html>

Use the following APIs to activate Smart Paste in our Form component:

  • aiIntegration - accepts an AIIntegration object that contains AI Service settings.
  • 'smartPaste' – adds a built-in Smart Paste button to the Form (see name for additional information). To use this capability in code, call the smartPaste(text) method. This sample leverages this method and implements a custom shortcut to activate Smart Paste.

Configure each Form item using aiOptions:

  • disabled - prevents AI-generated text from being pasted into this item.
  • instruction - specifies item instruction for the AI service.