Class: Viewer

ReportViewer.Viewer

Report viewer component.

Table of contents

생성자

• constructor

속성

• availableExports
• currentPage
• diag
• documentLoaded
• errorHandler
• history
• mouseMode
• pageCount
• renderMode
• reportLoaded
• stateChanged
• toolbar
• viewMode
• zoom

메소드

• backToParent
• canBackToParent
• dispose
• export
• goToFirstPage
• goToLastPage
• goToNextPage
• goToPage
• goToPrevPage
• highlight
• open
• print
• refresh
• registerFont
• resetDocument
• search
• toggleFullScreen
• toggleSidebar
• toggleToolbar

Constructors

constructor

• new Viewer(element, options?)

Creates the viewer within container element (div) with id='viewer' and sets the language:

var options = { language: 'ru' };
var viewer = new ActiveReports.Viewer('#viewer', options );
viewer.open('report.json');

Parameters

Name	Type	Description
element	any	Where to render the viewer control. Accepts on of the following values: - string: DOM selector of the element to render viewer to. E.g. '#viewer' - DOM Element. E.g. document.getElementById('viewer') - JQuery object. E.g. $('#viewer')
options?	ViewerOptions	Control settings.

Properties

availableExports

• availableExports: string[]

---

currentPage

• Readonly currentPage: number

---

diag

• Readonly diag: Object

Type declaration

Name	Type
fetchPages	(startPageIndex?: number, count?: number) => void
processCommand	(cmd: ReportViewerCmd) => void

---

documentLoaded

• Readonly documentLoaded: EventFan<DocumentLoadEventArgs>

---

errorHandler

• errorHandler: ErrorHandler

---

history

• Readonly history: HistoryApi

---

mouseMode

• mouseMode: ViewerMouseMode

---

pageCount

• Readonly pageCount: number

---

renderMode

• renderMode: ViewerRenderMode

---

reportLoaded

• Readonly reportLoaded: EventFan<ReportLoadEventArgs>

---

stateChanged

• Readonly stateChanged: EventFan<ChangedEventArgs>

---

toolbar

• Readonly toolbar: Toolbar

---

viewMode

• viewMode: ViewerViewMode | ViewMode

---

zoom

• zoom: ViewerZoomMode

Methods

backToParent

▸ backToParent(): void

Performs backToParent action which will return user to parent report.

viewer.backToParent();

Returns

void

---

canBackToParent

▸ canBackToParent(): boolean

Gets true if backToParent command is applicable to current document.

Returns

boolean

---

dispose

▸ dispose(): void

Removes the control from the DOM and disposes any resources (internal).

Returns

void

---

export

▸ export(format, settings, params?): Promise<ExportResult>

Exports currently displayed report to specified output format. Returns object which contains result data as blob object | string and download function. So you could either use this blob object or download file immediately. Please note that you can specify settings in PDF export as plain list (like {title: 'Title', author: 'Author Name', ownerPassword: '1'} etc...

var options = {filename:"Invoice List"};
var cancelCallback = function(){
    return false; // continue export. Return true to cancel export process
}
viewer.export('pdf', options, {cancel: cancelCallback }).then(result => doSmthWithBlob(result.data));
//or you can download file
viewer.export('pdf', options, {cancel: cancelCallback }).then(result => result.download('Invoice List'));

Parameters

Name	Type	Description
format	string	Export format identifier. One of 'pdf', 'xlsx' or 'html'.
settings	Record<string, string | number | boolean>	Format specific export settings.
params?	Object	Additional export customization.
params.cancel?	() => boolean	-

Returns

Promise<ExportResult>

---

goToFirstPage

▸ goToFirstPage(): void

Navigates to the first page.

viewer.goToFirstPage();

Returns

void

---

goToLastPage

▸ goToLastPage(): void

Navigates to the last page.

viewer.goToLastPage();

Returns

void

---

goToNextPage

▸ goToNextPage(): void

Navigates to the next page.

viewer.goToNextPage();

Returns

void

---

goToPage

▸ goToPage(pageNumber): void

Navigates to the specified page (starting from 1).

viewer.goToPage(3); //will navigate to 3d page

Parameters

Name	Type
pageNumber	number

Returns

void

---

goToPrevPage

▸ goToPrevPage(): void

Navigates to the previous page.

viewer.goToPrevPage();

Returns

void

---

highlight

▸ highlight(result): Promise<void>

Highlights the search result returned by a search method.

results = [];

function search(text){
    viewer.search({text}, function(result){
        results.push(result)
    }).then(function(status){
        console.log(status)
    })
}

function nextSearchResult(index){
    if(results.length == 0){
        viewer.highlight(null);
        return;
    }
    viewer.hightlight(resutls[index]);
}

Parameters

Name	Type
result	null | SearchResult

Returns

Promise<void>

---

open

▸ open(report, settings?): Promise<LoadResult>

Opens report from file or as definition (json string)).

var viewer = new ActiveReports.Viewer(#viewerPlace);
viewer.open('report.json');

Parameters

Name	Type	Description
report	string | PageReport | Report	The report template. Can be report URI, or report definition, or instance of PageReport class.
settings?	Partial<ReportSettings>	Additional settings for report (name, parameters).

Returns

Promise<LoadResult>

---

print

▸ print(): void

Prints currently displayed report.

viewer.print();

Returns

void

---

refresh

▸ refresh(): void

Performs refresh operation in report (re-render report).

viewer.refresh();

Returns

void

---

registerFont

▸ registerFont(...fonts): Promise<void>

deprecated Use FontStore.registerFonts instead.

Register specified fonts in CSS and pdf export. Helps display export correctly on machines where fonts can be missed.

type FontDescriptor = {
    name: string,
    source: string,
    weight?: 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900',
    style?: 'normal' | 'italic' | 'oblique'
}

var arial = {
    name: 'Arial',
    source: 'fonts/arial.ttf',
    style: 'italic',
    weight: '700',
};

var gothic = {
    name: 'MS PGothic',
    source: 'fonts/MS-PGothic.ttf'
};

viewer.registerFont(arial);
//OR
viewer.registerFont(arial, gothic);
//OR
var fonts = [arial, gothic]; viewer.registerFont(...fonts);

Parameters

Name	Type
...fonts	FontDescriptor[]

Returns

Promise<void>

▸ registerFont(configUri): Promise<void>

deprecated Use FontStore.registerFonts instead.

Register specified fonts in CSS and pdf export. Helps display export correctly on machines where fonts can be missed.

viewer.registerFont('./fontsConfig.json');

Parameters

Name	Type
configUri	string

Returns

Promise<void>

---

resetDocument

▸ resetDocument(): Promise<void>

Resets current viewer document

Returns

Promise<void>

---

search

▸ search(options, resultFn, progressFn?, cancel?): Promise<SearchStatus>

Performs search operation in currently rendered report. Allows you to create your own custom search pane.

viewer.search({
    text: "Ship",
    matchCase: true
}, function(result){
    console.log(result)
}, function(progress){
    console.log(progress)
})

Parameters

Name	Type
options	SearchOptions
resultFn	(result: SearchResult) => void
progressFn?	(progress: { pageCount: null | number ; pageIndex: number }) => void
cancel?	CancellationToken

Returns

Promise<SearchStatus>

---

toggleFullScreen

▸ toggleFullScreen(enabled?): void

Change viewer mode to fullscreen.

viewer.toggleFullScreen();

Parameters

Name	Type
enabled?	boolean

Returns

void

---

toggleSidebar

▸ toggleSidebar(visible?): void

Toggle sidebar panel(hide or show it). In case if no parameter passed works as toggle.

viewer.toggleSidebar(); //will hide toolbar if visible
viewer.toggleSidebar(true);//will show it regardless current state

Parameters

Name	Type	Description
visible?	boolean	New visibility status. If value is not passed, the function will toggle current state.

Returns

void

---

toggleToolbar

▸ toggleToolbar(show?): void

Toggle toolbar (hide or show it).

viewer.toggleToolbar(); // toggles toolbar visibility
viewer.toggleToolbar(true); //will show it

Parameters

Name	Type	Description
show?	boolean	Pass true to switch toolbar ON, and vise-versa. Do not pass any value to toggle visibility.

Returns

void