Documentation
¶
Overview ¶
Package listselect owns one concern: the multi-selection mode a record list enters when its host is about to act on several rows at once. It is a lego piece — targetlist and targetdate assemble it, they do not re-declare it.
Sibling of listgap, and for the same reason: two lists that must stay visually and behaviourally interchangeable (crudview swaps one for the other) cannot each own a private copy of the rule.
Index ¶
- func ApplyHeader(s *style.Sheet) *style.Sheet
- func ApplyRow(s *style.Sheet, row widget.Part) *style.Sheet
- func Header(m *Mode, ids func() []string, name widget.Name) *Element
- type Mode
- func (m *Mode) Changed() *SignalBool
- func (m *Mode) CheckAll(ids []string)
- func (m *Mode) CheckedIDs(ids []string) []string
- func (m *Mode) Clear()
- func (m *Mode) Count() int
- func (m *Mode) Danger() *SignalBool
- func (m *Mode) IsChecked(id string) bool
- func (m *Mode) On() *SignalBool
- func (m *Mode) SetDanger(on bool)
- func (m *Mode) SetOn(on bool)
- func (m *Mode) Toggle(id string)
- type Row
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ApplyHeader ¶ added in v0.6.10
ApplyHeader adds the in-flow selection-header skin to s. The strip is the host root's first child; it is hidden until the root's Open state (the host binds it from the Mode's On signal), then a centred flex row carrying the select-all box and the count.
In normal mode the strip is display:none, so the host shows no header and no count until selection mode starts — identical to the pre-mode list.
Unlike the per-row check (ApplyRow), nothing here is OnEdge: the strip is in flow, a normal row above the <ul>, so nothing can overlap the first row.
func ApplyRow ¶ added in v0.6.10
ApplyRow adds the per-row selection-check skin to s (the host widget's sheet). The host calls this instead of hand-writing the block. row is the host's own row part (its class differs per widget), used only for the danger wash under a marked row.
The check rides its row's top-end corner (OnEdge), out of the flow: the label never shifts when selection mode opens, and the box reads as a badge on the row rather than a column of its own.
Three reveal facts, and each hangs off exactly the element that owns it:
The BOX exists only inside the list root's Open state (selection mode). In normal mode the root has no data-open, so there is no square at all — not an empty one. Hide() is the sole display authority in the base rule; the flex centring lives in the Open reveal, so nothing in the base competes with it (a base rule mixing Hide() with CenterContent() emits two `display` values and the revealed box comes back as a block, which stacks its glyph off-centre — the exact defect this split fixes).
WHICH GLYPH shows, and what colour the box wears, is the BOX's own Selected/Invalid state — written by the row ONLY in selection mode (see RowOf). Never the ROW's Selected/Invalid: those also mean "this is the loaded record" in normal mode, and a glyph must never appear then. Invalid → trash on a solid Danger box (white glyph via --color-on-danger); Selected → pencil on a solid AccentInverse box (white via --color-on-primary). A plain Accent/Inset box would tint the glyph near-black through currentColor.
The ROW carries the danger wash under the whole row while it is marked for delete (the row binds Invalid too, alongside the box).
func Header ¶ added in v0.6.10
Header builds the in-flow selection header strip: a select-all / deselect-all box (trash glyph while the danger tone is armed, pencil otherwise) and a count that reads "k / N". Child() it above the list <ul>. It is hidden in normal mode (ApplyHeader reveals it on the root's Open state), so the host shows no header and no count until selection mode starts.
ids returns the current rows in render order; the count is its length. name is the host's WidgetName().
Types ¶
type Mode ¶
type Mode struct {
// OnChange fires after every toggle with the current count, so a host can
// label its commit button ("🗑 3") and disable it at zero.
OnChange func(n int)
// contains filtered or unexported fields
}
Mode is the selection state of one list. The zero value is a usable list in normal mode — a list is a list until its host says otherwise.
func (*Mode) Changed ¶ added in v0.6.5
func (m *Mode) Changed() *SignalBool
Changed flips on every Toggle. Rows read it first in their state derives (see the changed field); without that read a tap would update nothing on screen.
func (*Mode) CheckAll ¶ added in v0.6.9
CheckAll marks every id in ids — the caller's CURRENT render order — and replaces any previous selection. It owns a fresh backing array (never aliases the caller's slice). Fires Changed() and OnChange with the new count. This is the master check's "select all" action.
func (*Mode) CheckedIDs ¶
CheckedIDs returns the marked ids in the order given by ids, which the caller passes as its current render order.
Ordering is NOT optional and NOT the caller's problem to remember: checked accumulates in TAP order, and a host building a confirmation message from tap order would list rows in an order that matches nothing on screen. Taking the render order as a parameter is what makes the wrong version unwritable — there is no accessor that returns the raw slice.
func (*Mode) Clear ¶ added in v0.6.9
func (m *Mode) Clear()
Clear unmarks every row WITHOUT leaving selection mode — unlike SetOn(false), which also exits the mode. The master check's "deselect all". A no-op (no signal churn) when nothing is marked.
func (*Mode) Count ¶ added in v0.6.9
Count reports how many rows are currently marked. The master check reads it to decide its tri-state (none / some / all) and to render "n / total".
func (*Mode) Danger ¶ added in v0.6.5
func (m *Mode) Danger() *SignalBool
Danger reports the tone signal a row binds its Invalid state to. Never a bool: the skin has to react.
func (*Mode) On ¶
func (m *Mode) On() *SignalBool
On reports the signal a component binds its root state to, so the stylesheet can reveal the checks. Never a bool: the skin has to react.
func (*Mode) SetDanger ¶ added in v0.6.5
SetDanger arms or disarms the danger tone. Additive: a host that never calls it gets no red anywhere, whatever the selection does.
type Row ¶ added in v0.6.10
type Row struct {
Check *Element
Edit *SignalBool
Danger *SignalBool
}
Row is the per-row selection wiring listselect hands a target* widget so the three widgets stop hand-rolling identical derives. Build it once per row in buildRow.
- Check is the glyph box: place it in the row. It reveals a trash glyph when the row is marked while the danger tone is armed, a pencil when marked while it is not, and is invisible otherwise.
- Edit is "marked, danger tone OFF" — the widget ORs this with its own "this is the loaded record" highlight for the row's Selected state.
- Danger is "marked, danger tone ON" — bind the row's Invalid state to it.
Source Files