InlineSpan class Null safety
An immutable span of inline content which forms part of a paragraph.
- The subclass TextSpan specifies text and may contain child InlineSpans.
- The subclass PlaceholderSpan represents a placeholder that may be filled with non-text content. PlaceholderSpan itself defines a ui.PlaceholderAlignment and a TextBaseline. To be useful, PlaceholderSpan must be extended to define content. An instance of this is the WidgetSpan class in the widgets library.
- The subclass WidgetSpan specifies embedded inline widgets.
This example shows a tree of InlineSpans that make a query asking for a
name with a TextField embedded inline.
Text.rich(
TextSpan(
text: 'My name is ',
style: TextStyle(color: Colors.black),
children: <InlineSpan>[
WidgetSpan(
alignment: PlaceholderAlignment.baseline,
baseline: TextBaseline.alphabetic,
child: ConstrainedBox(
constraints: BoxConstraints(maxWidth: 100),
child: TextField(),
)
),
TextSpan(
text: '.',
),
],
),
)
See also:
- Text, a widget for showing uniformly-styled text.
- RichText, a widget for finer control of text rendering.
- TextPainter, a class for painting InlineSpan objects on a Canvas.
- Inheritance
- Object
- DiagnosticableTree
- InlineSpan
- Implementers
- Annotations
Constructors
- InlineSpan({TextStyle? style})
-
Creates an InlineSpan with the given values.
const
Properties
Methods
-
build(
ParagraphBuilder builder, {double textScaleFactor: 1.0, List< PlaceholderDimensions> ? dimensions}) → void - Apply the properties of this object to the given ParagraphBuilder, from which a Paragraph can be obtained. [...]
-
codeUnitAt(
int index) → int? -
Returns the UTF-16 code unit at the given
index
in the flattened string. [...] -
codeUnitAtVisitor(
int index, Accumulator offset) → int? -
Performs the check at each InlineSpan for if the
index
falls within the range of the span and returns the corresponding code unit. Returns null otherwise. [...] -
compareTo(
InlineSpan other) → RenderComparison - Describe the difference between this span and another, in terms of how much damage it will make to the rendering. The comparison is deep. [...]
-
computeSemanticsInformation(
List< InlineSpanSemanticsInformation> collector) → void - Walks the InlineSpan tree and accumulates a list of InlineSpanSemanticsInformation objects. [...]
-
computeToPlainText(
StringBuffer buffer, {bool includeSemanticsLabels: true, bool includePlaceholders: true}) → void -
Walks the InlineSpan tree and writes the plain text representation to
buffer
. [...] -
debugAssertIsValid(
) → bool - In checked mode, throws an exception if the object is not in a valid configuration. Otherwise, returns true. [...]
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children. [...]
@protected, inherited
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node. [...]
override
-
getSemanticsInformation(
) → List< InlineSpanSemanticsInformation> - Flattens the InlineSpan tree to a list of InlineSpanSemanticsInformation objects. [...]
-
getSpanForPosition(
TextPosition position) → InlineSpan? - Returns the InlineSpan that contains the given position in the text.
-
getSpanForPositionVisitor(
TextPosition position, Accumulator offset) → InlineSpan? -
Performs the check at each InlineSpan for if the
position
falls within the range of the span and returns the span if it does. [...] -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent 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
-
toPlainText(
{bool includeSemanticsLabels: true, bool includePlaceholders: true}) → String - Flattens the InlineSpan tree into a single string. [...]
-
toString(
{DiagnosticLevel minLevel: DiagnosticLevel.info}) → String -
A string representation of this object. [...]
inherited
-
toStringDeep(
{String prefixLineOne: '', String? prefixOtherLines, DiagnosticLevel minLevel: DiagnosticLevel.debug}) → 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 brief description of this object, usually just the runtimeType and the
hashCode. [...]
inherited
-
visitChildren(
InlineSpanVisitor visitor) → bool -
Walks this InlineSpan and any descendants in pre-order and calls
visitor
for each span that has content. [...]
Operators
-
operator ==(
Object other) → bool -
The equality operator. [...]
override