BasePopup

BasePopup 3.0 introduces breaking changes to simplify the view initialization process. If you are upgrading from version 2.x, you must perform the following manual updates:

1. Remove BaseLazyPopupWindow usage: The distinction between lazy-loading and normal popups is removed. All popups should now extend BasePopupWindow.
2. Remove onCreateConstructor calls: This method was specific to BaseLazyPopupWindow and is no longer required.
3. Replace onCreateContentView: This method has been removed. You must now use setContentView(@LayoutRes int layoutResID) or setContentView(final View view) within your constructor to initialize the content view.

Recommendation: When using a layout resource, prefer setContentView(R.layout.your_layout) over manually inflating a view and passing it to setContentView(View view). This ensures the framework correctly parses XML configurations.

To create a custom popup, follow these steps:

1. Define Layout: Create an XML layout. Ensure the view intended for animations is a child of the main popup view.
2. Extend BasePopupWindow: Create a new class that extends BasePopupWindow.
3. Override Required Methods:
   • initAnimaView(): Return the view that will host the entry/exit animations.
   • initShowAnimation(): Return an Animation object for the entry effect.
   • onCreatePopupView(): Initialize the popup UI. It is recommended to use createPopupById(int layoutResId).
   • getClickToDismissView(): Return the view that, when clicked, will dismiss the popup (e.g., a background mask).
4. Show the Popup: Instantiate your class and call showPopupWindow().

public class DialogPopup extends BasePopupWindow implements View.OnClickListener {

    private TextView ok;
    private TextView cancel;

    public DialogPopup(Activity context) {
        super(context);

        ok = (TextView) findViewById(R.id.ok);
        cancel = (TextView) findViewById(R.id.cancel);

        setViewClickListener(this, ok, cancel);
    }

    @Override
    protected Animation initShowAnimation() {
        AnimationSet set = new AnimationSet(false);
        Animation shakeAnima = new RotateAnimation(0, 15, Animation.RELATIVE_TO_SELF, 0.5f, Animation.RELATIVE_TO_SELF, 0.5f);
        shakeAnima.setInterpolator(new CycleInterpolator(5));
        shakeAnima.setDuration(400);
        set.addAnimation(getDefaultAlphaAnimation());
        set.addAnimation(shakeAnima);
        return set;
    }

    @Override
    protected View getClickToDismissView() {
        return getPopupWindowView();
    }

    @Override
    public View onCreatePopupView() {
        return createPopupById(R.layout.popup_dialog);
    }

    @Override
    public View initAnimaView() {
        return findViewById(R.id.popup_anima);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.ok:
                Toast.makeText(getContext(), "click the ok button", Toast.LENGTH_SHORT).show();
                break;
            case R.id.cancel:
                Toast.makeText(getContext(), "click the cancel button", Toast.LENGTH_SHORT).show();
                break;
            default:
                break;
        }
    }
}

// Usage:
DialogPopup popup = new DialogPopup(context);
popup.showPopupWindow();

In version 3.0, the timing of setContentView is under your control. You should call setContentView in your constructor to ensure that view inflation happens immediately. This allows you to pass parameters through the constructor and access them safely within onViewCreated or via builder-style methods without encountering NullPointerExceptions (NPE).

public class DemoPopup extends BasePopupWindow {
    @BindView(R.id.tv_desc)
    public TextView mTvDesc;

    int a;

    public DemoPopup(Context context, int a) {
        super(context);
        // The value passed by the constructor is assigned here
        this.a = a;
        // Manually set the content view in the constructor
        setContentView(R.layout.popup_demo);
    }

    @Override
    public void onViewCreated(View contentView) {
        ButterKnifeUtil.bind(this, contentView);
        // Parameters passed to the constructor are now safely accessible
        mTvDesc.setText(String.valueOf(a));
    }

    // Builder-style method is now safe because inflation happened in the constructor
    public DemoPopup setText(CharSequence text) {
        mTvDesc.setText(text);
        return this;
    }
}