Core API Reference

constants.PageProgression

Enum PageProgression represents page progression direction. PageProgression has members, LTR and RTL.

constants.PageSide

Enum PageSide represents page side. PageSide has members, LEFT and RIGHT.

constants.ReadyState

Enum ReadyState represents viewer ready state. ReadyState has members, LOADING, INTERACTIVE and COMPLETE.

plugin.registerHook(name, fn)

Register a function to a hook with the specified name. The registered function is called at appropriate timings by the core code. Arguments passed to the function depend on the hook. When multiple functions are registered, they are called by the order in which they are registered.

plugin.removeHook(name, fn)

Remove a function already registered to the specified name. Note that even if the same function are registered multiple times, this method removes only the first one.

profile.profiler.registerStartTiming(name, timestamp)

Registers start timing of some event.

profile.profiler.registerEndTiming(name, timestamp)

Registers end timing of some event.

profile.profiler.printTimings()

Log registered timings (start/end/duration). All values are printed in ms unit.

profile.profiler.disable()

Disable profiling.

profile.profiler.enable()

Enable profiling.

new CoreViewer(settings, options)

Vivliostyle CoreViewer class. Creates CoreViewer.

PageViewMode

Enum PageViewMode. PageViewMode has members, SINGLE_PAGE, SPREAD and AUTO_SPREAD.

ZoomType

Enum ZoomType. ZoomType has only one member, FIT_INSIDE_VIEWPORT.

CoreViewer

CoreViewer.getCurrentPageProgression()

Returns the current page progression of the viewer. If no document is loaded, returns null.

CoreViewer.getPageSizes()

CoreViewer.isTOCVisible()

Returns true if TOC is visible, false if hidden, null if TOC is unavailable

CoreViewer.loadDocument(singleDocumentOptions, documentOptions, viewerOptions)

Load an HTML or XML document(s).

CoreViewer.loadPublication(pubURL, documentOptions, viewerOptions)

Load a EPUB/WebPub publication.

CoreViewer.navigateToInternalUrl()

Navigate to the specified internal URL.

CoreViewer.navigateToPage()

Navigate to the specified page.

CoreViewer.queryZoomFactor(type)

Returns zoom factor corresponding to the specified zoom type.

CoreViewer.removeListener(type, listener)

Remove an event listener.

CoreViewer.setOptions(options)

Set CoreViewerOptions to the viewer.

CoreViewer.showTOC(opt_show, opt_autohide)

Show or hide TOC box

DocumentOptions

Options for the displayed document.

• documentObject (Document, optional) — Document object for the document. If provided, it is used directly without parsing the source again.
• fragment (string, optional) — Fragmentation identifier (EPUB CFI) of the location in the document which is to be displayed.
• authorStyleSheet (Array<string>, optional) — An array of author style sheets to be injected after all author style sheets referenced from the document. A single stylesheet may be a URL of the style sheet or a text content of the style sheet.
• userStyleSheet (Array<string>, optional) — An array of user style sheets to be injected. A single stylesheet may be a URL of the style sheet or a text content of the style sheet.

SingleDocumentOptions

Options for a single source document. SingleDocumentOptions is the object that has members below, or otherwise string that represents url.

• url (string) — URL of the document.
• startPage (number, optional) — If specified, the page page-based counter is set to the specified value on the first page of the document. It is equivalent to specifying counter-reset: page [specified value - 1] on that page.
• skipPagesBefore (number, optional) — If specified, the page page-based counter is incremented by the specified value before updating page-based counters on the first page of the document. This option is ignored if startPageNumber option is also specified.

CoreViewerSettings

CoreViewer settings that must be passed to CoreViewer's constructor.

• viewportElement (HTMLElement, required) — An element used as the viewport of the displayed contents.
• userAgentRootURL (string, optional) — URL of a directory from which viewer resource files (under resources/ directory in the source repository) are served.
• window (Window, optional) — Window object. If omitted, current window is used.
• debug (boolean, optional) — Debug flag.

CoreViewerOptions

Viewer options that can be set after the Viewer object is constructed.

• autoResize (boolean, optional) — Run layout again when the window is resized. default: true
• fontSize (number, optional) — Default font size (px). default: 16
• pageBorderWidth (number, optional) — Width of a border between two pages in a single spread (px). Effective only in spread view mode. default: 1
• renderAllPages (boolean, optional) — Render all pages at the document load time. default: true
• pageViewMode (PageViewMode, optional) — Page view mode (singlePage / spread / autoSpread). default: singlePage
• zoom (number, optional) — Zoom factor with which pages are displayed. default: 1
• fitToScreen (boolean, optional) — Auto adjust zoom factor to fit the screen. default: false
• defaultPaperSize ({width: number, height: number}, optional) — Default paper size in px. Effective when @page size is set to auto. default: undefined (means the windows size is used as paper size).

printHTML

Allows page-layouting using the vivliostyle for printing within a website without destroying the original layout

import { printHTML } from '@vivliostyle/core';

const htmlDoc = `<!doctype html>
<html>
    <head>
        <style>
        ... Add your CSS code here ...
        </style>
    </head>
    <body>
        ... Add your HTML code here ...
    </body>
</html>`;

const config = {
  title: 'My printed page',
  printCallback: (iframeWin) => iframeWin.print(), // optional: only needed if calling something other than window.print() for printing.
};

printHTML(htmlDoc, config);