RecyclerView无法显示自定义SquareButton问题求助

Hey there, let's figure out why your custom SquareButton (AppCompatButton subclass) works fine outside RecyclerView but vanishes inside it. I’ve run into similar issues before, so here are the most common fixes to try:

1. Make sure all required constructors are implemented #

RecyclerView’s Adapter typically creates views using the constructor that takes Context and AttributeSet (and sometimes the style attribute). If your SquareButton is missing any of these, the system can’t instantiate it properly in RecyclerView.

Add all three constructors and delegate your initialization logic to a common method:

public class SquareButton extends AppCompatButton {

    public SquareButton(Context context) {
        super(context);
        init();
    }

    public SquareButton(Context context, AttributeSet attrs) {
        super(context, attrs);
        init();
    }

    public SquareButton(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init();
    }

    private void init() {
        // Your square-enforcing logic goes here
    }

    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
        int size = Math.min(getMeasuredWidth(), getMeasuredHeight());
        setMeasuredDimension(size, size);
    }
}

2. Verify your onMeasure logic #

Double-check that your square-sizing logic isn’t accidentally setting the button’s dimensions to 0. For example, if the parent layout in your RecyclerView item gives the button wrap_content but the measured width/height ends up being 0 (due to no content or incorrect MeasureSpec handling), the button will be invisible.

Add a quick log in onMeasure to debug the measured values:

@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
    super.onMeasure(widthMeasureSpec, heightMeasureSpec);
    int width = getMeasuredWidth();
    int height = getMeasuredHeight();
    Log.d("SquareButton", "Measured width: " + width + ", height: " + height);
    int size = Math.min(width, height);
    setMeasuredDimension(size, size);
}

3. Use the full package name in your item layout #

When referencing your custom view in the RecyclerView item XML, make sure you use the complete package path. If you only write <SquareButton>, the system might not resolve the class correctly (unlike the built-in Button which is recognized automatically).

Example:

<com.yourfullpackage.name.SquareButton
    android:id="@+id/square_btn"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Click Me" />

4. Check ViewHolder initialization and visibility #

Ensure you’re correctly finding the button in your ViewHolder and haven’t accidentally set its visibility to GONE. A common mistake is a typo in the view ID, which makes findViewById return null, or a stray setVisibility(View.GONE) call.

public class MyItemViewHolder extends RecyclerView.ViewHolder {
    public SquareButton squareButton;

    public MyItemViewHolder(View itemView) {
        super(itemView);
        squareButton = itemView.findViewById(R.id.square_btn);
        // Double-check no accidental visibility changes here
        // squareButton.setVisibility(View.GONE); <-- Remove this if present
    }
}

5. Confirm AppCompat theme is applied #

Since SquareButton extends AppCompatButton, it requires an AppCompat-themed context. Make sure your Activity or Application is using a theme that inherits from Theme.AppCompat in AndroidManifest.xml:

<application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:theme="@style/Theme.AppCompat.Light.DarkActionBar"> <!-- This is key -->
    <!-- Your activities here -->
</application>

Without the AppCompat theme, AppCompatButton subclasses can fail to render properly, leading to invisible views.

Go through these steps one by one—chances are one of them will fix your issue!

内容的提问来源于stack exchange，提问作者sbearben