【Android】ListViewにヘッダーアイテムを追加する方法をわかりやすく解説

この記事では、AndroidアプリでListViewにヘッダーアイテムを追加する方法を、実際に動作するサンプルコードとともにステップごとに解説します。

手順1：新しいプロジェクトを作成する

まずはAndroid Studioで新しいプロジェクトを作成しましょう。メニューから「File → New Project」を選択し、必要な項目をすべて入力してプロジェクトをセットアップしてください。

手順2：レイアウトファイル（activity_main.xml）を編集する

次に、res/layout/activity_main.xml に以下のコードを追加します。

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android"
    xmlns:tools = "https://schemas.android.com/tools"
    android:layout_width = "match_parent"
    android:layout_height = "match_parent"
    tools:context = ".MainActivity"
    android:orientation = "vertical">

    <EditText
        android:id = "@+id/name"
        android:layout_width = "match_parent"
        android:hint = "Enter Name"
        android:layout_height = "wrap_content" />

    <LinearLayout
        android:layout_width = "wrap_content"
        android:layout_height = "wrap_content">
            <Button
                android:id = "@+id/save"
                android:text = "Save"
                android:layout_width = "wrap_content"
                android:layout_height = "wrap_content" />
            <Button
                android:id = "@+id/refresh"
                android:text = "Refresh"
                android:layout_width = "wrap_content"
                android:layout_height = "wrap_content" />
    </LinearLayout>
    <ListView
        android:id = "@+id/listView"
        android:layout_width = "match_parent"
        android:layout_height = "wrap_content">
    </ListView>
</LinearLayout>

このレイアウトでは、画面の構成要素として以下を配置しています。

• EditText：名前を入力するためのテキストフィールド
• Saveボタン：入力された名前をArrayListに保存
• Refreshボタン：ListViewの表示内容を最新の状態に更新
• ListView：保存されたデータを一覧表示

ユーザーがSaveボタンをタップすると入力値がArrayListに格納され、Refreshボタンを押すことでListViewの変更内容が画面に反映される仕組みです。

手順3：MainActivity.java を実装する

続いて、src/MainActivity.java に以下のコードを記述します。

package com.example.andy.myapplication;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.EditText;
import android.widget.ListView;
import android.widget.Toast;

import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashSet;
import java.util.Set;

public class MainActivity extends AppCompatActivity {
    EditText name;
    ArrayAdapter arrayAdapter;
    ArrayList<String> array_list;
    Set set = new HashSet();
    private ListView listView;

    @Override
    protected void onCreate(Bundle readdInstanceState) {
        super.onCreate(readdInstanceState);
        setContentView(R.layout.activity_main);
        array_list = new ArrayList<String>();
        array_list.ensureCapacity(20);
        name = findViewById(R.id.name);
        listView = findViewById(R.id.listView);
        findViewById(R.id.refresh).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                arrayAdapter.notifyDataSetChanged();
                listView.invalidateViews();
                listView.refreshDrawableState();
            }
        });

        findViewById(R.id.save).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (!name.getText().toString().isEmpty()) {
                    set.add(name.getText().toString());
                    array_list.clear();
                    if (array_list.isEmpty()) {
                        array_list.add(0, "HEADER");
                        array_list.addAll(set);
                        Collections.sort(array_list, new Comparator<String>() {
                            @Override
                            public int compare(String o1, String o2) {
                                return o1.compareTo(o2);
                            }
                        });
                        array_list.trimToSize();
                        arrayAdapter = new ArrayAdapter(MainActivity.this, android.R.layout.simple_list_item_1, array_list);
                        listView.setAdapter(arrayAdapter);
                    } else {
                        listView.setVisibility(View.GONE);
                    }

                    Toast.makeText(MainActivity.this, "Inserted", Toast.LENGTH_LONG).show();
                } else {
                    name.setError("Enter NAME");
                }
            }
        });
    }
}

コードのポイント

このコードの重要なポイントは、Saveボタンが押されたタイミングで array_list.add(0, "HEADER") を呼び出し、リストの先頭（インデックス0）にヘッダーアイテムを挿入している点です。その後、Collections.sort() によって全アイテムをアルファベット順にソートし、ArrayAdapterを通じてListViewに反映しています。また、入力欄が空の場合は setError() によりエラーメッセージを表示するバリデーションも実装されています。

アプリを実行して動作を確認する

それでは実際にアプリを実行してみましょう。Android端末をパソコンに接続した状態で、Android Studio上でアクティビティファイルを開き、ツールバーのRunアイコンをクリックします。接続したモバイルデバイスを選択すると、端末に以下のような画面が表示されます。

上記の実行結果を見ると、リストの各子アイテムの先頭に「HEADER」というヘッダーアイテムが正しく追加されて表示されていることが確認できます。