Lettrine

Additional

Language
Kotlin
Version
1.0.0 (May 20, 2016)
Created
Apr 25, 2016
Updated
May 31, 2016 (Retired)
Owner
Rémi Pradal (rpradal)
Contributor
Rémi Pradal (rpradal)
1
Activity
Badge
Generate
Download
Source code

Lettrine

Lettrine is a library that let you display TextView with an initial first letter.

Features

  • Select how many lines your initial should use
  • Choose the text font
  • Change the text size
  • Change the text color
  • Display Spanned text

Examples

The following screenshots illustrate the library capabilities listed above :

Lettrine with a three lines height Lettrine with a two lines height Font customization Html balisis inclusion Custom text color

Including in your project

Here is an example of how you can a LettrineTextView in your project :

  <com.github.rpradal.lettrine.LettrineTextView
              android:layout_width="fill_parent"
              android:layout_height="wrap_content"
              app:lettrine_textColor="@android:color/holo_red_dark"
              app:lettrine_text="Lorem ipsum"
              app:lettrine_lettrineSize="3"
              app:lettrine_textSize="14sp" />

The exhaustive attribute list of a LettrineTextView is the following :

  • lettrine_textSize Body text size
  • lettrine_lettrineSize Number of body lines the lettrine will take
  • lettrine_font The font to use (applied to both lettrine letter and body text)
  • lettrine_textColor Text color (applied to both lettrine letter and body text)
  • lettrine_text Text to display in the LettrineTextView

Of course all these attributes are settable programatically thanks to public methods.

Configuration

Add the following line in your gradle dependencies block.

  compile 'com.github.rpradal.lettrine:lettrine:release_number'

release_number has to be replaced with the current lettrine version: <img src="https://maven-badges.herokuapp.com/maven-central/com.github.rpradal.lettrine/lettrine/badge.svg"

License

Project developed with LeMonde.fr and Octo Technology support.

  Copyright 2016 Le Monde.fr 

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