CustomText constructor

const CustomText(String text, { Key? key, required List<Definition> definitions, CustomSpanBuilder? preBuilder, ParserOptions parserOptions = const ParserOptions(), TextStyle? style, TextStyle? matchStyle, TextStyle? tapStyle, TextStyle? hoverStyle, GestureCallback? onTap, GestureCallback? onLongPress, GestureCallback? onGesture, Duration? longPressDuration, bool preventBlocking = false, StrutStyle? strutStyle, TextAlign? textAlign, TextDirection? textDirection, Locale? locale, bool? softWrap, TextOverflow? overflow, TextScaler? textScaler, int? maxLines, String? semanticsLabel, TextWidthBasis? textWidthBasis, TextHeightBehavior? textHeightBehavior, Color? selectionColor, })

Creates a text widget that decorates substrings and enables tap, long-press and/or hover gestures on them based on flexible definitions.

This is useful for making certain portions of text such as URLs, email addresses or phone numbers clickable, or for only highlighting substrings with colours and different font settings.

CustomText(
  'URL: https://example.com/\n'
  'Email: [e-mail]\n'
  'Tel: [phone]',
  definitions: const [
    TextDefinition(matcher: UrlMatcher()),
    TextDefinition(matcher: EmailMatcher()),
    TextDefinition(matcher: TelMatcher()),
  ],
  matchStyle: const TextStyle(color: Colors.indigo),
  hoverStyle: const TextStyle(color: Colors.lightBlue),
  onTap: (details) => launchUrlString(details.actionText),
)

Implementation

const CustomText(
  String this.text, {
  super.key,
  required this.definitions,
  this.preBuilder,
  this.parserOptions = const ParserOptions(),
  this.style,
  this.matchStyle,
  this.tapStyle,
  this.hoverStyle,
  this.onTap,
  this.onLongPress,
  this.onGesture,
  this.longPressDuration,
  this.preventBlocking = false,
  this.strutStyle,
  this.textAlign,
  this.textDirection,
  this.locale,
  this.softWrap,
  this.overflow,
  this.textScaler,
  this.maxLines,
  this.semanticsLabel,
  this.textWidthBasis,
  this.textHeightBehavior,
  this.selectionColor,
}) : spans = null;