MembersListSelector

Introduction

Members List Selector widget allows to display list of users with roles.

Function signature

members_list_selector = MembersListSelector(
    users=members,
    multiple=True,
    widget_id=None,
)

default

Parameters

Parameters	Type	Description
users	List[UserInfo]	Supervisely UserInfo objects
multiple	bool	Enable multiple users selection
widget_id	str	ID of the widget

users

List of UserInfo objects.

type: List[UserInfo]

members_list_selector = MembersListSelector(
    users=members,
)

multiple

If True then multiple users can be selected. Otherwise, only one user can be selected.

type: bool

default False

members_list_selector = MembersListSelector(
    users=members,
    multiple=True,
)

Multiple Enabled

Multiple Enabled

Multiple disabled

Multiple disabled

widget_id

ID of the widget.

type: str

default value: None

Methods and attributes

Attributes and Methods	Description
set()	Set members to widget.
get_selected_members()	Return list of selected members.
select_all()	Select all members.
deselect_all()	Deselect all members.
select()	Select members by names.
deselect()	Deselect members by names.
set_multiple()	Set multiple flag.
get_all_members()	Return list of all members.
@selection_changed	Callback triggers when selection is changed.

Mini App Example

You can find this example in our Github repository:

supervisely-ecosystem/ui-widgets-demos/selection/018_members_list_selector/src/main.py

Import libraries

import os
import supervisely as sly
from supervisely.app.widgets import Card, Container, MembersListSelector, Text
from dotenv import load_dotenv

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 list of team members from API

team_members = api.user.get_team_members(team_id)

Initialize MembersListSelector widget and Text widget for displaying selected members count

members_list_selector = MembersListSelector(team_members, multiple=True)
selected_members_cnt = Text(f"Selected Members: 0 / {len(team_members)}")

Create app layout

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

container = Container(widgets=[selected_members_cnt, members_list_selector])

card = Card(
    title="Members List Selector",
    content=members_list_selector,
)

layout = card

Create app using layout

Create an app object with layout parameter.

app = sly.Application(layout=layout)

Add functions to control widgets from python code

@members_list_selector.selection_changed
def on_selection_changed(selected_members):
    selected_members_cnt.set(
        f"Selected Members: {len(selected_members)} / {len(team_members)}", "text"
    )

miniapp-min