Alto
dev

alto.ui.widgets

Small widgets shared by several screens: the sidebar toggle, the help button and a segmented control.

Examples

>>> SidebarToggle().toolTip()
'Hide exercise list'

PracticeCounts

class PracticeCounts(QLabel)

Colored counts for calendar practice on tiles and in the exercise screen.

Examples

>>> label = PracticeCounts()
>>> label.set_counts((2, 3, 1), studying=True, current="incorrect")
>>> "1 incorrect card" in label.toolTip()
True

PracticeCounts.set_counts

def set_counts(
    counts: tuple[int, int, int],
    *,
    studying: bool = False,
    current: str | None = None,
    totals: bool = False,
) -> None

Show the counts in blue, red, green order and underline the active queue.

Parameters

  • counts (tuple of int): Due reviews, new cards, and outstanding incorrect cards.
  • studying (bool): Separate the exercise screen’s counts with slashes.
  • current (str or None): The queue of the unanswered card, or None between cards.
  • totals (bool): Label the grid totals and show one queue per line.

Examples

>>> label = PracticeCounts()
>>> label.set_counts((1, 2, 0))
>>> label.toolTip().startswith("Blue — 2 new cards available")
True

SidebarToggle

SidebarToggle(
    parent: QWidget | None = None,
    *,
    noun: str = 'exercise list',
)

Bases: QToolButton

A button that shows or hides the exercise list.

Connect to clicked; the main window decides what to show and calls set_open to match.

Examples

>>> button = SidebarToggle()
>>> button.toolTip()
'Hide exercise list'
>>> button.set_open(False)
>>> button.toolTip()
'Show exercise list'

Constructor

Create the toggle, showing the list as open.

Parameters

  • parent (QWidget or None, default None): The widget that owns the button.
  • noun (str, default “exercise list”): What the list is called in the tooltip: “Hide exercise list”. Keyword-only.

Constructor examples

>>> SidebarToggle().autoRaise()
True
>>> SidebarToggle(noun="lesson list").toolTip()
'Hide lesson list'

SidebarToggle.set_open

def set_open(is_open: bool) -> None

Show the icon and tooltip for the list being open or closed.

Parameters

  • is_open (bool): True if the exercise list is showing.

Examples

>>> button = SidebarToggle()
>>> button.set_open(False)
>>> button.toolTip()
'Show exercise list'

HelpButton

HelpButton(
    text_provider: Callable[[], str],
    *,
    parent: QWidget | None = None,
)

Bases: QToolButton

A “?” button that opens a small popover with help text.

Click anywhere else to close it.

Examples

>>> HelpButton(lambda: "<b>Press the right note.</b>").toolTip()
'How this exercise works'

Constructor

Create the button.

Parameters

  • text_provider (callable): Called with no arguments each time the help is shown, so the text can follow the current settings. It returns simple HTML.
  • parent (QWidget or None, default None): The widget that owns the button. Keyword-only.

Constructor examples

>>> calls = []
>>> button = HelpButton(lambda: calls.append(1) or "help")
>>> calls  # the text is not asked for until the button is clicked
[]

HelpButton.show_help

def show_help() -> None

Open the popover under the button, right-aligned with it.

Examples

>>> HelpButton(lambda: "<b>Help</b>").show_help()  # doctest: +SKIP

SegmentedControl

SegmentedControl(
    labels: Sequence[str],
    *,
    icons: Sequence[str] = (),
    parent: QWidget | None = None,
)

Bases: QFrame

A pill-shaped row of choices of which exactly one is chosen, like the switch between two views.

Attributes

  • buttons (list of QPushButton): One per choice, in order.
  • chosen (Signal): Emitted with the number of the choice when the learner picks one.

Examples

>>> control = SegmentedControl(["Exercises", "Lessons"])
>>> control.current()
0
>>> control.set_current(1)
>>> control.current(), control.buttons[1].isChecked()
(1, True)

Constructor

Build the control with the first choice chosen.

Parameters

  • labels (sequence of str): The text of each choice.
  • icons (sequence of str, default ()): The icon of each choice, as the inside of a 24 by 24 SVG; fewer than the labels, or none, leaves the rest without. Keyword-only.
  • parent (QWidget or None, default None): The widget that owns it. Keyword-only.

Constructor examples

>>> len(SegmentedControl(["A", "B", "C"]).buttons)
3
>>> SegmentedControl(["A"], icons=[HELP]).buttons[0].icon().isNull()
False

SegmentedControl.set_compact

def set_compact(compact: bool) -> None

Show only the icons, or the icons and the text.

The text is still the tooltip and the name a screen reader says.

Parameters

  • compact (bool): True to hide the text.

Examples

>>> control = SegmentedControl(["Exercises", "Lessons"], icons=[HELP, HELP])
>>> control.set_compact(True)
>>> control.buttons[0].text(), control.buttons[0].toolTip()
('', 'Exercises')
>>> control.set_compact(False)
>>> control.buttons[0].text()
'Exercises'

SegmentedControl.current

def current() -> int

Return the number of the chosen choice.

Returns

  • int: The choice, from 0.

Examples

>>> SegmentedControl(["A", "B"]).current()
0

SegmentedControl.set_current

def set_current(number: int) -> None

Choose one, without announcing it.

Parameters

  • number (int): The choice, from 0.

Examples

>>> control = SegmentedControl(["A", "B"])
>>> control.set_current(1)
>>> control.current()
1

SegmentedControl.restyle

def restyle() -> None

Style the control from the palette now in use: a rounded track with the chosen choice raised and tinted.

A change of theme rebuilds the main window, so the control there is drawn afresh in the new colors. One that stays, as in the settings, is restyled by calling this.

Examples

>>> "segments" in SegmentedControl(["A", "B"]).styleSheet()
True