copier icon indicating copy to clipboard operation
copier copied to clipboard

Multiselection hints are too obscure

Open InAnYan opened this issue 11 months ago • 3 comments

Actual Situation

Image

  • <space> to select - select what?
  • <a> to toggle - toggle what?
  • <i> to invert - invert what?

Initially, I thought that all these actions refer to a (one) selection. But in this case, all these actions would do the same thing.

Only after trying and experimenting with a toy template I understood everything.

Desired Situation

Let's address this bit by bit.

What actions do:

  • <space> to select - toggles a single option under the arrow.
  • <a> to toggle - either:
    • Selects every option.
    • Deselects every option.
  • <i> to invert - inverts current assignments. What was selected become deselected, what was deselected became selected.

Scopes:

  • <space> to select - single choice.
  • <a> to toggle - all choices.
  • <i> to invert - all choices.

Proposed solution

Maybe rewrite it like this:

  • <space> to select - <space> toggle
  • <a> to toggle - <a> select all
  • <i> to invert - <i> invert selection

If we came to consensus, I can make a PR

InAnYan avatar Mar 13 '25 12:03 InAnYan

Maybe also <enter> confirm

InAnYan avatar Mar 13 '25 12:03 InAnYan

Nice suggestion, thanks!

I would slightly change it to:

  • <space> (un)select
  • <a> (un)select all
  • <i> invert selection

Also yes to <enter> confirm.

pawamoy avatar Mar 13 '25 13:03 pawamoy

Not so fast. This is a problem in underlying library questionary.

Aha! It actually has instruction parameter which we can use: https://questionary.readthedocs.io/en/stable/pages/types.html#questionary.checkbox

InAnYan avatar Mar 13 '25 13:03 InAnYan