Skip to content

Latest commit

 

History

History
188 lines (153 loc) · 5.49 KB

README.md

File metadata and controls

188 lines (153 loc) · 5.49 KB

SDHtmlTextView

Inspired by:

SDHtmlTextView use HTMLSpanner to display properly in TextViews an html page, overriding Html.fromHtml() and handling some CSS style inline properties.

HTML Tags supported

  • <i>
  • <em>
  • <cite>
  • <dfn>
  • <b>
  • <strong>
  • <blockquote>
  • <ul>
  • <ol>
  • <tt>
  • <code>
  • <style>
  • <br>
  • <p>
  • <div>
  • <span>
  • <big>
  • <small>
  • <pre>
  • <sub>
  • <sup>
  • <center>
  • <li>
  • <font size="..." color="..." face="...">
  • <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
  • <a href="...">
  • <img src="...">
  • <table>
  • <u>
  • <hr/>

CSS Tags supported

  • color
  • background-color
  • align
  • text-align
  • font-weight
  • font-style
  • font-family
  • font-size
  • line-height only with measures in px
  • margin-bottom
  • margin-top
  • margin-left
  • margin-right
  • margin
  • text-indent
  • display
  • border-style
  • border-color
  • border-width
  • border
  • text-decoration only underline and line-through

Usage

1. If you already have an implementation of TextView you could simply use HtmlSpanner, that wrap only the html code and convert it to a spannable string.

1.1. Add the library as a dependency

1.1.1 in Project level build.gradle add those repositories

   maven { url  'https://dl.bintray.com/sysdata/maven' }
   maven { url 'http://repo.pageturner-reader.org' }
   mavenCentral()

1.1.2 in your App level build.gradle add this dependecy

    implementation 'it.sysdata.mobile:htmlspanner:1.0.2'
    implementation 'net.sourceforge.htmlcleaner:htmlcleaner:2.16'

1.2 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.

2. Alternatively you can use an SDHtmlTextView which is a custom TextView that integrates HtmlSpanner to handle html texts :

2.1 Add the library as a dependency

2.1.1 in Project level build.gradle add those repositories

   maven { url  'https://dl.bintray.com/sysdata/maven' }
   maven { url 'http://repo.pageturner-reader.org' }
   mavenCentral()

2.1.2 in your App level build.gradle add this dependecy

    implementation 'it.sysdata.mobile:htmltextview:1.0.0'
    implementation 'net.sourceforge.htmlcleaner:htmlcleaner:2.16'

2.2 add the SDHtmlTextView via xml and then in your code set the html

kotlin:

        String html=loadStringFromAssetFile(this,"example.html")
        htmlTextView.htmlText = html

java:

        String html=loadStringFromAssetFile(this,"example.html");
        SDHtmlTextView htmlTextView = (SDHtmlTextView) findViewById(R.id.text);
        htmlTextView.setHtmlText(html);

2.3 if you want to override html table header centering behaviour you need to add this attribute "tableHeaderCentered" you can add via xml

    <com.sysdata.kt.htmltextview.SDHtmlTextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:tableHeaderCentered="false"/>

or in the code in this way

kotlin:

        textView.isTableHeaderCentered = false

java:

        textView.setTableHeaderCentered(false)

License

Copyright (C) 2017 Sysdata S.p.A.

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.