From a4d65c47ae24bb50c31f16ed91b65fdc172873a9 Mon Sep 17 00:00:00 2001 From: gabrielemariotti Date: Tue, 10 Jun 2014 15:05:09 +0200 Subject: [PATCH] Updated doc for 1.7.0 --- CHANGELOG.md | 7 +++++-- README.md | 7 +++++-- demo/README.md | 4 ++++ doc/BUILD.md | 8 +++++--- doc/CARDWITHLIST.md | 22 +++++++++++++++++++++- doc/CUSTOMIZATION.md | 1 + doc/GUIDE.md | 4 ++-- 7 files changed, 43 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0cc85d63..1679b059 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,12 +4,15 @@ Change Log Version 1.7.0 *(2014-XX-XX)* ---------------------------- +* LIB: Added a new feature to display a list of items inside a Card [(doc)](/doc/CARDWITHLIST.md) * LIB: Added a feature to customize dynamically the undoBar message [(doc)](/doc/CARDLIST.md#swipe-and-undo-with-a-custom-undobar) It contains a **BREAKING CHANGE** with UndoBar and UndoBarUIElements feature. Read the above link to migrate your code. * LIB-EXTRA: Updated Etsy-Grid dependency to 1.0.5 -* DEMO-Extras: Improved staggered grid examples. -* DEMO-Extras: updated all libraries. +* DEMO: Added a new example for Card with List +* DEMO-Extra: Added a new example for Card with List integrated with WeatherLib +* DEMO-Extra: Improved staggered grid examples. +* DEMO-Extra: updated all libraries. Version 1.6.0 *(2014-05-06)* diff --git a/README.md b/README.md index 7566cb14..cab303b9 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,7 @@ The Guide provides a extensive doc, with all tips and full examples. Don't miss Card Library is pushed to Maven Central as an AAR, so you just need to add the following dependency to your `build.gradle`. dependencies { - compile 'com.github.gabrielemariotti.cards:library:1.6.0' + compile 'com.github.gabrielemariotti.cards:library:1.7.0' } @@ -69,6 +69,7 @@ Acknowledgements * Thanks to [Niek Haarman][4] for some ideas and code taken from his [ListViewAnimations][5]. * Thanks to [Chris Banes][6] for [ForegroundLinearLayout][7] class (See this [post][8] for more info). * Thanks to [Taylor Ling][9] for drag and drop icon. +* Thanks to [Frankie Sardo][10] for some ideas and code taken from his [LinearListView][11] Credits @@ -120,4 +121,6 @@ Google and the Google Maps logo are registered trademarks of Google Inc., used w [6]: https://plus.google.com/+ChrisBanes [7]: https://gist.github.com/chrisbanes/9091754 [8]: https://plus.google.com/+AndroidDevelopers/posts/aHPVDtr6mcp - [9]: https://plus.google.com/+TaylorLing \ No newline at end of file + [9]: https://plus.google.com/+TaylorLing + [10]: https://plus.google.com/+FrankieSardo + [11]: https://github.com/frankiesardo/LinearListViews \ No newline at end of file diff --git a/demo/README.md b/demo/README.md index 1d0ffb0c..c5bc5c74 100644 --- a/demo/README.md +++ b/demo/README.md @@ -15,6 +15,7 @@ There are two sample applications: 6. [Crouton][12] 7. [StickyListHeaders][14] 8. [AndroidStaggeredGrid][16] +9. [WeatherLib][21] [(See this page for more info about integration)](/doc/OTHERLIBRARIES.md) @@ -42,6 +43,7 @@ Extras demo uses these open source libraries: * [Crouton][12] by [Benjamin Weiss][13] * [StickyListHeaders][14] by [Emil Sjölander][15] * [AndroidStaggeredGrid][16] by [Etsy][17] +* [WeatherLib][21] by [Francesco Azzola][22] * Thanks to [JakeWharton][18] for some ideas and code taken from his [u2020][19]. * Thanks to [Taylor Ling][20] for drag and drop icon. @@ -105,4 +107,6 @@ License [18]: http://jakewharton.com/ [19]: https://github.com/JakeWharton/u2020 [20]: https://plus.google.com/+TaylorLing + [21]: https://github.com/survivingwithandroid/WeatherLib + [22]: https://plus.google.com/+FrancescoAzzola diff --git a/doc/BUILD.md b/doc/BUILD.md index 792024fd..927fb42c 100644 --- a/doc/BUILD.md +++ b/doc/BUILD.md @@ -17,10 +17,10 @@ Card Library is pushed to Maven Central as a AAR, so you just need to add the fo dependencies { //Core card library - compile 'com.github.gabrielemariotti.cards:library:1.6.0' + compile 'com.github.gabrielemariotti.cards:library:1.7.0' //Extra card library, it is required only if you want to use integrations with other libraries - compile 'com.github.gabrielemariotti.cards:library-extra:1.6.0' + compile 'com.github.gabrielemariotti.cards:library-extra:1.7.0' } The library-extra is optional. It contains code to use integrations with other libraries, as StaggeredGridView and CardListDragDropView. @@ -114,6 +114,7 @@ If you would like to use this **library** in Eclipse you have to do these steps: - mark java(*) folder as source (click on folder -> Build-Path -> use as source folder). You can also remove the src folder, from the project. - mark cardslib as Android Library (Properties -> Android -> Is library) - The library targets SDK 19 and works with minSdk=14. In any cases you need to use API>=16 to compile library (Properties -> Android) +- Clean and build If you would like to use this **library-extra** in Eclipse you have to do these steps: (this part is optional,it contains code to use integrations with other libraries, as StaggeredGridView and CardListDragDropView) @@ -125,7 +126,7 @@ If you would like to use this **library-extra** in Eclipse you have to do these - add [Etsy-StaggeredGrid](https://github.com/etsy/AndroidStaggeredGrid) as dependency ( click -> Properties -> Android -> Add library) as dependency. Check the AndroidStaggeredGrid-library readme for instruction. - add [ListViewAnimation](https://github.com/nhaarman/ListViewAnimations) as dependency ( click -> Properties -> Android -> Add library) as dependency. Check the ListViewAnimations-library readme for instruction. - The library targets SDK 19 and works with minSdk=14. In any cases you need to use API>=16 to compile library (Properties -> Android) - +- Clean and build If you would like to build the **demo-stock** you have to do these additional steps: @@ -135,6 +136,7 @@ If you would like to build the **demo-stock** you have to do these additional st - add support library v4 rel.19 ( click -> Android Tools -> Add support library , or just copy android-support-v4.jar in libs folder) - add cardslib as dependency ( click -> Properties -> Android -> Add library) - The demo-stock targets SDK 19 and works with minSdk=14. In any cases you need to use API>=16 to compile it +- Clean and build (*) Eclipse uses src and res as source folders. diff --git a/doc/CARDWITHLIST.md b/doc/CARDWITHLIST.md index f6abad6f..0ec8cc22 100644 --- a/doc/CARDWITHLIST.md +++ b/doc/CARDWITHLIST.md @@ -160,7 +160,7 @@ In particular you can : ```java item.setOnItemSwipeListener(new OnItemSwipeListener() { @Override - public void onItemSwipe(ListObject object) { + public void onItemSwipe(ListObject object,boolean dismissRight) { Toast.makeText(getContext(), "Swipe on " + object.getObjectId(), Toast.LENGTH_SHORT).show(); } }); @@ -168,6 +168,25 @@ In particular you can : ![Screen](/demo/images/card/cwl_swipeitem.png) +You can customize the background behind the items cloning this color in your project: + +``` xml + + #10000000 +``` + +Otherwise you can customize this style in your project: + +``` xml + + +``` + +and finally you can provide your [custom inner layout](#using-a-custom-inner-layout) + + ## Define the layout used by items You have to specify the layout used by each item. @@ -229,6 +248,7 @@ Finally you can clone this style in your project: middle match_parent match_parent + @color/card_base_cardwithlist_background_list_color ``` diff --git a/doc/CUSTOMIZATION.md b/doc/CUSTOMIZATION.md index c36e65df..c3add7b9 100644 --- a/doc/CUSTOMIZATION.md +++ b/doc/CUSTOMIZATION.md @@ -12,4 +12,5 @@ Here you can find some pages to customize these tags. * [CardGrid:](CARDGRID.md) How to work with the `CardGridView` * [StaggeredGrid:](STAGGEREDGRID.md) How to work with the `CardGridStaggeredView` * [CardList with Drag and Drop:](DRAGDROPLIST.md) How to work with the `CardListDragDropView` +* [Card with a List inside](CARDWITHLIST.md) How to build a card with a List Inside. * [Integration with other libraries:](OTHERLIBRARIES.md) How to work with other main libraries diff --git a/doc/GUIDE.md b/doc/GUIDE.md index a0273c6e..7a3f99ed 100644 --- a/doc/GUIDE.md +++ b/doc/GUIDE.md @@ -15,10 +15,10 @@ Card Library is pushed to Maven Central as an AAR, so you just need to add the f dependencies { //Core card library - compile 'com.github.gabrielemariotti.cards:library:1.6.0' + compile 'com.github.gabrielemariotti.cards:library:1.7.0' //Extra card library, it is required only if you want to use integrations with other libraries - compile 'com.github.gabrielemariotti.cards:library-extra:1.6.0' + compile 'com.github.gabrielemariotti.cards:library-extra:1.7.0' } The library-extra is optional. It contains code to use integrations with other libraries, as StaggeredGridView and CardListDragDropView.