安卓列表视图

原创于 2022-11-24 12:56:47 发布 · 991 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#android

本文介绍了如何在安卓应用中使用ListView显示古诗列表，包括ListView的API、适配器原理、数据源和列表项模板的创建。通过实例展示了如何创建ArrayAdapter，设置点击事件，并跳转到显示古诗内容的界面。

基于Empty Activity模板创建安卓应用 - ReadAncientPoetry

将背景图片拷贝到drawable目录

打开字符串资源文件 strings.xml输入代码：

打开主布局资源文件 activity_main.xml

新建诗歌列表项模板 poem_list_item.xml并输入代码

打开主界面类 - MainActivity输入代码

理论：

列表视图概述

列表视图（ListView）继承了抽象列表视图（AbsListView），而抽象列表视图又继承了适配器视图（AdapterView）。适配器视图具有共同的特征，就是利用适配器将数据源与展示控件绑定起来。

列表视图API文档

https://developer.android.google.cn/reference/android/widget/ArrayAdapter?hl=en

列表视图四要素

要素	说明
列表控件	显示多项供用户选择
适配器	数组适配器、简单适配器、游标适配器、基适配器
数据源	数组、数组列表、游标……
列表项模板	平台资源、用户自定义

列表视图四要素：列表控件、适配器、列表项模板和数据源

四种常用适配器

列表视图（ListView），它是AdapterView的孙子类，要通过适配器作为梁桥来绑定数据源

适配器	含义
ArrayAdapter	数组适配器
SimpleAdapter	简单适配器
SimpleCursorAdapter	简单游标适配器
BaseAdapter	基适配器

数组适配器API文档

https://developer.android.google.cn/reference/android/widget/ArrayAdapter?hl=en

数组适配器构造方法

数组适配器提供了6个重载的构造方法下面的案例我们会用第五种方法。

第5个构造方法的参数说明

具体例子：阅读古诗

基于`Empty Activity`模板创建安卓应用 - `ReadAncientPoetry`

将背景图片拷贝到`drawable`目录

打开字符串资源文件 `strings.xml输入代码：`

具体代码：

<resources>
    <string name="app_name">阅读古诗</string>
    <string name="back">返回目录</string>
    <string-array name="titles">
        <item>静夜思</item>
        <item>登鹳雀楼</item>
        <item>相思</item>
        <item>听弹琴</item>
        <item>登乐游原</item>
        <item>朝发白帝城</item>
        <item>巴山夜雨</item>
        <item>渭城曲</item>
        <item>春夜喜雨</item>
        <item>离离原上草</item>
        <item>示儿</item>
    </string-array>

    <string-array name="authors">
        <item>唐·李白</item>
        <item>唐·王之涣</item>
        <item>唐·王维</item>
        <item>唐·刘长卿</item>
        <item>唐·李商隐</item>
        <item>唐·李白</item>
        <item>唐·杜牧</item>
        <item>唐·王维</item>
        <item>唐·杜甫</item>
        <item>唐·白居易</item>
        <item>宋·陆游</item>
    </string-array>

    <string-array name="contents">
        <item>床前明月光，\n疑是地上霜。\n举头望明月，\n低头思故乡。</item>
        <item>白日依山尽，\n黄河入海流。\n欲穷千里目，\n更上一层楼。</item>
        <item>红豆生南国，\n春来发几枝。\n愿君多采撷，\n此物最相思。</item>
        <item>泠泠七弦上，\n静听松风寒。\n古调虽自爱，\n今人多不弹。</item>
        <item>向晚意不适，\n驱车登古原。\n夕阳无限好，\n只是近黄昏。</item>
        <item>朝辞白帝彩云间，\n千里江陵一日还。\n两岸猿声啼不住，\n轻舟已过万重山。</item>
        <item>君问归期未有期，\n巴山夜雨涨秋池。\n何当共剪西窗烛，\n却话巴山夜雨时。</item>
        <item>渭城朝雨浥轻尘，\n客舍青青柳色新。\n劝君更尽一杯酒，\n西出阳关无故人。</item>
        <item>好雨知时节，当春乃发生。\n随风潜入夜，润物细无声。\n野径云俱黑，江船火独明。\n晓看红湿处，花重锦官城。</item>
        <item>离离原上草，一岁一枯荣。\n野火烧不尽，春风吹又生。\n远芳侵古道，晴翠接荒城。\n又送王孙去，萋萋满别情。</item>
        <item>死去元知万事空，\n但悲不见九州同。\n王师北定中原日，\n家祭无忘告乃翁。 </item>
    </string-array>

</resources>

打开主布局资源文件 `activity_main.xml`

具体代码:

<?xml version="1.0" encoding="utf-8"?>
<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:background="@drawable/background"
    android:padding="15dp"
    tools:context=".MainActivity">

    <ListView
        android:id="@+id/lv_poem_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:divider="#aaaaaa"
        android:dividerHeight="0.5dp"
        />


</LinearLayout>

新建诗歌列表项模板 `poem_list_item.xml并输入代码`

具体代码：

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/tv_poem_title"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:gravity="center_vertical"
    android:minHeight="80dp"
    android:textColor="#0000ff"
    android:textSize="25sp" />

打开主界面类 - `MainActivity输入代码`

具体代码：

package net.zyt.read_ancient_poetry;

import androidx.appcompat.app.AppCompatActivity;

import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    private ListView lvPoemTitle;//诗歌标题列表控件-展示
    private ArrayAdapter<String> adapter;//数组适配器-桥梁
    private String[]titles;//诗歌标题数组-数据源


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //利用布局资源文件设置用户界面
        setContentView(R.layout.activity_main);
        //通过资源标识符获取控件实例
        lvPoemTitle=findViewById(R.id.lv_poem_title);

        //初始化古诗标题数组，作为列表控件的数据源
       titles=getResources().getStringArray(R.array.titles);
        //给诗歌标题添上序号
        for (int i=0; i<titles.length;i++){
            titles[i]=(i+1)+"."+titles[i];
        }
        //创建数组适配器，作为连接列表控件与数据源的桥梁
        adapter=new ArrayAdapter<>(
                this,//上下文-当前窗口
                R.layout.poem_list_item,//列表项模板-自定义布局资源
                titles//数据源-字符串数据组
        );
        //给列表控件设置适配器
        lvPoemTitle.setAdapter(adapter);
        //给列表控件注册项单击监听器
        lvPoemTitle.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> adapterView, View view, int position, long id) {
                Toast.makeText(MainActivity.this,"你选择了古诗["+titles[position]+"]",Toast.LENGTH_SHORT).show();
           //创建意图实现跳转
                Intent intent=new Intent(MainActivity.this,ContentActivity.class);
                //通过意图携带数据（选中的列表项位置）
                intent.putExtra("position",position);
                //按意图启动目标主键
                startActivity(intent);

            }
        });
    }
}

启动应用查看效果

创建内容界面

基于模板创建显示古诗内容的界面ContentActivity

打开界面布局资源文件content_activity.xml输入代码：

具体代码：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/background"
    android:paddingRight="10dp"
    android:gravity="center"
    android:orientation="vertical">

    <TextView
        android:id="@+id/tv_title"
        android:layout_width="wrap_content"
        android:layout_height="0dp"
        android:layout_marginTop="30dp"
        android:layout_marginBottom="20dp"
        android:layout_weight="1"
        android:gravity="center_vertical"
        android:textColor="#ff00ff"
        android:textSize="40sp" />

    <TextView
        android:id="@+id/tv_author"
        android:layout_width="wrap_content"
        android:layout_height="0dp"
        android:layout_marginBottom="20dp"
        android:layout_weight="1"
        android:gravity="center_vertical"
        android:textColor="#000000"
        android:textSize="25sp" />

    <TextView
        android:id="@+id/tv_content"
        android:layout_width="wrap_content"
        android:layout_height="0dp"
        android:layout_marginBottom="20dp"
        android:layout_weight="8"
        android:textColor="#0000ff"
        android:textSize="30sp" />

    <Button
        android:id="@+id/btn_back"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:onClick="doBack"
        android:text="@string/back"
        android:textSize="20sp" />
</LinearLayout>

修改内容界面，显示古诗内容

打开内容界面ContentActivity

具体代码：

package net.zyt.read_ancient_poetry;

import androidx.appcompat.app.AppCompatActivity;

import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.TextView;

public class ContentActivity extends AppCompatActivity {
    private TextView tvTitle;//标题标签
    private TextView tvAuthor;//作者标签
    private TextView tvContent;//内容标签
    private String[] titles;//标题数组
    private String[] authors;//作者数组
    private String[] contents;//内容数组

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //利用布局资源文件设置用户界面
        setContentView(R.layout.activity_content);
        //通过资源标识符获取控件实例
        tvTitle=findViewById(R.id.tv_title);
        tvAuthor=findViewById(R.id.tv_author);
        tvContent=findViewById(R.id.tv_content);
        //获取窗口跳转的意图
        Intent intent=getIntent();
        //判断意图是否为空
        if (intent!=null){
            //获取意图携带数据
            int position=intent.getIntExtra("position",0);
            //获取古诗标题数组
            titles=getResources().getStringArray(R.array.titles);
            //获取古诗作者数组
            authors=getResources().getStringArray(R.array.authors);
            //获取古诗内容标签
            contents=getResources().getStringArray(R.array.contents);
            //设置标题标签文本
            tvTitle.setText(titles[position]);
            //设置作者标签文本
            tvAuthor.setText(authors[position]);
            //设置内容标签文本
            tvContent.setText(contents[position]);

        }
    }
    public void doBack(View view){
        finish();//关闭当前窗口
    }
}