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

caption: browse
created: 20131024141900000
modified: 20170718142410367
tags: Widgets
title: BrowseWidget
type: text/vnd.tiddlywiki

! Introduction

The browse widget displays an HTML file browser button that allows the user to choose one or more files to import. It sends a [[WidgetMessage: tm-import-tiddlers]] carrying a JSON representation of the tiddlers imported from the files up through its parents. This message is usually handled by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.

! Content and Attributes

The content of the `<$browse>` widget is ignored.

|!Attribute |!Description |
|multiple |Set to "multiple" to select multiple file upload |
|deserializer |<<.from-version "5.1.15">> Optional name of deserializer to be used (by default the deserializer is derived from the file extension or type) |
|tooltip |Optional tooltip text |
|message |Optional override of widget message to be generated. The parameter for the message will be the JavaScript object `event.target.files` |

On iPhone/iPad choosing the multiple option will remove the ability to take photographs/videos directly into TiddlyWiki.

''e.g.''

```
<$browse>
```

renders as:

<$browse>
More mangling of reference docs 2014-09-10 23:06:19 +00:00			`caption: browse`
Docs updates Starting to document the new drag and drop stuff 2017-03-29 09:19:42 +00:00			`created: 20131024141900000`
Extend browse widget with deserializer attribute Along the same lines as 596dfa1d5058e030a318e4a0f23d078500c3d154 2017-07-18 14:32:50 +00:00			`modified: 20170718142410367`
Docs updates Starting to document the new drag and drop stuff 2017-03-29 09:19:42 +00:00			`tags: Widgets`
			`title: BrowseWidget`
			`type: text/vnd.tiddlywiki`
Lots and lots and lots of docs updates Now we've got up-to-date skeleton documentation for all the widgets 2013-10-31 22:03:40 +00:00
			`! Introduction`

Docs updates Starting to document the new drag and drop stuff 2017-03-29 09:19:42 +00:00			`The browse widget displays an HTML file browser button that allows the user to choose one or more files to import. It sends a [[WidgetMessage: tm-import-tiddlers]] carrying a JSON representation of the tiddlers imported from the files up through its parents. This message is usually handled by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.`
Lots and lots and lots of docs updates Now we've got up-to-date skeleton documentation for all the widgets 2013-10-31 22:03:40 +00:00
			`! Content and Attributes`

Add "multiple" attribute to browse widget And default to non-multiple upload; that’s enough to enable the ability to take photos/videos directly on iOS 2014-09-10 20:54:52 +00:00			The content of the `<$browse>` widget is ignored.

			`\|!Attribute \|!Description \|`
			`\|multiple \|Set to "multiple" to select multiple file upload \|`
Add missing version banners to updated docs 2017-07-18 15:15:46 +00:00			`\|deserializer \|<<.from-version "5.1.15">> Optional name of deserializer to be used (by default the deserializer is derived from the file extension or type) \|`
Update docs for 5.1.6 Also preparing for 5.1.7-prerelease 2014-12-19 15:51:56 +00:00			`\|tooltip \|Optional tooltip text \|`
Docs for update to browse widget 2014-10-20 15:57:06 +00:00			\|message \|Optional override of widget message to be generated. The parameter for the message will be the JavaScript object `event.target.files` \|
Add "multiple" attribute to browse widget And default to non-multiple upload; that’s enough to enable the ability to take photos/videos directly on iOS 2014-09-10 20:54:52 +00:00
			`On iPhone/iPad choosing the multiple option will remove the ability to take photographs/videos directly into TiddlyWiki.`
add a example 2014-10-06 16:38:12 +00:00
			`''e.g.''`

			```
			`<$browse>`
			```

			`renders as:`

			`<$browse>`
Docs for update to browse widget 2014-10-20 15:57:06 +00:00