Skip to content

RyanLyu/Android-Bootstrap

 
 

Repository files navigation

Android-Bootstrap

alt text

#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

Rotation Animation

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

alt text

Rounded Bootstrap Button

alt text

Others

alt text

Sizes

alt text

Disabled

alt text

Font Awesome Text

alt text

EditText

alt text

About

Bootstrap style buttons with Font Awesome

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published