SDHtmlTextView: A Java repository from fynngodau

The best HTML renderer I found.

It is forked to be included as a submodule and does not include the SDHtmlTextView class that the upstream project provides. The reason is that you probably want to write your own TextView implementation that makes use of HTMLSpanner if you want to render images. Get inspired by this one that I wrote for a project.

There appears to be a family of deveratives of some HTML spanner library, and this is the one I chose, because – even though its exact history is hard to make out – it appears to be based on NightWhistler/HtmlSpanner with some improvements.

This library supports rendering tables.

Usage

Add the library as a submodule
git submodule add https://github.com/fynngodau/SDHtmlTextView.git
Add the dependency to your app module's build.gradle: implementation 'it.sysdata.mobile:htmlspanner:+'

Substitute the dependency with your submodule in settings.gradle:

includeBuild('SDHtmlTextView') {
    dependencySubstitution {
        substitute module('it.sysdata.mobile:htmlspanner') using project(':HtmlSpanner')
    }
}

This section is copied from upstream's README.

Use HtmlSpanner in your TextView :

In the xml layout file define a simple TextView then in the Activity do

        String html=loadStringFromAssetFile(this,"example.html");
        TextView tv = (TextView) findViewById(R.id.text);
        int col=tv.getSolidColor();
        HtmlSpanner htmlSpanner=new HtmlSpanner(tv.getCurrentTextColor(), tv.getTextSize());
        htmlSpanner.setBackgroundColor(col);
        tv.setText(htmlSpanner.fromHtml(html));

If you want to handle href you need to add

        tv.setMovementMethod(LinkMovementMethod.getInstance());

You can alternatively use a builder to initialize the HtmlSpanner

        HtmlSpanner htmlSpanner = new HtmlSpanner.Builder()
                                    .textColor(tv.getCurrentTextColor())
                                    .textSize(tv.getTextSize())
                                    .backgroundColor(tv.getSolidColor())
                                    .tableHeaderCenter(isTableHeaderCentered)
                                    .build();

the builder possible parameters are:

textColor, this attribute is required since is used to initialize the htmlspanner with a custom text color;
textSize, this attribute is required since is used to initialize the htmlspanner with a custom text size;
backgroundColor, this attribute is required since is used to initialize the htmlspanner with a custom background color to handle html tags like "div" correctly;
tableHeaderCenter, if this attribute is set to false or true it will define the centering of the table header fields in tables, by default table header is centered.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

fynngodau/SDHtmlTextView

Usage

HTML Tags supported

CSS Tags supported

License