ImageMap target options

Posts: 1
Joined: Wed Feb 24, 2021 11:44 pm

ImageMap target options

Post by SebastienP » Thu Feb 25, 2021 12:23 am

I'm trying to do something that I think I may not yet have the skills to achieve, as a relatively new user of DITA.

I'm working with an image map, and I'm trying to change how the links open. Getting the image map to work was not at all a problem, but I'm trying to get the links to open by means other than just opening that page. Is there a way to force opening the links either specifically in the same tab, a new tab, a new window, a dialogue or other hovering window, that sort of thing?

I know browsers can override these options, but I'm using the image map as a substitute for an index for a software platform where users are unlikely to have training, and I want for that tab/window to stay open while they look up reference info in (ideally) another window, or possibly a tab. Having the main page persist without having to click "Back" would help reduce confusion in people who are probably competent but are probably uninvested in learning.

Usually I would fiddle about with a "target=" tag, but oXygen seems to reject this as DITA invalid.


Posts: 734
Joined: Mon Dec 05, 2011 6:04 pm

Re: ImageMap target options

Post by Costin » Mon Mar 29, 2021 12:32 pm


I'm following this up just to update the thread.
By default, all links associated with an an image map open in the same page.
However, as a colleague already replied to you on the email support., we have a publishing template customization, which allows you to open those image map links in a separate page.

More specific, you can use an XSLT Extension that sets the target="_blank" attribute for all links generated from <xref> elements inside an imagemap.

Code: Select all

     <xsl:template match="*[contains(@class, ' topic/xref ')]" mode="imagemap-xref">
        <xsl:attribute name="target">_blank</xsl:attribute>
Then, you have to register your XSLT file on the com.oxygenxml.webhelp.xsl.dita2webhelp extension point.

You can use the following Publishing Template as an example: ... rget-blank

Maybe you could use this customization as a starting point for the customization you intend to perform.

Costin Sandoi
oXygen XML Editor and Author Support

Post Reply