DefaultTextStyle class
The text style to apply to descendant Text widgets which don't have an explicit style.
A MediaQuery ancestor of a Text widget may still override the TextStyle.height, TextStyle.letterSpacing, and TextStyle.wordSpacing of the TextStyle set by this DefaultTextStyle widget through its MediaQueryData.lineHeightScaleFactorOverride, MediaQueryData.letterSpacingOverride, and MediaQueryData.wordSpacingOverride members.
This example shows how to use DefaultTextStyle.merge to create a default
text style that inherits styling information from the current default text
style and overrides some properties.
link
To create a local project with this code sample, run:
flutter create --sample=widgets.DefaultTextStyle.1 mysample
See also:
- AnimatedDefaultTextStyle, which animates changes in the text style smoothly over a given duration.
- DefaultTextStyleTransition, which takes a provided Animation to animate changes in text style smoothly over time.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- ProxyWidget
- InheritedWidget
- InheritedTheme
- DefaultTextStyle
Constructors
- DefaultTextStyle({Key? key, required TextStyle style, TextAlign? textAlign, bool softWrap = true, TextOverflow overflow = TextOverflow.clip, int? maxLines, TextWidthBasis textWidthBasis = TextWidthBasis.parent, TextHeightBehavior? textHeightBehavior, required Widget child})
-
Creates a default text style for the given subtree.
const
- DefaultTextStyle.fallback({Key? key})
-
A const-constructable default text style that provides fallback values.
const
Properties
- child → Widget
-
The widget below this widget in the tree.
finalinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- maxLines → int?
-
An optional maximum number of lines for the text to span, wrapping if necessary.
If the text exceeds the given number of lines, it will be truncated according
to overflow.
final
- overflow → TextOverflow
-
How visual overflow should be handled.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- softWrap → bool
-
Whether the text should break at soft line breaks.
final
- style → TextStyle
-
The text style to apply.
final
- textAlign → TextAlign?
-
How each line of text in the Text widget should be aligned horizontally.
final
- textHeightBehavior → TextHeightBehavior?
-
Defines how to apply TextStyle.height over and under text.
final
- textWidthBasis → TextWidthBasis
-
The strategy to use when calculating the width of the Text.
final
Methods
-
createElement(
) → InheritedElement -
Inflates this configuration to a concrete instance.
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
-
updateShouldNotify(
covariant DefaultTextStyle oldWidget) → bool -
Whether the framework should notify widgets that inherit from this widget.
override
-
wrap(
BuildContext context, Widget child) → Widget -
Return a copy of this inherited theme with the specified
child.override
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
merge(
{Key? key, TextStyle? style, TextAlign? textAlign, bool? softWrap, TextOverflow? overflow, int? maxLines, TextWidthBasis? textWidthBasis, TextHeightBehavior? textHeightBehavior, required Widget child}) → Widget - Creates a default text style that overrides the text styles in scope at this point in the widget tree.
-
of(
BuildContext context) → DefaultTextStyle - The closest instance of this class that encloses the given context.
