PeekAndPop


Source link: https://github.com/shalskar/PeekAndPop

PeekAndPop

PeekAndPop is an open source Android library, inspired by Instagram's latest 3D touch feature. As 3D touch is not available for android, this library uses long hold.

Peek and pop allows you to long click on a view to "peek" and see a larger view in the centre of the screen. The pop feature can be imitated using fling to action gestures or from a hold and release event.

Features:

  • Create a basic peek and pop that shows on long click and is dismissed on touch up.
  • Fling to action, where flinging the view upwards or downwards (sidewards in landscape) triggers an event.
  • Specify views within the peek view layout that can listen to long hold events (if the user holds the view for a certain amount of time).
  • Specify views within the peek view layout that can listen to hold and release events (where the user holds the view and then releases).

Demo app

https://github.com/shalskar/PeekAndPopDemo


Getting started:

This library is hosted on Jitpack.io, which means to use it you will have to add the following to your root build.gradle file.

allprojects {
  repositories {

...
maven {
 url "https://jitpack.io" 
}
  
}
 
}

And then you will need to add the following dependency to your applications build.gradle file.

dependencies {
  compile 'com.github.shalskar:PeekAndPop:1.1.0' 
}

Usage:

Basic usage is easy, simply provide an activity instance, a layout resource for the peek and pop and 1 or more views that will show the peek and pop when long clicked.

PeekAndPop peekAndPop = new PeekAndPop.Builder(this)

  .peekLayout(R.layout.peek_view)

  .longClickViews(view)

  .build();

You can get the peek view by calling getPeekView() on the PeekAndPop object, and use findViewById() to get access any views in the peek layout.

View peekView = peekAndPop.getPeekView();
 ImageView imageView = peekView.findViewById(R.id.image_view);
 TextView textView = peekView.findViewById(R.id.text_view);

Often you will want to have the peek and pop shown when an item in a list (or other scrollable view) is clicked on, to ensure the peek and pop works correctly, you will have to add this line of code:


 .parentViewGroupToDisallowTouchEvents(viewGroup)

More options:

Listening for peek or pop events


You can set an OnGeneralActionListener to receive onPeek() and onPop() events:

.onGeneralActionListener(new PeekAndPop.OnGeneralActionListener() {

@Override

public void onPeek(View longClickView, int position) {

 
}

 @Override

public void onPop(View longClickView, int position) {

 
}
 
}
)

The parameters being the view that was long clicked and the position of that view.

Listening for fling to action events


If you provide an OnFlingToActionListener then you will automatically be able to fling the view upwards or downwards and listen for those events:

.onFlingToActionListener(new PeekAndPop.OnFlingToActionListener() {

@Override

public void onFlingToAction(View longClickView, int position, int direction) {

 
}
 
}
)

The parameters being the same as above and the direction in which the view was flung. ( FLUNG_UPWARDS or FLUNG_DOWNWARDS.)

If you only want to listen for one direction you can set that like so:

.flingTypes(true, false)

And if you don't want to animate the view when flinging:

.animateFling(false)
Listening for hold, leave and release events


Similar to Instagram, you can specify views inside the peek layout that will trigger events if the user holds, leaves or releases on them:

.onHoldAndReleaseListener(new PeekAndPop.OnHoldAndReleaseListener() {

@Override

public void onHold(View view, int position) {

 
}

@Override

public void onLeave(View view, int position) {

 
}

@Override

public void onRelease(View view, int position) {

 
}
 
}
)

And then you must specify the id's of the views you would like to receive events from after you have built the PeekAndPop object:

peekAndPop.addHoldAndReleaseView(R.id.view);
 peekAndPop.addHoldAndReleaseView(R.id.view2);
Listening for long hold events


You can specify views inside the peek layout that will trigger an event if the user holds their finger/thumb over the view for a certain duration (default is 850ms). If receiveMultipleEvents is true than events will be contiuously triggered until the user moves their finger/thumb off the view:

onEnter events are also fired when the user's touch first enters the view's bounds.

.onLongHoldListener(new PeekAndPop.OnLongHoldListener() {

@Override

public void onEnter(View view, int position) {

 
}

@Override

public void onLongHold(View view, int position) {

 
}
 
}
)

And then you must specify the id's of the views you would like to receive events from after you have built the PeekAndPop object, aswell as a boolean argument whether or not you want to receive multiple events:

peekAndPop.addLongHoldView(R.id.view, true);
 peekAndPop.addLongHoldView(R.id.view, false);

The second argument determines whether the view will send multiple events or not. If false, then the user must move their finger/thumb off the view then back on to trigger another event.

License

Copyright 2016 Vincent Te Tau  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. 

Resources

Forms, data validation... They can be annoying sometimes. This library is here to try to help you out. AndroidForms aims to be a simple, Generic form library for android. At it's core, there aren't even any dependencies! You could easily move Source, Drain, and Form into any project you'd like.

Crazy easy to use RecyclerView Adapter for Reactive Applications.

Reactive spice added to Android's network service discovery API.

Android Layout (Relative Layout, Linear Layout etc) to Image.

Android postfix plugin for AndroidStudio.

Topics


2D Engines   3D Engines   9-Patch   Action Bars   Activities   ADB   Advertisements   Analytics   Animations   ANR   AOP   API   APK   APT   Architecture   Audio   Autocomplete   Background Processing   Backward Compatibility   Badges   Bar Codes   Benchmarking   Bitmaps   Bluetooth   Blur Effects   Bread Crumbs   BRMS   Browser Extensions   Build Systems   Bundles   Buttons   Caching   Camera   Canvas   Cards   Carousels   Changelog   Checkboxes   Cloud Storages   Color Analysis   Color Pickers   Colors   Comet/Push   Compass Sensors   Conferences   Content Providers   Continuous Integration   Crash Reports   Credit Cards   Credits   CSV   Curl/Flip   Data Binding   Data Generators   Data Structures   Database   Database Browsers   Date &   Debugging   Decompilers   Deep Links   Dependency Injections   Design   Design Patterns   Dex   Dialogs   Distributed Computing   Distribution Platforms   Download Managers   Drawables   Emoji   Emulators   EPUB   Equalizers &   Event Buses   Exception Handling   Face Recognition   Feedback &   File System   File/Directory   Fingerprint   Floating Action   Fonts   Forms   Fragments   FRP   FSM   Functional Programming   Gamepads   Games   Geocaching   Gestures   GIF   Glow Pad   Gradle Plugins   Graphics   Grid Views   Highlighting   HTML   HTTP Mocking   Icons   IDE   IDE Plugins   Image Croppers   Image Loaders   Image Pickers   Image Processing   Image Views   Instrumentation   Intents   Job Schedulers   JSON   Keyboard   Kotlin   Layouts   Library Demos   List View   List Views   Localization   Location   Lock Patterns   Logcat   Logging   Mails   Maps   Markdown   Mathematics   Maven Plugins   MBaaS   Media   Menus   Messaging   MIME   Mobile Web   Native Image   Navigation   NDK   Networking   NFC   NoSQL   Number Pickers   OAuth   Object Mocking   OCR Engines   OpenGL   ORM   Other Pickers   Parallax List   Parcelables   Particle Systems   Password Inputs   PDF   Permissions   Physics Engines   Platforms   Plugin Frameworks   Preferences   Progress Indicators   ProGuard   Properties   Protocol Buffer   Pull To   Purchases   Push/Pull   QR Codes   Quick Return   Radio Buttons   Range Bars   Ratings   Recycler Views   Resources   REST   Ripple Effects   RSS   Screenshots   Scripting   Scroll Views   SDK   Search Inputs   Security   Sensors   Services   Showcase Views   Signatures   Sliding Panels   Snackbars   SOAP   Social Networks   Spannable   Spinners   Splash Screens   SSH   Static Analysis   Status Bars   Styling   SVG   System   Tags   Task Managers   TDD &   Template Engines   Testing   Testing Tools   Text Formatting   Text Views   Text Watchers   Text-to   Toasts   Toolkits For   Tools   Tooltips   Trainings   TV   Twitter   Updaters   USB   User Stories   Utils   Validation   Video   View Adapters   View Pagers   Views   Watch Face   Wearable Data   Wearables   Weather   Web Tools   Web Views   WebRTC   WebSockets   Wheel Widgets   Wi-Fi   Widgets   Windows   Wizards   XML   XMPP   YAML   ZIP Codes