PopupBubble

Easily Add "New Post" popup button with the feeds (recyclerview) of your app.

<img src="http://www.webianks.com/popupbubble/2.png" align="left" height="700" width="400" > <img src="http://www.webianks.com/popupbubble/3.png" height="700" width="400" >

Min SDK

Minimum sdk is 14 and support is limited to recyclerview for now.

Add With Gradle Dependency

groovyCopy
compile 'com.webianks.library:popup-bubble:1.0.5'

Maven:

xmlCopy
<dependency>
  <groupId>com.webianks.library</groupId>
  <artifactId>popup-bubble</artifactId>
  <version>1.0.5</version>
  <type>pom</type>
</dependency>

Add PopupBubble to layout

xmlCopy
<com.webianks.library.PopupBubble
  android:id="@+id/popup_bubble"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
/>

Positioning of this view can be done according to the need. By default it should be placed in <b>top center</b>. Also it should be placed <b>below recyclerview</b> in layout so that it shows on top of recyclerview.

Example positioning

If its inside RelativeLayout then

xmlCopy
<com.webianks.library.PopupBubble
  android:layout_margin="16dp"
  android:id="@+id/popup_bubble"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:layout_centerHorizontal="true"
/>

Customization Through XML

xmlCopy
<!--Change background Color-->
    app:pb_backgroundColor="?attr/colorPrimary"
<!--Change text -->
    app:pb_text="New Stories"
<!--Change text color-->
    app:pb_textColor="#ffffff"
<!--Show/Hide Icon inside the button. By default its true.-->
    app:pb_showIcon="false"
<!--Change icon color-->
    app:pb_iconColor="#ffffff"
<!--Set Different Icons-->
    app:pb_icon="@drawable/ic_new.png"
<!--Set different fonts-->
    app:pb_font="iran_sans_mobile.ttf"
        

Example : Full Customization

xmlCopy
<com.webianks.library.PopupBubble
  xmlns:app="http://schemas.android.com/apk/res-auto"
  android:layout_margin="16dp"
  android:id="@+id/popup_bubble"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:layout_centerHorizontal="true"
  app:pb_backgroundColor="?attr/colorPrimary"
  app:pb_iconColor="#ffffff"
  app:pb_text="New Stories"
  app:pb_textColor="#ffffff"
  app:pb_icon="@drawable/ic_keyboard_arrow_up_white_18dp"
  app:pb_font="iran_sans_mobile.ttf"
/>

#Access the bubble from Java

javaCopy
PopupBubble popupBubble = (PopupBubble) findViewById(R.id.popup_bubble);

Add listener if you want to know when the bubble is clicked

javaCopy
popupBubble.setPopupBubbleListener(new PopupBubble.PopupBubbleClickListener() {
            @Override
            public void bubbleClicked(Context context) {
  
                //popup_bubble is clicked  
            }
        });

Attach with your RecyclerView

javaCopy
 //necessary to add
popupBubble.setRecyclerView(recyclerView);

#Helper Methods
Hide/Show PopupBubble according to your need

javaCopy
popupBubble.hide();
popupBubble.show();

Control Animations
Set false if you dont want any animations. Default value is true.

javaCopy
popupBubble.withAnimation(false);

Update text dynamically
Call this method before the activate method to set the new text.

javaCopy
popupBubble.updateText("10 new stories");

Update icon dynamically
Call this method before the activate method to set the new Icon.

javaCopy
popupBubble.updateIcon(R.drawable.new_icon);

Update typeface of text dynamically
Call this method before the activate method to set the new Typeface.

javaCopy
popupBubble.updateTypeFace(myCustomTypeface);

Most Important

Now <b>download/fetch new content</b> in background and then notify your recyclerview adapter about range of items added and finally <b>activate the PopupBubble</b> to make it appear with animation (if not set false).

javaCopy

//Own logic for fetching new content
 .....      
adapter.notifyItemRangeInserted(0,size_of_new_items_added); // size_of_new_items_added = 10 if 10 new items are added.
popupBubble.activate(); 
    

License

PopupBubble library for Android
Copyright (c) 2016 Ramankit Singh (http://github.com/webianks).

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.