Skip to content

Latest commit

 

History

History
160 lines (115 loc) · 4.66 KB

README.md

File metadata and controls

160 lines (115 loc) · 4.66 KB

PoorEdit

Android Arsenal

Rich Text Editor for Android

Status

WIP. So those who forked this repo may need to merge my code manually.

Buggy but almost there!

Screenshots

I'm tring to make it look & feel like you are still in Evernote



Features

  • Basic text editing
  • Bold
  • Italic
  • Underline
  • Highlight
  • Strike through
  • Images
  • File attachments
  • Todo lists
  • Lists
  • JSON export
  • JSON import

Usage

Setup

This project is still working in progress and I do NOT recommend using it in production env.

After check out this repo, you will get a test project and PoorEdit widget is located in pooredit folder. Import this folder as module in Android Studio.

Put below code in your layout xml file.

<sun.bob.pooredit.PoorEdit
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/id_poor_edit"/>

And in the Activity which contains this widget, you may need to override onActivityResult function as below.

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data){
    poorEdit.onActivityResult(requestCode, resultCode, data);
    //Write your code below.
}

The reason for that is PoorEdit need to start image picking or file picking activities and it will require picking result after those activities finished.

That's all you need to do to initialize a shinny tinny rich editor.

Export & Import

PoorEdit support json export and import.

You can take the sample project as reference or use below two functions.

PoorEdit.exportJSON(String jsonFolder)
PoorEdit.loadJson(String jsonFolder)

Both functions require an string arguement which is the folder where the json file will be.

PoorEdit will create a content.json in that folder. The reason why we need a folder is, I think you may want to copy files, images and other stuff in editor to one folder. That's make the folder a notebook, which you can upload those files to a webserver or something. Notice, PoorEdit dose NOT contains the upload part. It even doesn't require an Internet permission.

Below is the complete import & export code in sample project.

@Override
    public boolean onOptionsItemSelected(MenuItem item) {
        int id = item.getItemId();
        //Do the export.
        if (id == R.id.action_exp) {
            ((PoorEdit) findViewById(R.id.id_poor_edit)).exportJSON("/sdcard/pooredit/debug/");
            return true;
        }
        //Do the import.
        if (id == R.id.action_imp){
            ((PoorEdit) findViewById(R.id.id_poor_edit)).loadJson("/sdcard/pooredit/debug/");
        }

        return super.onOptionsItemSelected(item);
    }

When you click those menu items, a json file located in /sdcard/pooredit/debug/content.json will be created / loaded.

ImageLoader Interface

When adding images to PoorEdit, it may cause an OOM when images are too large or too many.

So, I secured a image loader interface to let you using your favorite image loaders to manage the loading & caching process.

You need to implement ImageLoaderItf and pass it to PoorEdit. Thus when PoorEdit need to decode or loading images, it will call this interface.

By default, PoorEdit will call ImageView.setImageBitmap directly without any loading or caching control.

    Image.ImageLoaderItf itf = new Image.ImageLoaderItf() {
        @Override
        public void loadImage(ImageView imageView, String image, int imageWidth) {
			//call your image loader here.
        }
    };
    
    poorEdit.setImageLoader(itf);
    //Do NOT use below code!
    //poorEdit.imageLoaderItf = itf;
    //I've noticed this is not a good design so it will be fixed soon!
    //setImageLoader method will remains and the static ImageLoaderItf field is not guaranteed!

Todos

  • UI tweaks.
  • Bug fix.
  • Add voices.
  • Add handwritings
  • Font & Colors

Why

To be honest I always thinking about writing a rich text editor on Android.

There are lots of brilliant projects on GitHub.

But still, I wondering whether I can do it or not.

So here we are.

I take Evernote's edit widget as a reference.

I didn't use webview in this widget.

All code are written in pure Java.

And I have to say to writing a complex widget like that is so hard for just one guy.

So,

ANY PULL REQUSTS IS WELCOME!

THANKS IN ADVANCE!

Credits

Icons from icons8.com

License

Good Boy License

Please do whatever your mom would approve of.