【Android】スピナー（Spinner）にアイテムを追加する方法をサンプルコード付きで解説

スピナー（Spinner）は、ドロップダウンボタンのようなUIコンポーネントで、複数の選択肢の中から1つの項目を選択するために使用します。この記事では、Androidアプリのスピナーにアイテムを追加する具体的な手順を、サンプルコードとともにわかりやすく解説します。

手順1：Android Studioで新規プロジェクトを作成する

Android Studioを起動し、「File」→「New Project」を選択して、必要な情報を入力して新しいプロジェクトを作成します。

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

res/layout/activity_main.xml に以下のコードを記述します。LinearLayoutの中にSpinnerを配置し、画面中央に表示されるように設定しています。

<?xml version = "1.0" encoding = "utf-8"?>
<android.support.constraint.ConstraintLayout
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">
<LinearLayout
    android:layout_width = "match_parent"
    android:layout_height = "match_parent"
    android:gravity = "center"
    android:orientation = "vertical">
    <Spinner
        android:id = "@+id/spinner"
        android:layout_width = "wrap_content"
        android:layout_height = "wrap_content"
        android:prompt = "@string/app_name"
    />
</LinearLayout>
</android.support.constraint.ConstraintLayout>

※ 新しいバージョンのAndroid Studioで作成したプロジェクトでは、ルート要素が「androidx.constraintlayout.widget.ConstraintLayout」になっている場合があります。その場合は、既存のルート要素をそのまま利用してください。

手順3：MainActivity.javaを編集する

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

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ArrayAdapter;
import android.widget.Spinner;
import android.widget.Toast;
import java.util.ArrayList;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Spinner spinner = findViewById(R.id.spinner);
        ArrayList<String> arrayList = new ArrayList<>();
        arrayList.add("JAVA");
        arrayList.add("ANDROID");
        arrayList.add("C Language");
        arrayList.add("CPP Language");
        arrayList.add("Go Language");
        arrayList.add("AVN SYSTEMS");
        ArrayAdapter<String> arrayAdapter = new ArrayAdapter<String>(this,
                android.R.layout.simple_spinner_item, arrayList);
        arrayAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
        spinner.setAdapter(arrayAdapter);
        spinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
            @Override
            public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
                String tutorialsName = parent.getItemAtPosition(position).toString();
                Toast.makeText(parent.getContext(), "Selected: " + tutorialsName,
                        Toast.LENGTH_LONG).show();
            }
            @Override
            public void onNothingSelected(AdapterView<?> parent) {
            }
        });
    }
}

コードのポイント解説

上記のコードでは、まずArrayListに表示したいアイテムを追加し、それをArrayAdapterに渡しています。

ArrayList<String> arrayList = new ArrayList<>();
arrayList.add("JAVA");
arrayList.add("ANDROID");
arrayList.add("C Language");
arrayList.add("CPP Language");
arrayList.add("Go Language");
arrayList.add("AVN SYSTEMS");
ArrayAdapter<String> arrayAdapter = new ArrayAdapter<String>(this, android.R.layout.simple_spinner_item, arrayList);

ArrayAdapterは、リストデータとスピナーなどのUIを仲介する役割を持つアダプターです。「android.R.layout.simple_spinner_item」で通常時の表示レイアウトを指定し、「setDropDownViewResource()」でドロップダウン表示時のレイアウトを指定しています。さらに「setOnItemSelectedListener()」を実装することで、ユーザーが項目を選択したタイミングを検知し、Toastメッセージで選択結果を表示できます。

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

それでは、実際にアプリを実行してみましょう。ここでは、実機のAndroidスマートフォンがパソコンに接続されているものとして説明します。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。接続したモバイルデバイスを選択すると、スマートフォンにアプリの初期画面が表示されます。

スピナーをタップするとドロップダウンリストが展開され、任意の項目を選択できます。項目を選ぶと、以下のようにToastで選択内容が表示されます。