label property Null safety

Widget? label
final

Optional widget that describes the input field.

When the input field is empty and unfocused, the label is displayed on top of the input field (i.e., at the same location on the screen where text may be entered in the input field). When the input field receives focus (or if the field is non-empty), the label moves above (i.e., vertically adjacent to) the input field.

This can be used, for example, to add multiple TextStyle's to a label that would otherwise be specified using labelText, which only takes one TextStyle.

This example shows a TextField with a Text.rich widget as the label. The widget contains multiple Text widgets with different TextStyle's.
To create a local project with this code sample, run:
flutter create --sample=material.InputDecoration.label.1 mysample

Only one of label and labelText can be specified.

Implementation

final Widget? label;