Skip to main content
Version: 1.0.0

QuickDriveElement

QuickDriveElement is a custom HTML element that displays a complete, self-contained content browser. It combines a locations list, a breadcrumb, a search field, and a tile or table view of the current folder into a single element, which is similar to the experience in SAS Drive. This element extends HTMLElement.

Use QuickDriveElement when you want a ready-made browsing experience. Use the individual elements, such as ContentTreeElement and ContentAreaElement inside a ContentGroupElement, when you need to control the layout yourself.

QuickDriveElement fills its parent element, so give the parent an explicit size.

Custom Element Tag​

<div style="height: 600px">
  <sas-quick-drive url="http://my-viya-server.com" selection-mode="single"></sas-quick-drive>
</div>

Attributes​

selection-mode: string​

Specify the selection mode for the content.

Values​

multiple

Multiple items can be selected using the checkbox. This is the default selection mode if selection-mode is not specified.

single

Only one item can be selected at a time.

initial-view: string​

Specify the initial view for the content.

Values​

tileView

A tile-based view, the default if unspecified.

tableView

A table-based view with rows and columns.

hide-breadcrumb: boolean​

Specify whether the breadcrumb portion should be hidden. Since HTML attributes don't support booleans, only the presence of this attribute is required to enable it.

hide-controls: boolean​

Specify whether the sorting and view switching controls should be hidden. Since HTML attributes don't support booleans, only the presence of this attribute is required to enable it.

suppress-refresh-button: boolean​

Specify whether the refresh button should be removed from the toolbar. Since HTML attributes don't support booleans, only the presence of this attribute is required to enable it.

url​

See url.

authentication-type​

See authenticationType.

Properties​

onSelect: (selectedItems: Item[], selectAll: boolean, lastSelectedItem: Item, selected?: boolean) => void​

A callback function that can be used to respond to the selection of items.

Arguments​

selectedItems: Item[]

The Items that are currently selected.

selectAll: boolean

Whether all of the items have been selected.

lastSelectedItem: Item

The most recently selected Item.

selected?: boolean

True if the onSelect was triggered by a selection, false if onSelect was triggered by a deselection.

onOpen: (event: { item: Item }) => void​

A callback function that can be used to respond to an item being opened, such as by double-clicking a tile. The default open behavior still runs before this callback is invoked.

Arguments​

event.item: Item

The Item that was opened.

onLocationSelect: (item: Item) => void​

A callback function that can be used to respond to the selection of a location in the locations list.

Arguments​

item: Item

The selected Item.