caption: link created: 20131024141900000 modified: 20170328172846359 tags: Widgets title: LinkWidget type: text/vnd.tiddlywiki The `link` widget generates links to tiddlers. (Use the HTML `` element to generate external links). ! Content and Attributes |!Attribute |!Description | |to |The title of the target tiddler for the link (defaults to the [[current tiddler|Current Tiddler]]) | |aria-label |Optional [[Accessibility]] label | |tooltip |Optional tooltip WikiText | |tabindex |Optional numeric [[tabindex|https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/tabIndex]] | |draggable |"yes" to enable the link to be draggable (defaults to "yes") | |tag |Optional tag to override the default "a" element | The content of the link widget is rendered within the `` tag. The draggable functionality is equivalent to using the DraggableWidget with the ''tiddler'' attribute set to the link target. The default value of the tooltip attribute is supplied by the <<.vlink tv-wikilink-tooltip>> variable. This means that you can control the text of a link tooltip in several ways: ``` <$link to="HelloThere" tooltip="Custom tooltip">Link 1 <$set name="tv-wikilink-tooltip" value="I'm a link to {{!!title}}"> <$link to="HelloThere">Link 2 ``` Renders as: <$link to="HelloThere" tooltip="Custom tooltip">Link 1 <$set name="tv-wikilink-tooltip" value="I'm a link to {{!!title}}"> <$link to="HelloThere">Link 2 Note that the tooltip is rendered with the current tiddler set to the target of the link. A useful convention is to set the tooltip like this: ``` \define tv-wikilink-tooltip() <$transclude field="tooltip"><$transclude field="title"/> \end ``` This causes the tooltip to be the ''tooltip'' field of the target tiddler. If the field isn't present, then the title is used instead. ! CSS Classes * `tc-tiddlylink` - applied to all links * `tc-tiddlylink-external` - applied to external, non-tiddler links * `tc-tiddlylink-internal` - applied to tiddler links * `tc-tiddlylink-missing` - applied to tiddler links where the target tiddler doesn't exist * `tc-tiddlylink-resolves` - applied to tiddler links when the target tiddler does exist ! Configuration variables * <<.vlink tv-wikilinks>> * <<.vlink tv-wikilink-template>> * <<.vlink tv-wikilink-tooltip>> * <<.vlink tv-get-export-link>>