TermListTile class
A row of a list, as a terminal program lists things: title in the words' ink, subtitle dim, leading (a status glyph) before them and trailing (a time, a count, a key) at the end.
Under a pointer it is one line and subtitle stands beside title as a column (where it starts: titleCols); under a finger it is two lines, subtitle under title. The row runs from edge to edge (put rows in a TermPane.list) and keeps a one-cell gutter at each end. The keyboard's focus is the cursor over the whole row, a pair of brackets cut out of its gutters (on a chosen row, hollow). selected draws the row in inverse video, and a screen reader hears it selected; a press fills it the same way.
TermListTile(
leading: const Text('✓'),
title: const Text('atlas-api'),
subtitle: const Text('main · 2m 14s'),
trailing: const Text('4m'),
selected: true,
onTap: () {},
)
Reads TermStyle's fill (the row's ground), foreground (the
words), edge (the focus block) and textStyle.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatelessWidget
- TermListTile
Constructors
- TermListTile({Key? key, Widget? leading, required Widget title, Widget? subtitle, Widget? trailing, VoidCallback? onTap, bool selected = false, bool enabled = true, FocusNode? focusNode, bool autofocus = false, String? semanticLabel, TermStyle? style, int? titleCols, bool option = false})
-
A list row.
const
Properties
- autofocus → bool
-
Whether it takes focus when first shown.
final
- enabled → bool
-
Whether it takes presses; a disabled row is drawn in the rule's ink.
final
- focusNode → FocusNode?
-
Its focus; one given is the caller's to dispose, and null makes and
disposes its own.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- leading → Widget?
-
Before the words: a status glyph, a marker.
final
- onTap → VoidCallback?
-
Called on a press, Return or Space; null: the row only shows.
final
- option → bool
-
Whether the row is an option in a list a field opens (a
TermSelect's): the pointer over it marks it as the keys on it do,
its words in the accent, so the row a press would take shows before
the press, apart from the chosen one's bar; the keys add the cursor. A
row in a page's list keeps its words, and only the keys mark it.
In a list the pointer opened, the keys' mark waits for a key
(TermMenuMarks).
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- selected → bool
-
Whether the row is the chosen one, drawn in inverse video.
final
- semanticLabel → String?
-
What a screen reader says in place of the row's words.
final
- style → TermStyle?
-
Overrides, over the theme's TermThemeData.listTileStyle:
fill(selected or pressed),foreground(the words),edge(the keyboard's cursor) andtextStyle(the title's colour and weight).final - subtitle → Widget?
-
More about it, dim: beside title under a pointer, under it under a
finger.
final
- title → Widget
-
What the row is.
final
- titleCols → int?
-
The cells leading and title take on a row whose subtitle stands
beside them; null: three fifths of the row. Give a list's rows one
number, so their subtitles start in one column: a list of short names
with long messages gives the messages the room.
final
- trailing → Widget?
-
At the end: a time, a count, a key.
final
Methods
-
build(
BuildContext context) → Widget -
Describes the part of the user interface represented by this widget.
override
-
createElement(
) → StatelessElement -
Creates a StatelessElement to manage this widget's location in the tree.
inherited
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children.
inherited
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
override
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited