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

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) and textStyle (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