https://github.com/tdscientist/ShelfView

Android custom view to display books on shelf
https://github.com/tdscientist/ShelfView

Last synced: about 1 month ago
JSON representation

Android custom view to display books on shelf

• Host: GitHub
• URL: https://github.com/tdscientist/ShelfView
• Owner: tdscientist
• Created: 2017-02-16T00:47:15.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-09-24T08:27:26.000Z (about 7 years ago)
• Last Synced: 2024-08-02T01:25:33.864Z (4 months ago)
• Language: Java
• Homepage:
• Size: 3.38 MB
• Stars: 102
• Watchers: 6
• Forks: 27
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-github-android-ui - ShelfView - 显示书架上的书的自定义视图 (其他)

README

        
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-ShelfView-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/5299) [![MaterialUp](https://img.shields.io/badge/MaterialUp-ShelfView-deepblue.svg?style=flat)](https://material.uplabs.com/posts/shelfview)

## ShelfView ##

*Android custom view to display books on shelf* `     ` **([iOS version is available here](https://github.com/tdscientist/ShelfView-iOS))** 

 

#### How to use ####

----

**build.gradle**

```

allprojects {

            repositories {

                maven {

                    url 'https://jitpack.io'

                }

            }

        }

```

```

dependencies {

	        compile 'com.github.tdscientist:ShelfView:v1.0'

	}

```

**Layout**

```

```

**Activity**

```

import com.tdscientist.shelfview.BookModel;

import com.tdscientist.shelfview.ShelfView;

import java.util.ArrayList;

public class MainActivity extends AppCompatActivity implements ShelfView.BookClickListener {

    @Override

    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

        ShelfView shelfView = (ShelfView) findViewById(R.id.shelfView);

        shelfView.setOnBookClicked(this);

        ArrayList models = new ArrayList<>();

        models.add(new BookModel("http://eurodroid.com/pics/beginning_android_book.jpg", "1", "Beginning Android"));

       

 		shelfView.loadData(models, ShelfView.BOOK_SOURCE_URL);

    }

	@Override

    public void onBookClicked(int position, String bookId, String bookTitle) {	

    	// handle click events here 

        //Toast.makeText(this, bookTitle, Toast.LENGTH_SHORT).show();

    }

}

```

#### Loading book covers from other sources ####

----

* Internal/External directory in the device

```

model.add(new BookModel("/path/to/android_book_cover.jpg", "1", "Let's Talk About Android"));

shelfView.loadData(model, ShelfView.BOOK_SOURCE_FILE);

``` 

* Assets folder

```

model.add(new BookModel("android.jpg", "1", "Android for Experts"));

shelfView.loadData(model, ShelfView.BOOK_SOURCE_ASSETS_FOLDER);

```

 

* Drawable folder

```

model.add(new BookModel("alice", "1", "Alice in Wonderland"));

shelfView.loadData(model, ShelfView.BOOK_SOURCE_DRAWABLE_FOLDER);

``` 

#### Permissions ####

----

```

    

    

``` 

#### License ####

----

```

Copyright 2017 Adeyinka Adediji

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.

```

#### Contributions & Bug Reporting ####

---

[email protected] 

#### Credits ####

---

* [Picasso](https://github.com/square/picasso)