Command/setupinteraction

Summary

The command \setupinteraction is used to configure the look and behavior of links.

Settings

\setupinteraction[...,...][...=...,...]
[...,...]	name
state	start stop
style	style command
color	color
contrastcolor	color
title	text
subtitle	color
author	text
date	text
keyword	text
focus	standard frame width minwidth height minheight fit tight
menu	on off
fieldlayer	auto name
calculate	reference
click	yes no
display	normal new
page	yes no page name auto
openaction	reference
closeaction	reference
openpageaction	reference
closepageaction	reference
symbolset	name
height	dimension
depth	dimension
focusoffset	dimension

Option Explanation

state

Enable/disable interaction, i.e. clickable links

style

style of links; use style=, to disable styling of links

color

This color is used if the destination of the reference is on a different page from the reference itself. Use color=, if you don’t want to highlight links.

contrastcolor

This color is used if the destination of the reference is on the same page as the reference itself.

title

PDF metadata “title”

subtitle

PDF metadata “subject”, i.e. goes into the /Subject field of the document information dictionary.

author

PDF metadata “author”

date

PDF metadata “creation date”

keyword

PDF metadata "keywords"

focus

link target behaviour
standard	Opens internal links with current page mode and zoom settings (without modifying none of them). If the PDF viewer is in 'scroll' (or fit-to-width) mode, this setting jumps directly to the target rather than to the page it is on. Omitting `focus=standard` causes the viewer to jump to the page in full-page view (fitting it in the current window), regardless of previous view mode.
width	Make PDF links open in 'Fit width' mode, so that full page width has to fit in PDF viewer current window.
height	Make PDF links open in 'Fit height' mode, so that full page height has to fit in PDF viewer current window.
fit	Make PDF links open in 'Fit page' mode, so that the full page has to be presented in the viewer current window.

click

Hyperlink highlighting when clicked (/H /N)

openaction

JavaScript action on open:

- FitWidth Make the PDF open in 'Fit width' mode. - FitHeight Make the PDF open in 'Fit height' mode. - ToggleViewer Make the PDF open in fullscreen mode.

closeaction

JavaScript action on close

Settings name

\setupinteraction[...]
[...]	name

Description

There’s also a prefix option that prefixes the internal link reference with its value. Its default is # which makes links with fragment identifiers invalid. Please set prefix=target- or any other text value.

Examples

Example 1

\setupinteraction
   [state=start,
    color=green,
    style=bold]

Notes

Help from ConTeXt-Mailinglist/Forum

All issues with: