About SuperviselyEcosystemContact usSlack

TeamFilesSelector

Introduction

TeamFilesSelector is a graphic interface widget in the Supervisely platform that enables users to easily select files and/or folders from their Team files. It allows to customize selecting type (files, folder or both of this types) and displaying additional columns with information about files and folder (size, created date, updated date, type, mime type). The widget features a user-friendly interface and is optimized for performance, making it a valuable tool for teams working.

Function signature

TeamFilesSelector(
    team_id=435,
    multiple_selection=False,
    max_height=500,
    selection_file_type=None,
    hide_header=True,
    hide_empty_table=True,
    additional_fields=[],
    widget_id=None,
)
default

Parameters

Parameters
Type
Description

team_id

int

Team ID

multiple_selection

bool

Whether available selection multiple files/folders

max_height

int

Determine maximum height of the widget

selection_file_type

Literal["folder", "file"] or None

Determine type of items available for selection

hide_header

bool

If True hide widget table header

hide_empty_table

bool

If True and Team files directory is empty it will display message

additional_fields

List[Literal["id", "createdAt", "updatedAt", "type", "size", "mimeType"]]

Determine column names to display additional information about files/folders

widget_id

str

ID of the widget

team_id

Team ID

type: int

file_selector = TeamFilesSelector(team_id=435)
team_id

multiple_selection

Whether available selection multiple files/folders

type: bool

default value: False

file_selector = TeamFilesSelector(
    team_id=435,
    multiple_selection=True,
)
multiselect_true
file_selector = TeamFilesSelector(
    team_id=435,
    multiple_selection=True,
)
multiselect_false

max_height

Determine maximum height of the widget

type: int

default value: 500

file_selector = TeamFilesSelector(
    team_id=435,
    max_height=200,
)
max_height

hide_header

If True hide widget table header

type bool

default value: True

file_selector = TeamFilesSelector(
    team_id=435,
    hide_header=False
)

selection_file_type

Determine type of items available for selection

type: Literal["folder", "file"] or None

default value: None

file_selector = TeamFilesSelector(
    team_id=435,
    selection_file_type=None,
)
type_none
file_selector = TeamFilesSelector(
    team_id=435,
    selection_file_type="file"
)
type_file
file_selector = TeamFilesSelector(
    team_id=435,
    selection_file_type="folder"
)
type_folder

hide_empty_table

If True and Team files directory is empty it will display message

type: bool

default value: True

file_selector = TeamFilesSelector(
    team_id=435,
    hide_empty_table=True,
)
empty_true
file_selector = TeamFilesSelector(
    team_id=435,
    hide_empty_table=False,
)
empty_false

additional_fields

Determine column names to display additional information about files/folders

type: List[Literal["id", "createdAt", "updatedAt", "type", "size", "mimeType"]]

default value: []

file_selector = TeamFilesSelector(
    team_id=435,
    hide_header=False,
    additional_fields=["id", "createdAt", "updatedAt", "type", "size", "mimeType"],
)
additional_fields

widget_id

ID of the widget

type: str

default value: ``

Methods and attributes

Attributes and Methods
Description

get_selected_paths()

Get list of path for selected files/folders in Team files.

get_selected_items()

Get list of selected files/folders information in Team files.

set_team_id(team_id: int)

Set team_id for TeamFilesSelector widget.

Mini App Example

You can find this example in our Github repository:

supervisely-ecosystem/ui-widgets-demos/selection/012_team_files_selector/src/main.py

Import libraries

import os

import supervisely as sly
from dotenv import load_dotenv
from supervisely.app.widgets import Button, Card, Container, TeamFilesSelector, Text

Init API client

First, we load environment variables with credentials and init API for communicating with Supervisely Instance:

load_dotenv("local.env")
load_dotenv(os.path.expanduser("~/supervisely.env"))
api = sly.Api()

Get team_id from environment variables

team_id = sly.env.team_id()

Initialize TeamFilesSelector widget

file_selector = TeamFilesSelector(
    team_id=team_id,
    max_height=300,
    multiple_selection=True,
    selection_file_type="folder",
    hide_header=False,
    additional_fields=["createdAt", "type", "size"],
)

Create Text, Button widgets we will use in UI for demo

text = Text()
button = Button()

Create app layout

Prepare a layout for app using Card widget with the content parameter and place widget that we've just created in the Container widget.

card = Card(
    title="Team Files Selector",
    content=Container([file_selector, button, text]),
)
layout = Container(widgets=[card])

Create app using layout

Create an app object with layout parameter.

app = sly.Application(layout=layout)

Add functions to control widgets from code

@button.click
def show_selected():
    selected_paths = file_selector.get_selected_paths()
    text.text = "<br>".join(selected_paths)
layout
PreviousDestinationProjectNextFileViewer

Last updated

Was this helpful?