DefaultTextStyle class - widgets library (original) (raw)

The text style to apply to descendant Text widgets which don't have an explicit style.

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.