[SuperTextField] Add support for inline widgets (Resolves #2507)

super_editor/lib/src/super_textfield/android/android_textfield.dart

@@ -1,3 +1,4 @@
+import 'package:attributed_text/attributed_text.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:follow_the_leader/follow_the_leader.dart';
@@ -34,6 +35,7 @@ class SuperAndroidTextField extends StatefulWidget {
     this.textController,
     this.textAlign = TextAlign.left,
     this.textStyleBuilder = defaultTextFieldStyleBuilder,
+    this.inlineWidgetBuilders = const [],
     this.hintBehavior = HintBehavior.displayHintUntilFocus,
     this.hintBuilder,
     this.minLines,
@@ -69,6 +71,9 @@ class SuperAndroidTextField extends StatefulWidget {
   /// [textController] based on the attributions in that content.
   final AttributionStyleBuilder textStyleBuilder;
 
+  /// {@macro super_text_field_inline_widget_builders}
+  final InlineWidgetBuilderChain inlineWidgetBuilders;
+
   /// Policy for when the hint should be displayed.
   final HintBehavior hintBehavior;
 
@@ -606,7 +611,7 @@ class SuperAndroidTextFieldState extends State<SuperAndroidTextField>
 
   Widget _buildSelectableText() {
     final textSpan = _textEditingController.text.isNotEmpty
-        ? _textEditingController.text.computeTextSpan(widget.textStyleBuilder)
+        ? _textEditingController.text.computeInlineSpan(context, widget.textStyleBuilder, widget.inlineWidgetBuilders)
         : TextSpan(text: "", style: widget.textStyleBuilder({}));
 
     return SuperText(

super_editor/lib/src/super_textfield/desktop/desktop_textfield.dart

@@ -52,6 +52,7 @@ class SuperDesktopTextField extends StatefulWidget {
     this.tapRegionGroupId,
     this.textController,
     this.textStyleBuilder = defaultTextFieldStyleBuilder,
+    this.inlineWidgetBuilders = const [],
     this.textAlign = TextAlign.left,
     this.hintBehavior = HintBehavior.displayHintUntilFocus,
     this.hintBuilder,
@@ -93,6 +94,9 @@ class SuperDesktopTextField extends StatefulWidget {
   /// [textController] based on the attributions in that content.
   final AttributionStyleBuilder textStyleBuilder;
 
+  /// {@macro super_text_field_inline_widget_builders}
+  final InlineWidgetBuilderChain inlineWidgetBuilders;
+
   /// Policy for when the hint should be displayed.
   final HintBehavior hintBehavior;
 
@@ -497,7 +501,7 @@ class SuperDesktopTextFieldState extends State<SuperDesktopTextField> implements
   Widget _buildSelectableText() {
     return SuperText(
       key: _textKey,
-      richText: _controller.text.computeTextSpan(widget.textStyleBuilder),
+      richText: _controller.text.computeInlineSpan(context, widget.textStyleBuilder, widget.inlineWidgetBuilders),
       textAlign: widget.textAlign,
       textScaler: _textScaler,
       layerBeneathBuilder: (context, textLayout) {

super_editor/lib/src/super_textfield/infrastructure/attributed_text_editing_controller.dart

@@ -655,6 +655,7 @@ class AttributedTextEditingController with ChangeNotifier {
     notifyListeners();
   }
 
+  @Deprecated('Use text.computeInlineSpan() instead, which adds support for inline widgets.')
   TextSpan buildTextSpan(AttributionStyleBuilder styleBuilder) {
     return text.computeTextSpan(styleBuilder);
   }

super_editor/lib/src/super_textfield/ios/ios_textfield.dart

@@ -41,6 +41,7 @@ class SuperIOSTextField extends StatefulWidget {
     this.tapHandlers = const [],
     this.textController,
     this.textStyleBuilder = defaultTextFieldStyleBuilder,
+    this.inlineWidgetBuilders = const [],
     this.textAlign = TextAlign.left,
     this.padding,
     this.hintBehavior = HintBehavior.displayHintUntilFocus,
@@ -79,6 +80,9 @@ class SuperIOSTextField extends StatefulWidget {
   /// [textController] based on the attributions in that content.
   final AttributionStyleBuilder textStyleBuilder;
 
+  /// {@macro super_text_field_inline_widget_builders}
+  final InlineWidgetBuilderChain inlineWidgetBuilders;
+
   /// Padding placed around the text content of this text field, but within the
   /// scrollable viewport.
   final EdgeInsets? padding;
@@ -604,9 +608,8 @@ class SuperIOSTextFieldState extends State<SuperIOSTextField>
   }
 
   Widget _buildSelectableText() {
-    final textSpan = _textEditingController.text.isNotEmpty
-        ? _textEditingController.text.computeTextSpan(widget.textStyleBuilder)
-        : AttributedText().computeTextSpan(widget.textStyleBuilder);
+    final textSpan = _textEditingController.text //
+        .computeInlineSpan(context, widget.textStyleBuilder, widget.inlineWidgetBuilders);
 
     CaretStyle caretStyle = widget.caretStyle;
 

super_editor/lib/src/super_textfield/super_textfield.dart

@@ -62,6 +62,7 @@ class SuperTextField extends StatefulWidget {
     this.textController,
     this.textAlign = TextAlign.left,
     this.textStyleBuilder = defaultTextFieldStyleBuilder,
+    this.inlineWidgetBuilders = const [],
     this.hintBehavior = HintBehavior.displayHintUntilFocus,
     this.hintBuilder,
     this.controlsColor,
@@ -104,6 +105,14 @@ class SuperTextField extends StatefulWidget {
   /// [textController] based on the attributions in that content.
   final AttributionStyleBuilder textStyleBuilder;
 
+  /// {@template super_text_field_inline_widget_builders}
+  /// A Chain of Responsibility that's used to build inline widgets.
+  ///
+  /// The first builder in the chain to return a non-null `Widget` will be
+  /// used for a given inline placeholder.
+  /// {@endtemplate}
+  final InlineWidgetBuilderChain inlineWidgetBuilders;
+
   /// Policy for when the hint should be displayed.
   final HintBehavior hintBehavior;
 
@@ -361,6 +370,7 @@ class SuperTextFieldState extends State<SuperTextField> implements ImeInputOwner
           textController: _controller,
           textAlign: widget.textAlign,
           textStyleBuilder: widget.textStyleBuilder,
+          inlineWidgetBuilders: widget.inlineWidgetBuilders,
           hintBehavior: widget.hintBehavior,
           hintBuilder: widget.hintBuilder,
           selectionHighlightStyle: SelectionHighlightStyle(
@@ -395,6 +405,7 @@ class SuperTextFieldState extends State<SuperTextField> implements ImeInputOwner
             textController: _controller,
             textAlign: widget.textAlign,
             textStyleBuilder: widget.textStyleBuilder,
+            inlineWidgetBuilders: widget.inlineWidgetBuilders,
             hintBehavior: widget.hintBehavior,
             hintBuilder: widget.hintBuilder,
             caretStyle: widget.caretStyle ??
@@ -424,6 +435,7 @@ class SuperTextFieldState extends State<SuperTextField> implements ImeInputOwner
             textController: _controller,
             textAlign: widget.textAlign,
             textStyleBuilder: widget.textStyleBuilder,
+            inlineWidgetBuilders: widget.inlineWidgetBuilders,
             padding: widget.padding,
             hintBehavior: widget.hintBehavior,
             hintBuilder: widget.hintBuilder,

super_editor/test/super_textfield/super_textfield_attributions_test.dart

@@ -31,10 +31,12 @@ void main() {
         );
 
         // Ensure the text is colored orange.
-        expect(
-          SuperTextFieldInspector.findRichText().style!.color,
-          Colors.orange,
-        );
+        for (int i = 0; i <= 9; i++) {
+          expect(
+            SuperTextFieldInspector.findRichText().getSpanForPosition(TextPosition(offset: i))!.style!.color,
+            Colors.orange,
+          );
+        }
       });
 
       testWidgetsOnAllPlatforms("to partial text", (tester) async {