@dbmdz/mirador-keyboardnavigation

WebJar for @dbmdz/mirador-keyboardnavigation

License

License

MIT
Categories

Categories

KeY Data Data Formats Formal Verification
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

dbmdz__mirador-keyboardnavigation
Last Version

Last Version

1.1.0
Release Date

Release Date

Type

Type

jar
Description

Description

@dbmdz/mirador-keyboardnavigation
WebJar for @dbmdz/mirador-keyboardnavigation
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/dbmdz/mirador-plugins

Download dbmdz__mirador-keyboardnavigation

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/dbmdz__mirador-keyboardnavigation/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>dbmdz__mirador-keyboardnavigation</artifactId>
    <version>1.1.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/dbmdz__mirador-keyboardnavigation/
implementation 'org.webjars.npm:dbmdz__mirador-keyboardnavigation:1.1.0'
// https://jarcasting.com/artifacts/org.webjars.npm/dbmdz__mirador-keyboardnavigation/
implementation ("org.webjars.npm:dbmdz__mirador-keyboardnavigation:1.1.0")
'org.webjars.npm:dbmdz__mirador-keyboardnavigation:jar:1.1.0'
<dependency org="org.webjars.npm" name="dbmdz__mirador-keyboardnavigation" rev="1.1.0">
  <artifact name="dbmdz__mirador-keyboardnavigation" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='dbmdz__mirador-keyboardnavigation', version='1.1.0')
)
libraryDependencies += "org.webjars.npm" % "dbmdz__mirador-keyboardnavigation" % "1.1.0"
[org.webjars.npm/dbmdz__mirador-keyboardnavigation "1.1.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Mirador plugins

This repository contains multiple extensions for the IIIF viewer Mirador (see http://projectmirador.org/).

Physical Document Ruler

Adds a vertical and a horizontal ruler with metric or imperial units to the canvas display if the canvas has a physical dimensions service set.

Demo

To enable it, simply include the JavaScript (after loading Mirador):

<script src="<url to the plugin>/physicalRuler.js"></script>

You can configure the ruler with the physicalRuler configuration attribute in your Mirador configuration:

var mirador = Mirador({
  physicalRuler: {
    color: "#ffffff",         // The color for the rulers and labels
    location: "bottom-left",  // Location of the reference point of the rulers
    smallDashSize: 10,        // Size of the small dashes in pixels
    largeDashSize: 15,        // Size of the large dashes in pixels
    labelsEvery: 5,           // Draw ruler labels every n centimeters/inches
    imperialUnits: false      // Use imperial units instead of metric
  }
});

Bookmarkable Viewer State

Modifies Mirador to dynamically update the URL to reflect the currently selected view type (image, book, etc), manifest and canvas and to reconstruct a Mirador session from such an URL hash. This allows users to bookmark the (partial) state of Mirador and restore it at a later time.

The syntax of the URL is compatible with the work-in-progress IIIF Drag-and-Drop pattern.

This plugins comes with a major caveat, namely that the URL is only updated if there is a single slot in the viewer. This is due to the fact that more complicated workspace layouts carry a lot more state that would be too unwieldy to store in the URL hash. Use Mirador's built-in bookmarking functionality (via JSONBlob) for these use cases.

To enable it, just include the JavaScript after loading Mirador.

Keyboard Navigation

Adds keyboard nagivation features to Mirador. If there are multiple windows, the action are applied to all of them.

Key Action
Go to previous page.
or SPACE Go to next page.
ctrl + Go to first page.
ctrl + Go to last page.
i Show or hide information/metadata.
Toggle fullscreen using the largest possible option.

Installation:

<script src="build/mirador/mirador.js"></script>
<script src="path/to/keyboardNavigation.js"></script>
<script>
// Creating Mirador instance
// ...
</script>

Piwik Tracking of Mirador Events

This plugin records user interactions with Mirador to a Piwik instance.

You can configure the plugin with the piwikTracking configuration Key:

{
    // Only set trackerUrl and siteId if you did not use the Piwik
    // JavaScript snippet
    trackerUrl: undefined,
    siteId: undefined,

    // Can be 'event' or 'content', what kind of interaction to record
    // in Piwik. 'event' will trigger an Event, 'content' a Content Interaction.
    method: 'event',
    events: [
      'change-page',
      'zoom',
      'enable-annotations',
      'add-annotation',
      'add-window'
    ]
}
org.webjars.npm

Open Source at the Bayerische Staatsbibliothek

...from the MDZ Digital Library team at the Bavarian State Library

Versions

Version
1.1.0
1.0.0