Android技术问题：如何让SearchView仅在ListView顶部显示一次而非每行重复显示

嘿，我来帮你搞定这个问题！你现在的SearchView在ListView每一行都出现，核心原因是布局结构不合理加上Adapter逻辑错误，咱们一步步修正：

第一步：调整主布局，让SearchView成为ListView的顶部独立控件 #

你之前用了FrameLayout（层叠布局），而且把SearchView和ListView放在一起，这会导致控件重叠，更关键的是你可能把SearchView也放进了ListView的item布局里。我们改用LinearLayout（垂直布局），把SearchView放在ListView上方，确保它只在顶部显示一次。

修改后的主布局代码：

<LinearLayout 
    xmlns:android="http://schemas.android.com/apk/res/android" 
    xmlns:tools="http://schemas.android.com/tools" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    android:orientation="vertical"
    tools:context=".Home" 
    android:padding="30dp" >

    <!-- 顶部搜索框，仅显示一次 -->
    <SearchView 
        android:layout_width="match_parent" 
        android:layout_height="wrap_content" 
        android:queryHint="Search here..." 
        android:iconifiedByDefault="false" 
        android:focusedByDefault="true" 
        android:transitionName="Search_box" 
        android:id="@+id/search_view"/>

    <!-- ListView占据剩余空间 -->
    <ListView 
        android:id="@+id/list" 
        android:layout_width="match_parent" 
        android:layout_height="0dp"
        android:layout_weight="1"/>

</LinearLayout>

第二步：清理ListView的item布局 #

你的ListView item布局（也就是R.layout.fragment_home）里绝对不能包含SearchView，它只需要放每一行要显示的内容，比如你的文本控件：

<TextView 
    android:layout_width="match_parent" 
    android:layout_height="wrap_content" 
    android:background="#ED0316" 
    android:textSize="22sp" 
    android:fontFamily="sans-serif-condensed-light" 
    android:textColor="#fafafa" 
    android:id="@+id/txt"
    android:padding="16dp"/> <!-- 增加内边距提升显示体验 -->

第三步：修复Adapter代码，专注处理ListView的item #

之前的Adapter逻辑完全错了——你不应该在getView里控制主布局的SearchView，Adapter的职责只是渲染ListView的每一行数据。这里给你一个正确的实现，还加入了ViewHolder模式提升性能：

public class ContractorAdapter extends ArrayAdapter<String> { // 替换成你实际的数据类型
    private ArrayList<String> mDataList;
    private Context mContext;

    public ContractorAdapter(@NonNull Context context, ArrayList<String> dataList) {
        super(context, R.layout.fragment_home, dataList);
        mContext = context;
        mDataList = dataList;
    }

    // ViewHolder用于复用布局，避免重复findViewById
    public static class ViewHolder {
        TextView txt;
    }

    @NonNull
    @Override
    public View getView(int position, @Nullable View convertView, @NonNull ViewGroup parent) {
        ViewHolder holder;

        // 初始化布局和ViewHolder（第一次加载时）
        if (convertView == null) {
            convertView = LayoutInflater.from(mContext).inflate(R.layout.fragment_home, parent, false);
            holder = new ViewHolder();
            holder.txt = convertView.findViewById(R.id.txt);
            convertView.setTag(holder);
        } else {
            // 复用已有的ViewHolder
            holder = (ViewHolder) convertView.getTag();
        }

        // 设置当前行的文本内容
        holder.txt.setText(mDataList.get(position));
        return convertView;
    }
}

第四步：在Activity/Fragment中初始化控件 #

最后在你的Home页面里，初始化SearchView和ListView，并设置Adapter，还可以添加搜索过滤的逻辑：

public class Home extends AppCompatActivity { // 如果是Fragment就改成Fragment
    private ListView mListView;
    private SearchView mSearchView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.your_main_layout_id); // 替换成你的主布局ID

        mListView = findViewById(R.id.list);
        mSearchView = findViewById(R.id.search_view);

        // 初始化示例数据
        ArrayList<String> dataList = new ArrayList<>();
        dataList.add("Contractor 1");
        dataList.add("Contractor 2");
        dataList.add("Contractor 3");
        // 添加更多数据...

        // 设置Adapter
        ContractorAdapter adapter = new ContractorAdapter(this, dataList);
        mListView.setAdapter(adapter);

        // 给SearchView添加搜索监听（可选，实现实时过滤）
        mSearchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
            @Override
            public boolean onQueryTextSubmit(String query) {
                // 处理搜索提交操作
                return false;
            }

            @Override
            public boolean onQueryTextChange(String newText) {
                // 实时过滤ListView数据
                adapter.getFilter().filter(newText);
                return false;
            }
        });
    }
}

为什么之前的代码会出错？ #

1. 你错误地在Adapter的getView方法里控制主布局的SearchView，而getView是用来渲染每个ListView item的，这完全搞错了控件的归属；
2. 主布局用了FrameLayout导致控件重叠，没有明确的垂直布局结构；
3. Adapter没有正确实现ViewHolder模式，也没有初始化布局，会引发性能问题和显示异常。

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