Add support for html string loading

Author: didarul-codes

CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.2.0
+* Added support for HTML string loading
+
 ## 1.1.2
 * Removed redundant isolate uses
 * Removed flutter version constraint in pubspec.yaml

README.md

@@ -46,18 +46,22 @@ It's better to warm up the controller before displaying the webview. It's possib
   Supported params of [AdBlockerWebview](https://pub.dev/documentation/adblocker_webview/latest/adblocker_webview/AdBlockerWebview-class.html]) are:
   ```dart
   const AdBlockerWebview({
-      super.key,
-      required this.url,
-      required this.adBlockerWebviewController,
-      required this.shouldBlockAds,
-      this.onLoadStart,
-      this.onLoadFinished,
-      this.onProgress,
-      this.onLoadError,
-      this.onTitleChanged,
-      this.options,
-      this.additionalHostsToBlock = const [],
-  });
+        required this.adBlockerWebviewController,
+        required this.shouldBlockAds,
+        this.url,
+        this.initialHtmlData,
+        this.onLoadStart,
+        this.onLoadFinished,
+        this.onProgress,
+        this.onLoadError,
+        this.onTitleChanged,
+        this.options,
+        this.additionalHostsToBlock = const [],
+        super.key,
+        }) : assert(
+            (url == null && initialHtmlData != null) ||
+            (url != null && initialHtmlData == null),
+            'Both url and initialHtmlData can not be non null');
 ```
 #### Caching
 - API response for Ad hosts is cached automatically and no config is required!

lib/src/adblocker_webview.dart

@@ -8,21 +8,27 @@ import 'package:flutter_inappwebview/flutter_inappwebview.dart';
 /// appear inside of the webpages.
 class AdBlockerWebview extends StatefulWidget {
   const AdBlockerWebview({
-    required this.url,
     required this.adBlockerWebviewController,
     required this.shouldBlockAds,
-    super.key,
+    this.url,
+    this.initialHtmlData,
     this.onLoadStart,
     this.onLoadFinished,
     this.onProgress,
     this.onLoadError,
     this.onTitleChanged,
     this.options,
     this.additionalHostsToBlock = const [],
-  });
+    super.key,
+  }) : assert(
+            (url == null && initialHtmlData != null) ||
+                (url != null && initialHtmlData == null),
+            'Both url and initialHtmlData can not be non null');
 
   /// Required: The initial [Uri] url that will be displayed in webview.
-  final Uri url;
+  final Uri? url;
+
+  final String? initialHtmlData;
 
   /// Required: The controller for [AdBlockerWebview].
   /// See more at [AdBlockerWebviewController].
@@ -110,6 +116,9 @@ class _AdBlockerWebviewState extends State<AdBlockerWebview> {
       onLoadStop: widget.onLoadFinished,
       onLoadError: widget.onLoadError,
       onTitleChanged: widget.onTitleChanged,
+      initialData: widget.initialHtmlData == null
+          ? null
+          : InAppWebViewInitialData(data: widget.initialHtmlData!),
     );
   }
 }

lib/src/adblocker_webview_controller.dart

@@ -55,6 +55,12 @@ abstract class AdBlockerWebviewController implements InternalWebviewController {
   // Loads the given url
   Future<void> loadUrl(String url);
 
+  Future<void> loadData(
+    String data, {
+    String mimeType = 'text/html',
+    String encoding = 'utf8',
+  });
+
   /// Navigates webview to previous page
   Future<void> goBack();
 

lib/src/adblocker_webview_controller_impl.dart

@@ -97,6 +97,22 @@ class AdBlockerWebviewControllerImpl implements AdBlockerWebviewController {
         .loadUrl(urlRequest: URLRequest(url: Uri.parse(url)));
   }
 
+  @override
+  Future<void> loadData(
+    String data, {
+    String mimeType = 'text/html',
+    String encoding = 'utf8',
+  }) async {
+    if (_inAppWebViewController == null) {
+      return;
+    }
+    return _inAppWebViewController!.loadData(
+      data: data,
+      mimeType: mimeType,
+      encoding: encoding,
+    );
+  }
+
   @override
   Future<void> reload() async {
     if (_inAppWebViewController == null) {

pubspec.yaml

@@ -2,7 +2,7 @@ name: adblocker_webview
 description: A webview for flutter with adblocking capability. It's currently based on Flutter InAppWebview Plugin.
 repository: https://github.com/islamdidarmd/flutter_adblocker_webview
 issue_tracker: https://github.com/islamdidarmd/flutter_adblocker_webview/issues
-version: 1.1.2
+version: 1.2.0
 homepage: https://github.com/islamdidarmd/flutter_adblocker_webview
 
 environment: