TiddlyWiki5/editions/tw5.com/tiddlers/widgets/ImageWidget.tid

title: ImageWidget
created: 20140416160234142
modified: 20140611160234142
tags: widget

! Introduction

The image widget displays images that can be specified as a remote URL or the title of a local tiddler containing the image.

! Content and Attributes

Any content of the `<$image>` widget is ignored.

|!Attribute |!Description |
|source |The URL of the image, or the title of an image tiddler |
|width |The width of the image as a number |
|height |The height of the image |
|tooltip |The tooltip to be displayed over the image |
|class |CSS classes to be assigned to the `<img>` element |

! External Images and the ''_canonical_uri'' field

When used to display tiddler-based images, the image widget operates in two distinct modes:

* If the ''_canonical_uri'' field is present then it is used as the ''src'' attribute of the generated `<img>` element and the ''text'' field is ignored
* Without the ''_canonical_uri'' field, the image widget generates an `<img>` element that embeds the image data directly using a `data:` URI.

See ExternalImages for more details.
Added wikitext image support We’ve added a parser to recognise the `[img[URL or tiddler title]]` format, and an associated image widget. 2014-04-17 11:52:32 +00:00			`title: ImageWidget`
			`created: 20140416160234142`
First pass at external image support A bunch of little changes that together enable external image support. Try: ``` tiddlywiki editions/tw5.com --verbose --build externalimages ``` Then open `externalimages.html`, look for the images in the more/types tab of the sidebar, open them and verify that they are set with an external SRC attribute, not a data URI. 2014-06-12 07:36:30 +00:00			`modified: 20140611160234142`
Added wikitext image support We’ve added a parser to recognise the `[img[URL or tiddler title]]` format, and an associated image widget. 2014-04-17 11:52:32 +00:00			`tags: widget`

			`! Introduction`

			`The image widget displays images that can be specified as a remote URL or the title of a local tiddler containing the image.`

			`! Content and Attributes`

			Any content of the `<$image>` widget is ignored.

			`\|!Attribute \|!Description \|`
			`\|source \|The URL of the image, or the title of an image tiddler \|`
			`\|width \|The width of the image as a number \|`
			`\|height \|The height of the image \|`
			`\|tooltip \|The tooltip to be displayed over the image \|`
			\|class \|CSS classes to be assigned to the `<img>` element \|

First pass at external image support A bunch of little changes that together enable external image support. Try: ``` tiddlywiki editions/tw5.com --verbose --build externalimages ``` Then open `externalimages.html`, look for the images in the more/types tab of the sidebar, open them and verify that they are set with an external SRC attribute, not a data URI. 2014-06-12 07:36:30 +00:00			`! External Images and the ''_canonical_uri'' field`

			`When used to display tiddler-based images, the image widget operates in two distinct modes:`

			* If the ''_canonical_uri'' field is present then it is used as the ''src'' attribute of the generated `<img>` element and the ''text'' field is ignored
			* Without the ''_canonical_uri'' field, the image widget generates an `<img>` element that embeds the image data directly using a `data:` URI.

			`See ExternalImages for more details.`