Merge remote-tracking branch 'upstream/master'

Author: erickok

README.md

@@ -185,6 +185,7 @@ Once the above issue is resolved, the aforementioned compromises will go away. C
 | `style` | A powerful API that allows you to customize the style that should be used when rendering a specific HTMl tag. |
 | `navigationDelegateForIframe` | Allows you to set the `NavigationDelegate` for the `WebView`s of all the iframes rendered by the `Html` widget. |
 | `customImageRender` | A powerful API that allows you to fully customize how images are loaded. |
+| `selectionControls` |  A custom text selection controls that allow you to override default toolbar and build toolbar with custom text selection options. See an [example](https://github.com/justinmc/flutter-text-selection-menu-examples/blob/master/lib/custom_menu_page.dart). |
 
 ### Getters:
 
@@ -293,7 +294,7 @@ Widget html = Html(
           style: (context.tree.element!.attributes['horizontal'] != null)
               ? FlutterLogoStyle.horizontal
               : FlutterLogoStyle.markOnly,
-          textColor: context.style.color,
+          textColor: context.style.color!,
           size: context.style.fontSize!.size! * 5,
         );
       },
@@ -803,14 +804,15 @@ Then, use the `customRender` parameter to add the widget to render Tex. It could
 Widget htmlWidget = Html(
   data: r"""<tex>i\hbar\frac{\partial}{\partial t}\Psi(\vec x,t) = -\frac{\hbar}{2m}\nabla^2\Psi(\vec x,t)+ V(\vec x)\Psi(\vec x,t)</tex>""",
   customRender: {
-    "tex": (_, __, ___, element) => Math.tex(
-      element.text,
+    "tex": (RenderContext context, _) => Math.tex(
+      context.tree.element!.text,
       onErrorFallback: (FlutterMathException e) {
         //return your error widget here e.g.
         return Text(e.message);
       },
     ),
-  }
+  },
+  tagsList: Html.tags..add('tex'),
 );
 ```
 

lib/flutter_html.dart

@@ -213,28 +213,39 @@ class SelectableHtml extends StatelessWidget {
 
   SelectableHtml({
     Key? key,
+    GlobalKey? anchorKey,
     required this.data,
     this.onLinkTap,
     this.onAnchorTap,
     this.onCssParseError,
     this.shrinkWrap = false,
     this.style = const {},
     this.tagsList = const [],
+    this.selectionControls
   }) : document = null,
+        assert(data != null),
+        _anchorKey = anchorKey ?? GlobalKey(),
         super(key: key);
 
   SelectableHtml.fromDom({
     Key? key,
+    GlobalKey? anchorKey,
     required this.document,
     this.onLinkTap,
     this.onAnchorTap,
     this.onCssParseError,
     this.shrinkWrap = false,
     this.style = const {},
     this.tagsList = const [],
+    this.selectionControls
   }) : data = null,
+        assert(document != null),
+        _anchorKey = anchorKey ?? GlobalKey(),
         super(key: key);
 
+  /// A unique key for this Html widget to ensure uniqueness of anchors
+  final GlobalKey _anchorKey;
+
   /// The HTML data passed to the widget as a String
   final String? data;
 
@@ -261,6 +272,10 @@ class SelectableHtml extends StatelessWidget {
   /// An API that allows you to override the default style for any HTML element
   final Map<String, Style> style;
 
+  /// Custom Selection controls allows you to override default toolbar and build custom toolbar
+  /// options
+  final TextSelectionControls? selectionControls;
+
   static List<String> get tags => new List<String>.from(SELECTABLE_ELEMENTS);
 
   @override
@@ -271,7 +286,7 @@ class SelectableHtml extends StatelessWidget {
     return Container(
       width: width,
       child: HtmlParser(
-        key: null,
+        key: _anchorKey,
         htmlData: doc,
         onLinkTap: onLinkTap,
         onAnchorTap: onAnchorTap,
@@ -286,6 +301,7 @@ class SelectableHtml extends StatelessWidget {
         imageRenders: defaultImageRenders,
         tagsList: tagsList.isEmpty ? SelectableHtml.tags : tagsList,
         navigationDelegateForIframe: null,
+        selectionControls: selectionControls,
       ),
     );
   }

lib/html_parser.dart

@@ -58,6 +58,7 @@ class HtmlParser extends StatelessWidget {
   final List<String> tagsList;
   final NavigationDelegate? navigationDelegateForIframe;
   final OnTap? _onAnchorTap;
+  final TextSelectionControls? selectionControls;
 
   HtmlParser({
     required this.key,
@@ -75,6 +76,7 @@ class HtmlParser extends StatelessWidget {
     required this.imageRenders,
     required this.tagsList,
     required this.navigationDelegateForIframe,
+    this.selectionControls
   })  : this._onAnchorTap = onAnchorTap != null
           ? onAnchorTap
           : key != null
@@ -125,6 +127,7 @@ class HtmlParser extends StatelessWidget {
           tree: cleanedTree,
           style: cleanedTree.style,
         ),
+        selectionControls: selectionControls,
       );
     }
     return StyledText(
@@ -1052,13 +1055,15 @@ class StyledText extends StatelessWidget {
   final RenderContext renderContext;
   final AnchorKey? key;
   final bool _selectable;
+  final TextSelectionControls? selectionControls;
 
   const StyledText({
     required this.textSpan,
     required this.style,
     this.textScaleFactor = 1.0,
     required this.renderContext,
     this.key,
+    this.selectionControls,
   }) : _selectable = false,
         super(key: key);
 
@@ -1068,6 +1073,7 @@ class StyledText extends StatelessWidget {
     this.textScaleFactor = 1.0,
     required this.renderContext,
     this.key,
+    this.selectionControls
   }) : textSpan = textSpan,
         _selectable = true,
         super(key: key);
@@ -1082,6 +1088,7 @@ class StyledText extends StatelessWidget {
         textDirection: style.direction,
         textScaleFactor: textScaleFactor,
         maxLines: style.maxLines,
+        selectionControls: selectionControls,
       );
     }
     return SizedBox(