#Features
- Uses min SDK 7 which is Android 2.1 (Tested on a device running Android 2.2)
- Bootstrap buttons as per Bootstrap v3
- Rounded buttons
- Disabled buttons
- Various sized buttons (large to extra small)
- Just text buttons
- Left, right, left and right, or just icon button
- Font Awesome text as per Font Awesome v4
- Animations to Font Awesome Text items
- EditText backgrounds
#Coming Soon...
- tabs
- working with the action bar
#Installation
download the AndroidBootstrap library, import the library into your Android workspace, on the project you wish to use it in right click properties, add AndroidBootstrap as a library!
WARNING: YOU MUST ALSO INCLUDE THE fontawesome-webfont.ttf FILE INTO YOUR OWN PROJECTS ASSETS FOLDER
In each layout file, paste the following two lines below xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:androidbootstrap="http://schemas.android.com/apk/res-auto"
xmlns:fontawesometext="http://schemas.android.com/apk/res-auto"
#How to use
<!-- basic button -->
<com.beardedhen.androidbootstrap.BootstrapButton
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Default"
androidbootstrap:type="default"
androidbootstrap:icon_left="fa-heart"
android:layout_margin="10dp"
/>
The above code inserts a default button with a heart icon to the left. The following attributes can be added to any BootstrapButton
androidbootstrap:type="default"
The type of button as per the Bootstrap CSS Buttons
androidbootstrap:icon_left="fa-heart"
the icon to the left of the text, as per the Font Awesome Cheat Sheet
androidbootstrap:icon_right="fa-trophy"
the icon to the right of the text, as per the Font Awesome Cheat Sheet
androidbootstrap:roundedCorners="true"
whether the button should have rounded corners, the defaults is false
android:enabled="false"
disabled buttons appear more opaque, the default is true (buttons are enabled)
androidbootstrap:size="large"
Size of the button as per Bootstrap CSS Button sizes
android:textSize="12sp"
Text size must always be in sp!
#Font Awesome Text
<!-- basic text-->
<com.beardedhen.androidbootstrap.FontAwesomeText
android:layout_width="wrap_content"
android:layout_height="wrap_content"
fontawesometext:icon="fa-github"
android:layout_margin="10dp"
android:textSize="32sp"
/>
fontawesometext:icon="fa-github"
the icon to place, as per the Font Awesome Cheat Sheet
android:textSize="12sp"
Text size must always be in sp!
android:textColor="@color/bbutton_primary"
you can change the textColor or background to any color, including the Bootstrap colours by typing bbutton_ and the type of colour e.g. bbutton_danger for the red danger colour.
#Animations
//get access to some FontAwesomeText items in the layout
FontAwesomeText tv1 = (FontAwesomeText) findViewById(R.id.lblOne);
FontAwesomeText tv2 = (FontAwesomeText) findViewById(R.id.lblTwo);
FontAwesomeText tv3 = (FontAwesomeText) findViewById(R.id.lblThree);
//flashing forever FAST
tv1.startFlashing(this, true, FontAwesomeText.AnimationSpeed.FAST);
//rotating clockwise slowly
tv2.startRotate(this, true, FontAwesomeText.AnimationSpeed.SLOW);
//rotating anti-clockwise at medium speed
tv3.startRotate(this, false, FontAwesomeText.AnimationSpeed.MEDIUM);
##Flashing Animations
startFlashing(Context context, boolean forever, AnimationSpeed speed);
@param context the current applications context
@param forever whether the item should flash repeatedly or just once
@param speed how fast the item should flash, chose between FontAwesomeText.AnimationSpeed.SLOW / FontAwesomeText.AnimationSpeed.MEDIUM / FontAwesomeText.AnimationSpeed.FAST
startRotate(Context context, boolean clockwise, AnimationSpeed speed);
@param context the current applications context
@param clockwise true for clockwise, false for anti clockwise spinning
@param speed how fast the item should flash, chose between FontAwesomeText.AnimationSpeed.SLOW / FontAwesomeText.AnimationSpeed.MEDIUM / FontAwesomeText.AnimationSpeed.FAST
#EditText
There are two drawable items
- @drawable/edittext_background
- @drawable/edittext_background_rounded
#Examples
Please find included an AndroidBootstrapTest project. Inside the activity_main.xml layout file is examples of how to achieve each of the following buttons:
Bootstrap Buttons
Rounded Bootstrap Button
Others
Sizes
Disabled
Font Awesome Text
EditText