Command/setupinteraction

\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]

See also

• \defineinteraction
• scrn-ini.mkvi
• References notes and floats/PDF navigation
• \setupinteractionscreen
• \setupmetadata
• \setuptaggedmetadata

Help from ConTeXt-Mailinglist/Forum

All issues with:

• \setupinteraction on the mailing list (all results)
• \setupinteraction on the mailing list (subject only)
• \setupinteraction on stack exchange
• \setupinteraction in ConTeXt's source