萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android ListView 子控件點擊事件錯位問題根因與解決方案

問題現象

ListView 滾動時,子項內的按鈕、EditText、Spinner 等控件點擊事件觸發位置錯誤(如點擊第 5 項卻響應第 2 項的數據),或輸入法彈出導致列表重繪後焦點錯亂。

核心原因

  1. View 復用機制: convertView 被重用,但持有的舊 Tag/監聽器未及時更新。
  2. 位置索引變化: 滾動時 position 參數指向當前可見項,而非數據源固定索引。
  3. 輸入法導致重繪: EditText 聚焦彈出鍵盤 → 窗口調整 → ListView 重新佈局 → getView 再次調用,位置邏輯混亂。

解決方案對比

方案一:在 getView 中設置 Tag 綁定當前 position(基礎修復)

@Override
public View getView(final int position, View convertView, ViewGroup parent) {
    ViewHolder holder;
    if (convertView == null) {
        convertView = inflater.inflate(R.layout.item, null);
        holder = new ViewHolder();
        holder.btn = convertView.findViewById(R.id.btn);
        holder.et = convertView.findViewById(R.id.et);
        convertView.setTag(holder);
    } else {
        holder = (ViewHolder) convertView.getTag();
    }

    // 關鍵:每次綁定最新 position
    holder.btn.setTag(position);
    holder.et.setTag(position);

    holder.btn.setOnClickListener(v -> {
        int pos = (int) v.getTag(); // 獲取當前正確位置
        doAction(pos);
    });

    holder.et.setOnFocusChangeListener((v, hasFocus) -> {
        if (!hasFocus) {
            int pos = (int) v.getTag();
            saveInput(pos, ((EditText)v).getText().toString());
        }
    });

    // 填充數據
    bindData(holder, position);
    return convertView;
}

方案二:使用 ViewHolder 持有數據模型對象(推薦)

class ViewHolder {
    TextView tvName;
    EditText etInput;
    Button btnAction;
    TaskData data; // 直接持有數據模型
}

@Override
public View getView(int position, View convertView, ViewGroup parent) {
    ViewHolder holder;
    if (convertView == null) { ... }
    else { holder = (ViewHolder) convertView.getTag(); }

    holder.data = dataList.get(position); // 綁定模型
    holder.tvName.setText(holder.data.name);
    holder.etInput.setText(holder.data.input);

    holder.btnAction.setOnClickListener(v -> {
        // 直接使用 holder.data 操作,無需 position
        handleAction(holder.data);
    });
    return convertView;
}

方案三:針對輸入法導致的焦點錯亂(進階)

// 在 Adapter 中維護當前焦點位置
private int focusedPosition = -1;

@Override
public View getView(final int position, View convertView, ViewGroup parent) {
    ...
    holder.et.setOnTouchListener((v, event) -> {
        if (event.getAction() == MotionEvent.ACTION_UP) {
            focusedPosition = position; // 記錄觸摸時的位置
        }
        return false;
    });

    // 最後根據 focusedPosition 手動恢復焦點
    if (position == focusedPosition) {
        holder.et.requestFocus();
    }
    return convertView;
}

根治建議:遷移到 RecyclerView

  • RecyclerView.ViewHolder 由佈局管理器管理,位置穩定(getAdapterPosition())。
  • ItemAnimator 預設處理動畫,不干擾焦點。
  • 配合 DiffUtil 局部刷新,避免整體重繪導致焦點丟失。
  • EditText 焦點管理可使用 android:descendantFocusability="beforeDescendants" + android:focusableInTouchMode="true" 在父容器。

總結

ListView 子控件事件錯位本質是「視圖復用與數據綁定不同步」。核心原則:**在 getView 最後一刻,將最新位置/模型綁定到控件 Tag 或 Holder 中,事件回調時從控件取值而非依賴外部變量**。

copyright © 萬盛學電腦網 all rights reserved