浅析 ButterKnife
来源:互联网 发布:数据库字符串截断 编辑:程序博客网 时间:2024/04/28 02:19
ButterKnife 基础功能
最近看到很多项目都使用了注解,最多的是ButterKnife,今天对ButterKnife的用法做一个简单的总结。
看看官方的介绍:
Field and method binding for Android views which uses annotation processing to generate boilerplate code for you
使用注解生成模块代码,用于把一些字段和方法绑定到 Android 的 View。
优势
- 强大的
View
绑定和Click
事件等处理功能,简化代码,提升开发效率 - 运行时不会影响APP效率,使用配置方便
- 代码清晰,可读性强
使用
依赖
Project的build.gradle
文件中:
buildscript { repositories { mavenCentral() } dependencies { classpath 'com.jakewharton:butterknife-gradle-plugin:8.4.0' }}
Module的
build.gradle
文件中:apply plugin: 'com.android.library'apply plugin: 'com.jakewharton.butterknife'
dependencies { compile 'com.jakewharton:butterknife:8.4.0' annotationProcessor 'com.jakewharton:butterknife-compiler:8.4.0'}
单个View——@BindView
在Activity中使用
例:绑定布局中的TextView
、Button
、EditText
。- 没有ButterKnife时,各种烦人的
findViewById()
和强转: TextView textView = (TextView) findViewById(R.id.text_view);Button button = (Button) findViewById(R.id.button);EditText editText = (EditText) findViewById(R.id.edit_text);
使用ButterKnife后:
先绑定对应的View
然后在@BindView(R.id.text_view)TextView mTextView;@BindView(R.id.button)Button mButton;@BindView(R.id.edit_text)EditText mEditText;
onCreate()
的setContentView()
下添加ButterKnife.bind(this);
:@Overrideprotected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); ButterKnife.bind(this);}
- 然后这些
View
就可以随心所欲的使用了,方便吧!注意:这里的
View
不可以是private
或static
类型
- 然后这些
在Fragment、Adapter中使用
除了Activity
,我们常用的场景还有Fragment
,以及Adapter
。用法跟在Activity
中大致相似。- Fragment中
例:绑定布局中的TextView
、Button
、EditText
。public class MainFragment extends Fragment {@BindView(R.id.text_view)TextView mTextView;@BindView(R.id.button)Button mButton;@BindView(R.id.edit_text)EditText mEditText;@Overridepublic View onCreateView(LayoutInflater inflater,ViewGroup container, Bundle savedInstanceState) { View rootView = inflater.inflate(R.layout.frag_main, container, false); ButterKnife.bind(this, rootView);//这里有些不同 return rootView; }}
提示:如果我们需要在某个时候将
Fragment
中的view
设置为null
,这时候需要用到Unbinder
。在onCreateView
中使用bind
方法时,会返回一个Unbinder
对象,该对象中有的unbinder
方法,可以将Fragment
中的View
设置为null
- Adapter中
例:绑定布局中的TextView
、Button
。public class MyAdapter extends BaseAdapter { @Override public View getView(int position, View view, ViewGroup parent) { ViewHolder holder; if (view != null) { holder = (ViewHolder) view.getTag(); } else { view = inflater.inflate(R.layout.whatever, parent, false); holder = new ViewHolder(view); view.setTag(holder); } //.... return view; } static class ViewHolder { @BindView(R.id.text_view) TextView mTextView; @BindView(R.id.button) Button mButton;; public ViewHolder(View view) { ButterKnife.bind(this, view); } }}
提示:在使用
BindView
方法的时候,如果目标View
没有找的的话,会抛出异常。如果不想受到这个异常,可以使用@Nullable
@Nullable @BindView(R.id.text_view)
- Fragment中
View列表——@BindViews
使用这种绑定时,你可以使用
apply()
方法。该函数相当于将在这个列表中每一个元素上进行调用.利用ButterKnife的Action
或Setter
接口来执行一些简单的操作- 例:隐藏指定的
View
。
先使用List<View>
绑定视图@BindViews({R.id.text_view, R.id.button, R.id.edit_text})List<View> mViews;
- 使用
Action
final ButterKnife.Action<View> VIEWS_GONE = new ButterKnife.Action<View>() {@Overridepublic void apply(@NonNull View view, int index) { view.setVisibility(View.GONE);}};ButterKnife.apply(mViews, VIEWS_GONE);
- 使用Setter
final ButterKnife.Setter<View, Boolean> VIEWS_VISIAVLE = new ButterKnife.Setter<View, Boolean>() {@Overridepublic void set(@NonNull View view, Boolean value, int index) { final int IS_VISIAVLE = value ? View.VISIBLE : View.GONE; view.setVisibility(IS_VISIAVLE);}};ButterKnife.apply(mViews, VIEWS_VISIAVLE, false);
- 使用
- Android属性也可以和
apply
方法一起使用。ButterKnife.apply(nameViews, View.ALPHA, 0.0f);
点击事件——@OnClick
在使用的过程中,除了
@BindView
,还有@OnClick
也是经常用到的。- 例:为
Button
设置点击事件
参数@OnClick(R.id.button)public void onButtonClick(View view) { Toast.makeText(this, "button被点击了", Toast.LENGTH_SHORT).show();}
View
就是被点击的视图
如果可以确认View的具体类型,可以这样写。如:已知为Button
类型
如果不需要用到参数@OnClick(R.id.button)public void onButtonClick(Button button) { Toast.makeText(this, "button被点击了", Toast.LENGTH_SHORT).show();}
View
,也可以去掉@OnClick(R.id.button)public void onButtonClick() { Toast.makeText(this, "button被点击了", Toast.LENGTH_SHORT).show();}
- 例:多个点击事件
@OnClick({R.id.text_view, R.id.button, R.id.edit_text})public void onTextviewClick(View view) { switch (view.getId()){ case R.id.text_view: Toast.makeText(this, "text_view被点击了", Toast.LENGTH_SHORT).show(); break; case R.id.button: Toast.makeText(this, "button被点击了", Toast.LENGTH_SHORT).show(); break; case R.id.edit_text: Toast.makeText(this, "edit_text被点击了", Toast.LENGTH_SHORT).show(); break; }}
- 例:
item
的点击事件@BindView(R.id.list_view)ListView mListView;private String[] strs = {"1","2","3","4","5"};
mListView.setAdapter(new ArrayAdapter<String>(getContext(), android.R.layout.simple_list_item_1, strs));
有@OnItemClick(R.id.list_view)void onItemClick(int potion) { Toast.makeText(getContext(), "点击了:" + potion, Toast.LENGTH_SHORT).show();}
@OnItemClick
,当然也有@OnItemLongClick
。具体的用法我就不写了... - 自定义
View
绑定事件监听时无需IDpublic class FancyButton extends Button { @OnClick public void onClick() { // TODO do something! }}
注意:
1、方法名可以随便取
2、跟View
一样,方法也不能为private
或static
类型
资源绑定
可以利用
@BindBool
,@BindColor
,@BindDimen
,@BindDrawable
,@BindInt
,@BindString
来绑定资源,如下class MainActivity extends Activity { @BindString(R.string.title) String title; @BindDrawable(R.drawable.graphic) Drawable graphic; @BindColor(R.color.red) int red; // int or ColorStateList field @BindDimen(R.dimen.spacer) Float spacer; // int (for pixel size) or float (for exact value) field // ...}
findById方法
如果在某些场景下,你真的需要用到
findViewById()
方法。不用担心,ButterKnife中包含了findById()
方法来替代findViewById()
,可以在View
,Activity
, 或Dialog
中使用View view = LayoutInflater.from(context).inflate(R.layout.thing, null);TextView firstName = ButterKnife.findById(view, R.id.first_name);TextView lastName = ButterKnife.findById(view, R.id.last_name);ImageView photo = ButterKnife.findById(view, R.id.photo);
Zelezny插件
如果你是像我一样高(lan)效(duo)的程序员,一点都不想写这些东西。那么福利来了,那就是Zelezny插件(Android Studio)。什么都不写,所有代码自动生成。厉害了
安装插件
使用
然后只要右键布局id上,选择Generate,点击Generate Butterknife Injections,该插件会从对应的布局中查找有id属性的View,然后会出现在对应的选择页面。点击Confirm即可。
最后的提示
几点有关ButterKnife的提示,使用时避免踩坑。
- Activity:
ButterKnife.bind(this)
;
必须在setContentView();
之后,且父类bind
绑定后,子类不需要再bind
- Fragment :
ButterKnife.bind(this, mRootView);
- 属性布局不能用
private
或static
修饰,否则会报错 setContentView()
不能通过注解实现。- ButterKnife已经更新到版本8.x了,以前的版本中叫做
@InjectView
,7.x中叫@Bind
,而现在改用叫@BindView
。
- 没有ButterKnife时,各种烦人的
- 浅析 ButterKnife
- butterknife框架浅析
- [Android] ButterKnife 浅析
- ButterKnife
- ButterKnife
- ButterKnife
- ButterKnife
- ButterKnife
- ButterKnife
- ButterKnife
- butterknife
- ButterKnife
- ButterKnife
- Butterknife
- butterknife
- ButterKnife
- ButterKnife
- butterknife
- PCA的前生今世
- 事务四大特征:原子性,一致性,隔离性和持久性(ACID)
- Magento网站分类页面显示子分类而不是产品的方法
- java多线程面试题
- Quartz 中的任务开始、暂停和继续
- 浅析 ButterKnife
- CentOS配置SVN
- 欢迎使用CSDN-markdown编辑器
- Oracle分析函数
- 2016年第七届蓝桥杯C/C++程序设计本科B组省赛-凑算式
- 挑战练习题2.3动态规划 poj3616Milking Time dp
- 各种常用命令记录,做个记录,方便自己查阅
- 获取Android唯一标识(唯一序列号)
- [译]Java定时任务调度-Quartz文档(一)初步使用