Android Components
Android components is an android library which contains improvements of native android components.
Usage
Using Gradle
You can just add the dependency like below
repositories {
jcenter()
}
And then you can add the library as dependency
dependencies {
compile 'com.masacre:android-components:1.2.1'
}
Components
ClickableRecyclerView
The ClickableRecyclerView improve the RecyclerView by adding method to handle the android.view.View.OnClickListener and android.view.View.OnLongClickListener of each android.support.v7.widget.RecyclerView.ViewHolder.
There are two exclusive ways of handle the click event.
- Register the following listeners OnViewHolderClickListener and/or OnViewHolderLongClickListener in the recycler view
- Override the methods android.view.View.OnClickListener# onClick(View) and/or android.view.View.OnLongClickListener# onLongClick(View) in the view holder
Sample
final ClickableRecyclerView recyclerView = (ClickableRecyclerView) findViewById(R.id.recycler_view);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
final DCSeriesAdapter dcSeriesAdapter = new DCSeriesAdapter(this, Arrays.asList("Arrow", "The Flash", "DC's Legends of Tomorrow"));
recyclerView.setAdapter(dcSeriesAdapter);
The class DCSeriesAdapter must extends from ClickableRecyclerView.ClickableAdapter<DCViewHolder>, and DCViewHolder must extends from ClickableRecyclerView.ClickableViewHolder
In this example we are going to handle the onClick registering the listener in the recycler view and handle the onLongClick in the DCViewHolder.
When we register the OnViewHolderClickListener the method onClick implemented in the view holder will not be called.
recyclerView.setOnViewHolderClickListener(new ClickableRecyclerView.OnViewHolderClickListener<DCSeriesViewHolder>() {
@Override
public void onItemClick(final DCSeriesViewHolder holder, final int position) {
Toast.makeText(MainActivity.this, "Recycler onClick: " + holder.getText(), Toast.LENGTH_SHORT).show();
}
}
);
Now we have to implement the onLongClick in the DCSeriesViewHolder
public class DCSeriesViewHolder extends ClickableRecyclerView.ClickableViewHolder {
private final Context context;
private final TextView seriesTitle;
public DCSeriesViewHolder(final Context context, final View view) {
super(view);
this.context = context;
this.seriesTitle = (TextView) view.findViewById(R.id.textview);
}
private void findViews(final View view) {
this.seriesTitle = (TextView) view.findViewById(R.id.textview);
}
public void show(final String value) {
seriesTitle.setText(value);
}
@Override
public boolean onLongClick(View v) {
Toast.makeText(context, "DCSeriesViewHolder onLongClick: " + textView.getText(), Toast.LENGTH_SHORT).show();
return true;
}
public String getText() {
return seriesTitle.getText().toString();
}
}
PullDownSwipeRefreshLayout
A PullDownSwipeRefreshLayout improve the SwipeRefreshLayout by adding a method to handle the pull down of the swipe refresh layout.
To handle this event you must register a PullDownListener.
Sample
final PullDownSwipeRefreshLayout layoutSwipeRefresh = (PullDownSwipeRefreshLayout) findViewById(R.id.pull_to_refresh);
layoutSwipeRefresh.setPullDownListener(new PullDownSwipeRefreshLayout.PullDownListener() {
@Override
public void onPullDown() {
Toast.makeText(MainActivity.this, "Pull down", Toast.LENGTH_SHORT).show();
}
}
);
ImagePicker
The ImagePicker provides you a full component, that allow you to select a picture from each gallery and camera apps that your device has
Sample
public class MainActivity extends AppCompatActivity {
private static final int PICK_IMAGE_REQUEST_CODE = 2352;
@Override protected void onCreate(final Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
final Button pickPictureButton = (Button) findViewById(R.id.pick_picture_button);
pickPictureButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(final View v) {
final Intent pickImageIntent = ImagePicker.getPickImageIntent(MainActivity.this,
ImagePicker.ImagePickerIntentType.CAMERA, ImagePicker.ImagePickerIntentType.GALLERY);
startActivityForResult(pickImageIntent, PICK_IMAGE_REQUEST_CODE);
}
}
);
}
@Override protected void onActivityResult(final int requestCode, final int resultCode, final Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == PICK_IMAGE_REQUEST_CODE) {
try {
final BitmapImage bitmapImage = ImagePicker.getImageFromResult(this, resultCode, data);
//Use image
}
catch (IOException e) {
//Handle error
}
}
}
}
Material Typography & Colors
Now, you can use all material typography (Roboto family) and the complete palette colors.
Versions
- 1.0.0
- ClickableRecyclerView
- 1.1.0
- PullDownSwipeRefreshLayout
- ImagePicker
- 1.2.0
- Material Typography
- Material Colors
- Upgrade to compile sdk api level 24
- 1.2.1
- Update travis to api level 24
Copyright and License
Copyright 2016 Martin Purita.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License at: