TextLayoutBuilder
Build text Layouts easily on Android.
Features
- Create text
Layouts easily. - Reuse builders to create similarly styled
Layouts. - Cache
Layouts of commonly used strings. - Improve performance by warming up the FreeType cache.
Download
If using Gradle, add this to your build.gradle:
compile 'com.facebook.fbui.textlayoutbuilder:textlayoutbuilder:1.7.0'or, if using Maven:
<dependency>
<groupId>com.facebook.fbui.textlayoutbuilder</groupId>
<artifactId>textlayoutbuilder</artifactId>
<version>1.7.0</version>
<type>aar</type>
</dependency>Usage
- Set the properties on the
TextLayoutBuilder:
TextLayoutBuilder builder = new TextLayoutBuilder()
.setText("TextLayoutBuilder makes life easy")
.setTextColor(Color.BLUE)
.setWidth(400 /*, MEASURE_MODE_EXACTLY */);- Call
build()on the builder to get aLayout:
Layout layout = builder.build();- Use the
Layoutin your code:
public class CustomView extends View {
private Layout layout;
public CustomView(Context context) {
super(context);
}
public void setLayout(Layout layout) {
this.layout = layout;
}
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
// Draw the layout.
layout.draw(canvas);
}
}Additional Usage
- Cache the layouts for commonly used strings by turning on caching in the
TextLayoutBuilder.
textLayoutBuilder.setShouldCacheLayout(true);- Glyph warming provides significant performance boost for large blurbs of text. Turn this on and pass in a
GlyphWarmerfor theTextLayoutBuilder.
textLayoutBuilder
.setShouldWarmText(true)
.setGlyphWarmer(new GlyphWarmerImpl());- Import a style defined in XML into a
TextLayoutBuilderobject.
ResourceTextLayoutHelper.updateFromStyleResource(
textLayoutBuilder, // builder object
context, // Activity context
resId); // style resource idLicense
TextLayoutBuilder is Apache-2-licensed.