mirrors/TiddlyWiki5
1
0
Fork 0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-06-25 23:03:15 +00:00
Code Issues Releases Wiki Activity

Add links to tv-* variables in LinkWidget.tid

Browse Source
This commit is contained in:
Astrid Elocson 2015-02-28 14:45:22 +00:00
parent f73891c083
commit 27e6c7bb8d
1 changed files with 7 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
editions/tw5.com/tiddlers/widgets/LinkWidget.tid
View File

@ -1,6 +1,6 @@
title: LinkWidget title: LinkWidget
created: 201310241419 created: 201310241419
modified: 201502231037 modified: 20150228144334000
tags: Widgets tags: Widgets
caption: link caption: link
@ -18,7 +18,7 @@ The `link` widget generates links to tiddlers. (Use the HTML `<a>` element to ge
The content of the link widget is rendered within the `<a>` tag. The content of the link widget is rendered within the `<a>` tag.
The default value of the tooltip attribute is `<<tv-wikilink-tooltip>>`. 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: This means that you can control the text of a link tooltip in several ways:
@ -51,7 +51,6 @@ A useful convention is to set the tooltip like this:
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. 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 ! CSS Classes
* `tc-tiddlylink` - applied to all links * `tc-tiddlylink` - applied to all links
@ -60,35 +59,9 @@ This causes the tooltip to be the ''tooltip'' field of the target tiddler. If th
* `tc-tiddlylink-missing` - applied to tiddler links where the target tiddler doesn't exist * `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 * `tc-tiddlylink-resolves` - applied to tiddler links when the target tiddler does exist
! Configuration macros ! Configuration variables
Configuration macros can be used to modify the behaviour of the link widget. * <<.vlink tv-wikilinks>>
* <<.vlink tv-wikilink-template>>
!! tv-wikilinks * <<.vlink tv-wikilink-tooltip>>
* <<.vlink tv-get-export-link>>
Links are suppressed if the macro `tv-wikilinks` evaluates to the string `no`. For example:
```
\define tv-wikilinks() no
```
!! tv-wikilink-template
The target of the link widget defaults to the URL encoded title of the tiddler. The `href` can be templated by defining the configuration macro `tv-wikilink-template`, and including within it the token `$uri_encoded$`. For example:
```
\define tv-wikilink-template() http://tiddlywiki.com/#$uri_encoded$
```
The token `$uri_doubleencoded$` is replaced by the double encoded title of the tiddler.
Note that in the browser the `<a>` element generated by the link widget has a JavaScript event handler that navigates directly to the target tiddler, ignoring the `href` attribute.
!! tv-wikilink-tooltip
Provides default text for the link tooltip:
```
\define tv-wikilink-tooltip() This is a link to {{!!title}}
<$link to="HelloThere"/>
```