@txtextcontrol/tx-react-ds-document-viewer

4.0.0 • Public • Published

TX Text Control Document Services Document Viewer (React version)

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

Requirements

This version requires TX Text Control DS Server version 4.0.0.

Getting started

Creating a test application

  1. Create a new React applicaiton using Vite.js (Select React as the framework and JavaScript as the language):
npm create vite@latest test-app
  1. Change into the new directory:
cd test-app
  1. Install the TX Text Control DS Server Document Viewer:
npm i @txtextcontrol/tx-react-ds-document-viewer
  1. In your App.jsx file, import the DocumentViewer component and add it to the render method (the only mandatory attributes are width, height and serviceURL):
import DocumentViewer from '@txtextcontrol/tx-react-ds-document-viewer'

function App() {
  return (
    <>
      <DocumentViewer
        width="1280px"
        height="1024px"
        serviceURL="https://your.server.com/documentservices"
        documentData="SGVsbG8gdGhlcmU="
        clientId="dsserver.PdRpDAnzGLRrTPhRnYBU2UAEkzyB4PQ1"
        clientSecret="HgpGyqoFQOVkrzk6ukHtSxUS6XdU39LP">
      </DocumentViewer>
    </>
  );
}
  1. Start the application:
npm run dev

Possible attributes

  • accessToken (string) - The OAuth Access Token.
  • clientID (string) - The OAuth client ID.
  • clientSecret (string) - The OAuth client secret.
  • documentData (string) - Base64 encoded document data.
  • documentPath (string) - The displayed document name.
  • width (string) - The width of the component (e. g. "1280px").
  • height (string) - The height of the component (e. g. "1024px").
  • serviceURL (string) - The server which is hosting your installation of Text Control DS Server.
  • userNames (string[]) - An array of names specifying users who have access to editable regions.
  • isSelectionActivated (boolean) - Specifies whether text can be selected and copied.
  • 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.
  • signatureSettings (object) - The signature settings. See below.
  • customQueryParams (Object.<string, any>) - Specifies user-definable query parameters which are added to the query string of each HTTP request.
  • onLoad (function) - Is executed as soon as the main 'TXDocumentViewer' object is loaded.

Signature settings

The signature settings 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.
  • customSigning (boolean) - Specifies whether the signing process is handled within custom code.
  • signatureBoxes (object[]) - Boxes for signing (see below). Property signatureBoxName has no effect if this array is not empty.

Signature boxes

A signature box object has the following properties:

  • style (string) - The signature box style. Possible values are "Signature" and "Initials". The default value is "Signature".
  • signingRequired (boolean) - Specifies whether signing is required. The default value is true.

Readme

Keywords

none

Package Sidebar

Install

npm i @txtextcontrol/tx-react-ds-document-viewer

Weekly Downloads

306

Version

4.0.0

License

ISC

Unpacked Size

28.7 kB

Total Files

5

Last publish

Collaborators

  • thomerow
  • bjoerntx
  • schedo
OSZAR »