Giter VIP home page Giter VIP logo

richtext's Introduction

RichText

Android平台下的富文本解析器

  • 流式操作
  • 低侵入性
  • 支持Html和Markdown格式文本
  • 支持图片点击事件
  • 链接自动回调
  • 支持设置加载中和加载错误时的图片
  • 支持自定义超链接的点击回调
  • 支持修正图片宽高
  • 支持GIF图片

效果

演示

gradle中引用的方法

compile 'com.zzhoujay.richtext:richtext:2.0.4'

使用方式

RichText.from(text).into(textView);

Markdown:

RichText.fromMarkdown(markdown).into(textView);

高级

RichText
       .from(text) // 数据源
       .type(RichText.TYPE_MARKDOWN) // 数据格式,不设置默认是Html,使用fromMarkdown的默认是Markdown格式
       .autoFix(true) // 是否自动修复,默认true
       .async(true) // 是否异步,默认false
       .fix(imageFixCallback) // 设置自定义修复图片宽高
       .noImage(true) // 不显示并且不加载图片
       .imageClick(onImageClickListener) // 设置图片点击回调
       .urlClick(onURLClickListener) // 设置链接点击回调
       .placeHolder(placeHolder) // 设置加载中显示的占位图
       .error(errorImage) // 设置加载失败的错误图
       .into(textView); // 设置目标TextView

关于ImageHolder

ImageHolder是在设置了ImageFixCallback后回调方法中的一个参数,代表了每张图片

其属性有:

  • width : 图片宽度
  • height : 图片高度
  • scaleType : 缩放方式
  • imageType : 图片类型,JPG/PNG
  • autoFix : 自动修复宽高
  • autoPlay : 自动播放Gif图,在图片类型是Gif时有效
  • autoStop : 自动停止Gif图片的播放,在图片是Gif时有效
  • show : 是否显示

通过调用对应的getter和setter方法可以获取和设置ImageHolder的状态,并达到相应的功能

自定义修复宽高

RichText.from(text).fix(new ImageFixCallback() {
                @Override
                public void onFix(ImageHolder holder,boolean imageReady) {
                     if(imageReady){
                          return;
                     }
                     if(holder.getImageType()==ImageHolder.GIF){
                          holder.setWidth(400);
                          holder.setHeight(400);
                     }else {
                          holder.setAutoFix(true);
                     }
                }
             })

通过设置holder.setAutoFix(true)设置该图片为自动修复,自动修复的效果是图片按宽度充满,所有如果有些小的图片设置了自动填充可能会 失真,这时候可以取消自动修复设置自定义修复,将比较小的图片过滤出来,将其它的图片自动修复即可。

如下:

        RichText.from(text).autoFix(false).fix(new ImageFixCallback() {
            @Override
            public void onFix(ImageHolder holder, boolean imageReady) {
                if (holder.getWidth() > 500 && holder.getHeight() > 500) {
                    holder.setAutoFix(true);
                }
            }
        }).into(textView);

注意,如果img标签中没有宽高的话onFix方法会在图片加载完成前后调用两次,可以通过imageReady来判断

注意

  • gif图片播放在API12以下需要手动调用recycler,不然直到应用退出gif图片都会一直刷新
  • 目前只能自动通过src的后缀识别是否为gif图,可以通过设置ImageFixCallback对某个特点的图片设置为GIF ,例如:holder.setImageType(ImageHolder.GIF)
  • 解析Html文本时只支持Html.fromHtml能够解析的标签,自定义标签的支持后续会跟上的

后续计划

  • 添加自定义标签的支持

关于Markdown

Markdown源于子项目:Markdown

若在markdown解析过程中发现什么问题可以在该项目中反馈

具体使用请查看demo

ListView DemoRecyclerView DemoGif Demo

by zzhoujay

richtext's People

Contributors

zzhoujay avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.