visual-goodies


Source link: https://github.com/alexive/visual-goodies

The purpose of this library is to provide an easy way to implement some of the the eye-candy lists/cards/and some other widgets Google demonstrates on the Material Design Guidelines. Checkout some of the features below.

Lists

The goal was to mimic the lists (and Grids) shown at Google's Material Design guidelines (or hybrids of them) with just a few lines of code:

ListAdapter mAdapter = new ListAdapter(){

  //Use GridAdapter if you need a grid (or an hybrid)
  @Override
  public String getSubHeaderText(int i) {
/*If you have subheaders, text'd go here*/
}

@Override
  public int getNumItems(){
/*Number of list items go here*/
}

@Override
  public void bindDataToListItem(int i, View view, ImageView imageView, ImageButton

 imageButton, TextView... textViews) {

//Here you actually compose the list item

//i is the index

//view is the item's view

//imageView is an image (the one at the left)

//imageButton same (at the right)

//textViews are the textfields, from top to bottom, left to right

//These will depend on the method below
  
}

@Override
  public ListItemType getListItemDataType(int i) {
/*return the list item at index i's type*/
}

Also you can:

  • add an header view ( listAdapter.addHeaderView(view))
  • add dividers between the list items ( listAdapter.setDividerStyle(DividerStyle.JUST_SUB_HEADERS), other options are only above dividers, or none (default)). You'll need to set their color: ( listAdapter.setDividerColor(Divider.MATERIAL_LIGHT_DIVIDER_COLOR), or MATERIAL_DARK_DIVIDER_COLOR)
  • add click/long click listener ( listAdapter.setOnItemClickListener(new OnItemClickListener(){ ... } ))
  • Turn the avatars/buttons into checkboxes ( listAdapter.setShowCheckboxes(true))
  • Same as above but in an ActionMode ( startSupportActionMode(new ListAdapter.ListCheckingActionMode(listAdapter))
  • Make the adapter to display a view when the list is empty ( listAdapter.setEmptyView(view))

Example:

| | |

RecyclerViewFragment

It's basically a fragment with a RecyclerView. Just extend this class, override onViewCreated, and then you can access these methods (even if you don't use this library's adapters):

  • setAdapter(adapter)
  • setEmptyText(text), setEmptyView(view)
  • setOnItemClickListener(listener), setOnItemLongClickListener(listener)
  • suggestions are welcome!

Dialogs

Instead of playing with AlertDialog.Builder class each time you need a dialog...

  • Create a simple message dialog with a one-liner: MessageDialog.show(getActivity(), "title here", "hey what\'s up?")
  • Ask confirmation: MessageDialog.askConfirmation(getActivity(), "title here", "msg here", new DialogInterface.OnClickListener(){ ... } )
  • A number within a range new NumberPickerDialog(getActivity(), Integer.MIN_VALUE, Integer.MAX_VALUE).show(new NumberPickerDialog.NumberPickerListener() { ... }
  • Text that fits some parameters:
new TextInputDialog(getActivity()).setInputPolicy(new TextInputDialog.InputPolicy() {

  @Override
  public String isTextAcceptable(String s) {

if (s.equals("asdfghjkl"))

 return "what?"; //what the user wrote is not okay

return null; //What the user wrote is fine
  
}
 
}
).show(new TextInputDialog.TextListener() {

  @Override
  public void onTextAccepted(String s) {

//isTextAcceptable(s) returned null and the user accepted
  
}
 
}
);

CardBuilder

The intent is to create a Card like the ones at Google's MD guidelines with just a few lines (and not having to create layout files)

Check the demo project for a complete sample on how to use the CardBuilder. The result is this:

| | | | |

Proportional Image View

Self-explanatory, can restrict an image to 16:9, 4:3, 1:1 or just be like a regular ImageView

View Utils

Transforms plenty of methods (some that usually require checking the sdk version, not null, etc) to a single line method call.

  • setBackgroundDrawable(view, drawable)
  • getDrawable(drawable) ContextCompat already has a method for that!
  • animateSetViewVisibilityGone(view) / animateSetViewVisibilityVisible(view) makes a view disappear/appear with style
  • createCircularReveal(view) / createCircularRevealInverse(view)
  • convertDPtoPixels(context, dp)

Use it in your project

In your project's root build.gradle, add maven { url "https://jitpack.io" } at the end of repositories:

allprojects {

repositories {

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

}
  
}
 

Then, in your module's build.gradle, add compile 'com.github.alexive:visual-goodies:-SNAPSHOT' to the dependencies:

dependencies {

compile 'com.github.alexive:visual-goodies:-SNAPSHOT'
  
}
 

I'll be updating this repo often (usually bug fixes) so, if you want, tell gradle to check for a new version at every build. Add to your module's build.gradle:

configurations.all {

  resolutionStrategy.cacheChangingModulesFor 0, 'seconds' 
}
 

Suggest/Contribute

Any suggestions (and contributions) will be greatly appreciated. The same thing goes for any bugs you find. Just file up an issue and I'll look it up ASAP.

Demo project

If you want to try the demo project, just clone the repo, uncomment the project's root settings.gradle and you can go from there. In a one-liner:

git clone https://github.com/alexive/visual-goodies.git && cd visual-goodies && echo "include ':library', ':demo'" > settings.gradle

Then open the project on Android Studio and run the demo module

Apps that use this library

None yet! If your use it in your app, feel free to open up an issue and i'll just mention it here

Why I did this

After learning to code and doing a few Android apps just for me to learn, I found myself writing the same code over and over again. Then, in college, I realized I could reuse the code, so I decided to move the repeated parts onto a separate project tweak it a bit and voilà! This includes list adapters, dialogs, cards, etc

Wishlist (or TODO):

  • Swipeable list items
  • Drag and drop to reorder
  • Pull to refresh
  • Even more cards

License

Copyright 2016 J. Alexandre Oliveira  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

Simple ToggleButton Widget for Android developers.

SunDate_Picker is a library for Persian developers to let users choose date.

Library that implements Snackbars from Google's Material Design documentation.

MaterialList is an Android library created to help all Android developers get the beautiful CardViews that Google shows at its official design specifications.

Provided as a ListView extension, it can receive a list of Cards (stored in a CardList, provided by the library) and show them accordingly to the android style and design patterns.

It also has been developed while keeping extensibility in mind, which means that you are able to create your own card layouts and add them to the CardList without any pain (see examples below).

material-drawer is a custom drawer implementation for Material design apps.

A single EditText instead of a classical form. This Library is a library implementation of flavienlaurent's "Single input form". Very inspired by the Minimal Format Interface.

Implement any form with only one EditText. The idea here is to pack a multiple input form in one field. As a result, the user input is easier and a more fluent process.

Also, TextSwitcher got completely rediscovered to animate the form: title, error message. It's very basic but simple to use.

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