InlineSpan class abstract
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 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.
link
Text.rich(
TextSpan(
text: 'My name is ',
style: const TextStyle(color: Colors.black),
children: <InlineSpan>[
WidgetSpan(
alignment: PlaceholderAlignment.baseline,
baseline: TextBaseline.alphabetic,
child: ConstrainedBox(
constraints: const BoxConstraints(maxWidth: 100),
child: const TextField(),
)
),
const 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, {TextScaler textScaler = TextScaler.noScaling, 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 debug 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.
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 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
-
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. -
visitDirectChildren(
InlineSpanVisitor visitor) → bool -
Calls
visitor
for each immediate child of this InlineSpan.
Operators
-
operator ==(
Object other) → bool -
The equality operator.
override