Skip to Content | Skip to Navigation

dojox.widget.FilePicker ¶

Status:	Draft
Version:	1.2
Project owner:	Nathan Toone
Available:	since V1.3

Contents

dojox.widget.FilePicker

A specialized version of RollingList that handles file information

Introduction¶

The file picker extends the rolling list to add file-specific styling (folder/file icons), as well as the concept of file system heirarchy.

Usage¶

Creating a file picker is similar to creating a rolling list. In addition to the options for rolling list, you can specify the following:

pathSeparator The path separator to use - it will be guessed if not provided
topDir the top-level directory to provide access to - it will be guessed if not provided
pathAttr the attribute to read for getting the full path of the file
New in 1.3 selectDirectories whether or not you want to allow selecting of directories
New in 1.3 selectFiles whether or not you want to allow selecting of files

Additional attr value¶

You can call widget.attr(“pathValue”) to get (or set) the value of the widget - using “string” format (ie. “/path/to/file.txt”) instead of using the item

Examples¶

A simple file picker pulling data from a dojox.data.FileStore¶

<script>
  dojo.require("dojox.data.FileStore");
  dojo.require("dojox.widget.FilePicker");
</script>

<div dojoType="dojox.data.FileStore" jsId="fileStore" pathAsQueryParam="true"
    url="/_static/dojo/dojox/data/demos/stores/filestore_dojotree.php"></div>
<div dojoType="dojox.widget.FilePicker" store="fileStore" query="{}" style="height:150px;width:50%"></div>

<style type="text/css">
  @import "/_static/dojo/dojox/widget/FilePicker/FilePicker.css";
</style>