butterknife官方地址

項(xiàng)目集成

在app module的build.gradle文件下添加如下依賴

android {
  ...
  // Butterknife requires Java 8.
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

dependencies {
  implementation 'com.jakewharton:butterknife:10.2.1'
  annotationProcessor 'com.jakewharton:butterknife-compiler:10.2.1'
  //kapt 'com.jakewharton:butterknife-compiler:10.2.1'  //Kotlin
}

插件導(dǎo)入

AndroidStudio-->setting-->pluign: 搜索并安裝
android-butterknife-zelezny

自定義全局變量前綴

插件安裝后,在AS-->setting-->Other Settings-->ButterknifeZelezny中,有2個(gè)輸入框,可修改前綴和viewHoder的名稱

prefix.png

使用

1. activity中的使用

 @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(bindLayoutID());
        mBind = ButterKnife.bind(this);
        initView(savedInstanceState);
    }

@Override
    protected void onDestroy() {
        super.onDestroy();
        if (mBind != null && mBind != Unbinder.EMPTY) {
            mBind.unbind();
            mBind = null;
        }
    }

 @Override
    protected int bindLayoutID() {
        return R.layout.activity_main;
    }

鼠標(biāo)停留在R.layout.activity_main然后按快捷鍵alt+insert選擇生成butterknife injections, 完成控件的綁定.

2. 綁定資源

@BindBool, @BindColor, @BindDimen, @BindDrawable, @BindInt, @BindString等注解可以綁定資源作為全局變量使用
參考 ButterKnife支持的所有注解

  @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

3.非Activity中使用

3.1 在Fragment中使用

public class FancyFragment extends Fragment {
  @BindView(R.id.button1) Button button1;
  @BindView(R.id.button2) Button button2;
  private Unbinder unbinder;

  @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fancy_fragment, container, false);
    unbinder = ButterKnife.bind(this, view);
    // TODO Use fields...
    return view;
  }

  @Override public void onDestroyView() {
    super.onDestroyView();
    unbinder.unbind();
  }
}

3.2在adapter中使用

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);
    }

    holder.name.setText("John Doe");
    // etc...

    return view;
  }

  static class ViewHolder {
    @BindView(R.id.title) TextView name;
    @BindView(R.id.job_title) TextView jobTitle;

    public ViewHolder(View view) {
      ButterKnife.bind(this, view);
    }
  }
}

4 綁定多組件

@BindViews({ R.id.first_name, R.id.middle_name, R.id.last_name })
List<EditText> nameViews;

5 綁定控件的點(diǎn)擊事件

    @OnClick(R.id.button)
    public void onClick(Button button) {
        ToastUtils.showShort(R.string.click);
        button.setText(R.string.click);
    }

//無參數(shù)點(diǎn)擊
   @OnClick(R.id.button)
    public void onClick( ) {
        ToastUtils.showShort(R.string.click);
    }

//參數(shù)為View
   @OnClick(R.id.button)
    public void onClick(View view ) {
        ToastUtils.showShort(R.string.click);
    
    }

點(diǎn)擊函數(shù)里面的參數(shù)可以是具體的某個(gè)控件,也可以不帶參數(shù), 另外ButterKnife的點(diǎn)擊事件是防抖動(dòng)的,可以有效避免短時(shí)間內(nèi)多次點(diǎn)擊.有興趣的可以參看底部源碼解析篇

6 空綁定

//@Nullable用于全局變量
@Nullable @BindView(R.id.might_not_be_there) TextView mightNotBeThere;
//@Optional 用于方法
@Optional @OnClick(R.id.maybe_missing) void onMaybeMissingClicked() {
  // TODO ...
}

我的ButterKnife相關(guān)文章

ButterKnife(一): 使用篇
ButterKnife(二): 原理解析篇
ButterKnife(三): ButterKnifeProcessor解析