TX Text Control JavaScript API

Version X18 (28.0) comes with a complete JavaScript API for the online document editor shipped with TX Text Control .NET Server for ASP.NET.

The complete JavaScript API documentation can be found in our online docs:

JavaScript API

This article describes typical tasks for MailMerge and reporting applications such as inserting merge fields, merge blocks and how to loop through these MailMerge elements.

Inserting Merge Fields

In the new API, each element, like a TextField, is accessible through it's own collection. The following code snippet shows how to insert a merge field, that is compatible with MailMerge, using the ApplicationFieldCollection TX Text Control .NET Server for ASP.NET
JavaScript API
ApplicationFieldCollection Object
Contains all created or imported Microsoft Word fields represented through objects of the type ApplicationField.
.

The collection is accessible through the applicationFields TX Text Control .NET Server for ASP.NET
JavaScript API
FormattedText Object
applicationFields Property
Gets a collection of all Microsoft Word fields that have been created or imported from a Microsoft Word or RTF document.
property. The add TX Text Control .NET Server for ASP.NET
JavaScript API
ApplicationFieldCollection Object
add Method
Inserts a new application field at the current input position.
method inserts a new field at the current input position.

Loading...

The last parameter in the above call of the add method returns the inserted field in a callback. In this code snippet, this returned object is used to add additional properties that are not available in the constructor of the add method.

The above snippet shows how to insert merge fields (or any other supported type) into a document. The same can be achieved by using the addMergeField TX Text Control .NET Server for ASP.NET
JavaScript API
TXTextControl Object
addMergeField Method
Inserts a merge field at the current input position.
method to make things easier for the most typical fields.

Loading...

Looping through Fields

The next code snippet is using the forEach TX Text Control .NET Server for ASP.NET
JavaScript API
Collection Object
forEach Method
Executes a callback function for each element.
method that is available for each collection in the JavaScript API. This method executes a callback for all elements in a collection. The code loops through all ApplicationFields and returns it's name.

Loading...

The below code snippet changes the text of each field in the document:

Loading...

Inserting Merge Blocks

A merge block that repeats content based on the hierarchical data using MailMerge TX Text Control .NET Server for ASP.NET
DocumentServer Namespace
MailMerge Class
The MailMerge class is a .NET component that can be used to effortlessly merge template documents with database content in .NET projects, such as ASP.NET web applications, web services or Windows services.
, is a SubTextPart TX Text Control .NET Server for ASP.NET
JavaScript API
SubTextPart Object
A SubTextPart object represents a user-defined part of a document.
element. The name of the SubTextPart must have the specific prefix txmb_ followed by the name of the merge block. The following code inserts a merge block with the name myMergeBlock at the current input position:

Loading...

The Selection TX Text Control .NET Server for ASP.NET
JavaScript API
Selection Object
Describes and handles the attributes of a text selection.
object is used to retrieve the start and length index of the current selection which is then used in the add TX Text Control .NET Server for ASP.NET
JavaScript API
SubTextPartCollection Object
add Method
Adds a new SubTextPart to the collection.
method of the SubTextPartCollection.

The next code snippet shows how to iterate through all SubTextParts in order to return valid merge block names:

Loading...

Read more about the improved JavaScript API in our documentation and download the trial version of TX Text Control .NET Server for ASP.NET to test this on your own.