Skip to content

A Flutter package that provides a WYSIWYG editor backed by flutter_inappwebview and the Summernote library.

License

Notifications You must be signed in to change notification settings

vadrian89/html-editor-plus

 
 

Repository files navigation

Flutter Html Editor Plus

pub package

Flutter HTML Editor Plus is a text editor for Android, iOS, and Web to help write WYSIWYG HTML code with the Summernote JavaScript wrapper.

This is a fork from html-editor-enhanced. A big thanks for tneotia, for keeping the project alive.

I have removed documentation and will updated with the new API in time.
In the meantime you can read it in the original repo.

Main goals of this package is to:

  • Keep the package updated to latest stable versions of Flutter and dependencies (Summernote editor included).
  • Re-write the package in a more readable and maintanable format.
  • Improve functionalities.
  • Fix known issues.
  • Add support for desktop platforms.

Setup

Platform requirements for:
Android: minSdkVersion >= 19, compileSdk >= 34, AGP version >= 7.3.0
iOS 9.0+: --ios-language swift, Xcode version >= 14.3
MacOS 10.11+: Xcode version >= 14.3

Migration guide for InAppWebView

Add html_editor_plus: ^0.0.1 as dependency to your pubspec.yaml.

Make sure to declare internet support inside AndroidManifest.xml: <uses-permission android:name="android.permission.INTERNET"/>

Additional setup is required on iOS to allow the user to pick files from storage. See here for more details.

For images, the package uses FileType.image, for video FileType.video, for audio FileType.audio, and for any other file FileType.any. You can just complete setup for the specific buttons you plan to enable in the editor.

Basic Usage

import 'package:html_editor/html_editor.dart';

HtmlEditorController controller = HtmlEditorController();

@override 
Widget build(BuildContext context) {
    return HtmlEditor(
        controller: controller, //required
        htmlEditorOptions: HtmlEditorOptions(
          hint: "Your text here...",
          //initalText: "text content initial, if any",
        ),   
        otherOptions: OtherOptions(
          height: 400,
        ),
    );
}

Important note for Web:

At the moment, there is quite a bit of flickering and repainting when having many UI elements draw over IframeElements. See flutter/flutter#71888 for more details.

The current workaround is to build and/or run your Web app with flutter run --web-renderer html and flutter build web --web-renderer html.

Follow flutter/flutter#80524 for updates on a potential fix, in the meantime the above solution should resolve the majority of the flickering issues.

API Reference

For the full API reference, see here.

For a full example, see here.

PLUS version

The PLUS version is the current package re-written using current Flutter version, standard and patterns.
While some similiarities will remain, most of the API will be different.

Keep in mind that the new version is WORK IN PROGRESS. This means that the breaking changes will most likely occur on every release!

Some noteable changes in the new API (WIP)

HtmlEditorController

Is implemented similar to other Flutter controllers, meaning it extends ValueNotifier and the value will be stored into a HtmlEditorValue.

Side effects of this change:

  • If initialised, the controller, will require manual disposal through dispose() method;
  • Listeners can be attached to the controller to react when the value has changed;
  • The value can be used with ValueListenableBuilder.
  • Some methods have been renamed, and method signatures have changed to use named parameters.

Other changes

Features removed:

  • Developers will not have access to InAppWebViewController, because the editor means to be a common interface for different platforms. As such it makes no sense to expose the controller for mobile. At least not in the current phase.
  • Editor notifications will not be implemented. The editor should be exactly that, a HTML RICH text editor which outputs the text as a HTML string. Notifications should be implemented, separately, through Flutter.

Implementation progress

  • Editor field which accepts HTML code
  • Controller which supports the original API
  • Theme-based CSS, with CSS builder available to developers
  • JavaScript builder property which allows developers to add custom JavaScript code
  • Summernote callbacks
  • Editor toolbar
  • Summernote mentions
  • macOS support using InAppWebView
  • Custom editor events
  • Custom editor callbacks

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contribution Guide

PRs are always welcome

About

A Flutter package that provides a WYSIWYG editor backed by flutter_inappwebview and the Summernote library.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dart 95.6%
  • JavaScript 2.7%
  • HTML 0.7%
  • Ruby 0.3%
  • CSS 0.2%
  • Objective-C 0.2%
  • Other 0.3%