The FileBrowser app is a fully-fledged webAppOS app for browsing user's home directory.
When launched from index.html without the query string, the FileBrowser app will act as an ordinary file explorer.
However, when the query string contains the "embedded=true" argument, FileBrowser will switch to the embedded mode. In this mode, FileBrowser assumes it is running inside an iframe, thus: * it will not display the menu, * it will try to inform the parent frame about certain events (see below).
Usually, there is no need for developers to use the embedded mode. Developers can rely on the webappos.desktop.browse_for_file function from webappos.js or on the underlying FileDialog app (see FileDialog App API).
The embedded mode is used by the webAppOS FileDialog app, which adds the "Open" and "Cancel" buttons as well as a file name field and a combobox for choosing a file mask.
The FileBrowser embedded mode is accessible via the following URL:
http[s]://[domain_or_ip]/apps/filebrowser/index.html?embedded=true&mask=[*.mask]&path=[/home/path/to/start]
mask | a comma separated set of file masks. Only files matching one of the masks will be shown. Example: "*.png,*.jpg". |
path | a path relative to the user's home directory (must start with "/home"). |
FileBrowser requests the webAppOS "login" scope automatically.
The following HTML5 message is sent to the parent frame, when directory has changed:
filebrowser:dir:/home/path/to/dir
The following HTML5 message is sent to the parent frame, when some file has been highlighted, but not chosen yet:
filebrowser:file:/home/path/to/file
The following HTML5 message is sent to the parent frame, when the file has been chosen (e.g., via a double click):
filebrowser:choose:/home/path/to/file