Using the treeview

The treeview provides an easy and intuitive way of navigating through the folder hierarchy of a document library. By default the treeview will display the root folder expanded so that any level one child folders will be visible.

Treeview Items

Treeview items contain two clickable elements:

• Expand/Collapse button
• Folder name

Clicking on the expand/collapse button will toggle the display of child folders within the treeview. These child folders will be indented relative to the parent folder. If the folder does not contain child folders, no button will be displayed.

Clicking on the folder name will change the currently selected folder for the web part to that particular folder.

The user is provided with visual feedback as to which folder is the currently selected folder by having that folder displayed using a different style as defined in the Lucas.DLE.css resource.

Automatic synchronisation

In order to maintain state across page requests, the state of the treeview is stored. However, upon each request, folders in the treeview are verified against the actual existing folders so that if, for example, another user adds, deletes or renames a folder, those changes will be automatically reflected in the tree.

In addition, if the user navigates to a folder that is not displayed (eg via the breadcrumb or file viewer), the treeview will automatically expand to display the new selected folder.