1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-11-15 22:34:51 +00:00
TiddlyWiki5/editions/tw5.com/tiddlers/widgets/LinkWidget.tid

68 lines
2.2 KiB
Plaintext
Raw Normal View History

title: LinkWidget
created: 201310241419
modified: 20150228144334000
2014-09-10 23:06:19 +00:00
tags: Widgets
caption: link
2014-08-28 08:32:19 +00:00
The `link` widget generates links to tiddlers. (Use the HTML `<a>` element to generate external links).
2013-10-23 22:12:19 +00:00
! Content and Attributes
2013-10-23 22:12:19 +00:00
|!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 |
2013-03-04 14:42:41 +00:00
2013-10-23 22:12:19 +00:00
The content of the link widget is rendered within the `<a>` tag.
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</$link>
2014-08-28 21:28:02 +00:00
<$set name="tv-wikilink-tooltip" value="I'm a link to {{!!title}}">
<$link to="HelloThere">Link 2</$link>
</$set>
```
Renders as:
<$link to="HelloThere" tooltip="Custom tooltip">Link 1</$link>
2014-08-28 21:28:02 +00:00
<$set name="tv-wikilink-tooltip" value="I'm a link to {{!!title}}">
<$link to="HelloThere">Link 2</$link>
</$set>
Note that the tooltip is rendered with the current tiddler set to the target of the link.
2014-04-08 13:12:27 +00:00
A useful convention is to set the tooltip like this:
```
2014-08-28 21:28:02 +00:00
\define tv-wikilink-tooltip()
2014-04-08 13:12:27 +00:00
<$transclude field="tooltip"><$transclude field="title"/></$transclude>
\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>>