@txtextcontrol/tx-ng-document-viewer

TX Text Control Document Viewer (Angular version)

This library provides a document viewer compatible with TX Text Control and documents created using the editor and API of TX Text Control.

Prerequisites

The TX Text Control Document Viewer uses a backend that runs TX Text Control.NET Server for ASP.NET. Please use the MVC package for ASP.NET and ASP.NET Core Web Applications.

TXTextControl.Web.DocumentViewer.

Installation

ng add @txtextcontrol/tx-ng-document-viewer

Important notice: From Angular v17 onwards, "standalone" apps are the new default for the CLI. If you want DocumentViewerModule to be added to your app.module.ts automatically, you have to use the --no-standalone flag when creating a new Angular project with ng new. Standalone applications created without this flag will show the error Bootstrap call not found when using the ng add command.

Usage

Your component.html could look like this, for example (the only mandatory attributes are width, height and basePath):

<tx-document-viewer
   width="1000px"
   height="800px"
   basePath="https://www.server.com:5000"
   dock="Window"
   [toolbarDocked]="true"
   documentPath="test.docx"
   [isSelectionActivated]="true"
   [showThumbnailPane]="true"
   [userNames]="['[e-mail]']">
</tx-document-viewer>

Possible attributes

• width (string) - The width of the component (e. g. "1000px").
• height (string) - The height of the component (e. g. "800px").
• basePath (string) - The backend URL.
• toolbarDocked (boolean) - Specifies whether the toolbar is docked or floating.
• documentPath (string) - Specified the displayed document name.
• documentData (string) - Sets the document data encoded as a Base64 string. Supported formats are HTML, RTF, DOC, DOCX, PDF and TX.
• isSelectionActivated (boolean) - Specifies whether text can be selected and copied.
• signatureSettings (SignatureSettings) - Specifies the signature settings.
• showThumbnailPane (boolean) - Specifies whether the thumbnail sidebar is visible or not.
• dock (string) - Specifies how the control is docked. Possible values are 'Fill' and 'Window'.
• toolbarDocked (boolean) - Specifies whether the toolbar is docked or floating.
• resources (Object.<string, string>) - Specifies resources for the displayed strings.
• userNames (string[]) - An array of names specifying users who can sign the document.

SignatureSettings Object

The SignatureSettings object has the following properties:

• ownerName (string) - The owner name.
• signatureBoxName (string) - The id of the signature box element
• signerName (string) - The signer name.
• signerInitials (string) - The signer initials.
• showSignatureBar (boolean) - Specifies whether to show the signature bar.
• uniqueId (string) - The unique signature id.
• redirectUrlAfterSignature (string) - The URL to redirect to after a signature.
• signatureBoxes (SignatureBox[]) - Signature boxes.

SignatureBox Object

The SignatureBox object has the following properties:

• name (string) - The name of the signature box.
• signingRequired (boolean) - Specifies whether signing is required.
• style (SignatureBoxStyle) - The signature box style.

SignatureBoxStyle Enumeration

The SignatureBoxStyle enumeration has the following values:

• SignatureBoxStyle.Signature - The signature box is a signature box.
• SignatureBoxStyle.Initials - The signature box is an initials box.

Environment Support

• Angular >=15.0.0
• NuGet package TXTextControl.Web.DocumentViewer 32.4.0 and newer.