ButterKnife是什么?
是由國外一個大牛開源出來的一個項目,是為了用過注解的形式來在android中綁定view以及事件信息盯孙。
目前在github上面的開源地址為:
https://github.com/JakeWharton/butterknife
1.添加依賴:
下面是build.gradle中的配置:
implementation 'com.jakewharton:butterknife:8.8.1'
implementation 'com.jakewharton:butterknife-annotations:8.8.1'
ButterKnife從7.x到8.x后姆吭,運行時和編譯器被分開來了,所以需要加入compiler在build.grandle中券勺,如下所示:
annotationProcessor 'com.jakewharton:butterknife-compiler:8.8.1'
這樣整個build.gradle配置如下:
implementation 'com.jakewharton:butterknife:8.8.1'
implementation 'com.jakewharton:butterknife-annotations:8.8.1'
annotationProcessor 'com.jakewharton:butterknife-compiler:8.8.1'
2.注意事項:
1、在Activity 類中綁定 :
ButterKnife.bind(this);必須在setContentView();之后綁定灿里;且父類bind綁定后关炼,子類不需要再bind。
2匣吊、在非Activity 類(eg:Fragment儒拂、ViewHold)中綁定:
ButterKnife.bind(this寸潦,view);這里的this不能替換成getActivity()。
3社痛、在Activity中不需要做解綁操作见转,在Fragment 中必須在onDestroyView()中做解綁操作。
4蒜哀、使用ButterKnife修飾的方法和控件斩箫,不能用private or static 修飾,否則會報錯撵儿。錯誤: @BindView fields must not be private or static. (com.zyj.wifi.ButterknifeActivity.button1)
5乘客、setContentView()不能通過注解實現(xiàn)。(其他的有些注解框架可以)
6淀歇、使用Activity為根視圖綁定任意對象時易核,如果你使用類似MVC的設計模式你可以在Activity 調(diào)用ButterKnife.bind(this, activity),來綁定Controller浪默。
7牡直、使用ButterKnife.bind(this,view)綁定一個view的子節(jié)點字段纳决。如果你在子View的布局里或者自定義view的構(gòu)造方法里 使用了inflate,你可以立刻調(diào)用此方法碰逸。或者岳链,從XML inflate來的自定義view類型可以在onFinishInflate回調(diào)方法中使用它花竞。
3.Butterknife的注解類型:
綁定注解:
@BindView—->綁定一個view;id為一個view 變量
@BindViews —-> 綁定多個view掸哑;id為一個view的list變量
@BindArray—-> 綁定string里面array數(shù)組约急;@BindArray(R.array.city ) String[] citys ;
@BindBitmap—->綁定圖片資源為Bitmap;@BindBitmap( R.mipmap.wifi ) Bitmap bitmap;
@BindBool —->綁定boolean值
@BindColor —->綁定color苗分;@BindColor(R.color.colorAccent) int black;
@BindDimen —->綁定Dimen厌蔽;@BindDimen(R.dimen.borth_width) int mBorderWidth;
@BindDrawable —-> 綁定Drawable;@BindDrawable(R.drawable.test_pic) Drawable mTestPic;
@BindFloat —->綁定float
@BindInt —->綁定int
@BindString —->綁定一個String id為一個String變量摔癣;@BindString( R.string.app_name ) String meg;
綁定事件:
@OnClick—->點擊事件
@OnCheckedChanged —->選中奴饮,取消選中
@OnEditorAction —->軟鍵盤的功能鍵
@OnFocusChange —->焦點改變
@OnItemClick item—->被點擊(注意這里有坑,如果item里面有Button等這些有點擊的控件事件的择浊,需要設置這些控件屬性focusable為false)
@OnItemLongClick item—->長按(返回真可以攔截onItemClick)
@OnItemSelected —->item被選擇事件
@OnLongClick —->長按事件
@OnPageChange —->頁面改變事件
@OnTextChanged —->EditText里面的文本變化事件
@OnTouch —->觸摸事件
@Optional —->選擇性注入戴卜,如果當前對象不存在,就會拋出一個異常琢岩,為了壓制這個異常投剥,可以在變量或者方法上加入一下注解,讓注入變成選擇性的,如果目標View存在,則注入, 不存在,則什么事情都不做