Menampilkan ListView Dengan Data Dari Model Menggunakan Flutter

Di tutorial kali ini, kita membuat aplikasi yang menampilkan listview dengan data dari model menggunakan Flutter. Aplikasi yang akan kita buat, mirip Instagram yang menampilkan banyak postingan. Postingan2 tersebut akan menampilkan lirik dari lagu Jason Mraz yang berjudul “The Woman I Love”. Sebuah lagu romantis yang disukai penulis he3..

Mari kita mulai! Kita akan mulai koding dari aplikasi yang sudah dibuat di tutorial sebelumnya. Kodingannya bisa didownload di https://github.com/meidikawardana/like_app . Download project tersebut, ekstrak lalu rename folder hasil ekstrakan menjadi “instagram_list”. Kemudian buka folder tersebut di Visual Studio Code (VSCode).

Seharusnya akan ada banyak error di tab “Problems” di kanan bawah, karena file2 package yang dibutuhkan oleh Flutter harus didownload dulu. Jadi buka terminal di VSCode, lalu ketik: flutter pub get .

gambar 1 - jalankan flutter pub get

Setelah semua error hilang, tekan Ctrl+F5 untuk menjalankan project ke emulator. Kalau project berhasil dijalankan di emulator, kita bisa mulai mengubah kodingannya. Buka folder lib di kanan, lalu dobel klik file main.dart untuk membuka file tersebut.

Di file main.dart, ada 2 class yaitu class InstagramCards & class AplikasiLikeInstagram . Kita bisa memindahkan (refactoring) sebagian isi class InstagramCards supaya file main.dart lebih ringkas & lebih mudah dibaca. Buat file baru di dalam folder lib dengan klik kanan di folder lib, lalu pilih “New File”. Lalu beri nama: “instagram_card.dart”. Dobel klik untuk buka file baru tersebut, lalu isi file tersebut dengan kodingan berikut ini:

import 'package:flutter/material.dart';

class InstagramCard extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return null;
  }

}

Lalu kita kembali ke file main.dart. Sorot kodingan pakai mouse, dari baris ke-10 s/d baris ke-120. Kemudian cut kodingan tersebut. Kembali ke file instagram_card.dart, sorot: null di baris ke-6, lalu paste kodingan dari main.dart. Seharusnya akan ada error di baris ke-116 di instagram_card.dart. Hapus koma di baris tersebut supaya errornya hilang. Kemudian tekan Ctrl+S untuk menyimpan file instagram_card.dart. Kalau kesulitan, source nya ada di https://gist.github.com/meidikawardana/c84fab4c24be78fce1f0831b3cf2c61b

Sampai sini, kita sudah memindahkan widget card. Sekarang kita perlu memasukkan widget card tersebut ke class InstagramCards di file main.dart supaya widget card ditampilkan di aplikasi. Kita tinggal “memanggil” class InstagramCard di file main.dart seperti berikut ini:

import 'package:flutter/material.dart';
import 'package:like_app/instagram_card.dart';

void main() => runApp(AplikasiLikeInstagram());

class InstagramCards extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ListView(
      children: <Widget>[
        InstagramCard()
      ],
    );
  }
}

...

Setelah itu, simpan file main.dart dengan menekan Ctrl+S. Seharusnya tampilan di aplikasi akan sama dengan sebelum kita memindah kodingan card.

Saat ini, card berisi postingan yang ditampilkan di aplikasi hanya ada 1 buah. Kita bisa dengan mudah menampilkan lebih dari 1 card. Kita tinggal menambahkan beberapa card dengan metode looping. Ubah class InstagramCards di main.dart jadi seperti ini:

class InstagramCards extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    List<Widget> cards = new List.generate(3, (i) => new InstagramCard());

    return ListView(
      children: cards,  /*<Widget>[
        InstagramCard()
      ],*/ 
    );
  }
}

Yang berwarna biru di kodingan di atas, adalah untuk membuat beberapa card menggunakan looping (perintah List.generate()), lalu membuat hasilnya (variabel cards) menjadi anak (children) dari widget ListView. Sedangkan kodingan sebelumnya berwarna merah yang menampilkan hanya 1 card, kita komen dengan tanda /* di sebelum dan tanda */ di sesudahnya. Coba jalankan lagi ke emulator dengan Ctrl+F5, maka akan tampil 3 card berisi postingan mirip instagram 😀

Saat ini, card hanya menampilkan teks dan gambar yang kita tulis di kodingan class InstagramCard. Kita perlu membuat supaya card menampilkan data dari sebuah class model, supaya nantinya kita bisa mengubah2 data yang ditampilkan dengan lebih mudah. Buat 1 folder baru di folder lib di sebelah kanan, dan beri nama “models” untuk folder baru tersebut. Di dalam folder “models”, buat file “instagram_post.dart” yang berisi class model yang kita perlukan.

gambar 1b - membuat file instagram_post.dart di folder models

Isi file “instagram_post.dart” adalah seperti berikut ini:

import 'package:flutter/material.dart';

class InstagramPost {
  final String profilePicture;
  final String username;
  final String picture;
  final int likeCount;
  final String text;

  InstagramPost(
      {@required this.profilePicture,
      @required this.username,
      @required this.picture,
      @required this.likeCount,
      @required this.text});
}

Struktur folder project kita akan seperti ini:

gambar 2 - struktur project listview flutter

Setelah kita membuat class model, kita bisa menggunakan class model tersebut untuk menampilkan data. Di file main.dart, kita bisa memanggil class tersebut, membuat sebuah obyek menggunakan model tersebut, lalu memasukkan obyek tersebut ke card supaya ditampilkan di card. Ubah kodingan main.dart jadi seperti berikut ini:

import 'package:flutter/material.dart';
import 'package:like_app/instagram_card.dart';

import 'models/instagram_post.dart';

void main() => runApp(AplikasiLikeInstagram());

class InstagramCards extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    InstagramPost instagramPost = new InstagramPost(
        profilePicture: 'images/insta_profpic.jpg',
        username: 'meidika_wardana',
        picture: 'images/insta_pic.jpg',
        likeCount: 1,
        text:
            'Lagi lucu2nya nih ... he3. Semoga jadi anak yang berbakti ke ortu :D');

    List<Widget> cards =
        new List.generate(3, (i) => new InstagramCard(instagramPost));

    return ListView(
      children: cards, /*<Widget>[
        InstagramCard()
      ],*/
    );
  }
}

...

Di kodingan di atas, di warna biru kita mengimport file instagram_post.dart ke file main.dart supaya kita bisa menggunakan class InstagramPost. Di warna hijau, kita membuat sebuah obyek menggunakan class InstagramPost. Obyek ini berisi data yang bisa tampilkan di sebuah card. Setelah kita membuat obyek tersebut, kita memasukkan obyek tersebut ke InstagramCard.

Saat ini kodingan kita akan error karena class InstagramCard perlu kita ubah supaya bisa menerima obyek InstagramPost. Jadi buka file instagram_card.dart, lalu ubah isinya jadi seperti berikut ini:

import 'package:flutter/material.dart';

import 'models/instagram_post.dart';

class InstagramCard extends StatelessWidget {

  final InstagramPost _instagramPost;

  InstagramCard(this._instagramPost);

  @override
  Widget build(BuildContext context) {
    return Column(
      children: <Widget>[
        Row(
          // row #1
          children: [
            Container(
              child: Image.asset(
                _instagramPost.profilePicture,
                width: 30,
                fit: BoxFit.contain,
              ),
              margin: EdgeInsets.all(10),
            ),
            Expanded(
              child: Text(
                _instagramPost.username,
                style: TextStyle(
                  fontWeight: FontWeight.bold,
                ),
              ),
            ),
            IconButton(
              icon: Icon(Icons.more_vert),
              onPressed: () {},
            )
          ],
        ),
        Row(
          //row #2
          children: <Widget>[
            Expanded(
              child: Image.asset(_instagramPost.picture),
            )
          ],
        ),
        Row(
          //row #3
          children: <Widget>[
            IconButton(
              icon: Image.asset(
                'images/ic_love.png',
                fit: BoxFit.contain,
              ),
              onPressed: () {},
            ),
            IconButton(
              icon: Image.asset(
                'images/ic_comment.png',
                fit: BoxFit.contain,
              ),
              onPressed: () {},
            ),
            IconButton(
              icon: Image.asset(
                'images/ic_send.png',
                fit: BoxFit.contain,
              ),
              onPressed: () {},
            ),
            Expanded(
              child: IconButton(
                icon: Image.asset(
                  'images/ic_save.png',
                  fit: BoxFit.contain,
                ),
                onPressed: () {},
                padding: EdgeInsets.only(right: 10),
                alignment: Alignment.centerRight,
              ),
            ),
          ],
        ),
        Row(
          //row #4
          children: <Widget>[
            Container(
              child: Text(
                _instagramPost.likeCount.toString() + ' like',
                style: TextStyle(fontWeight: FontWeight.bold),
              ),
              padding: EdgeInsets.only(left: 10),
            ),
          ],
        ),
        Row(
          //row #5
          children: <Widget>[
            Container(
              child: RichText(
                text: new TextSpan(
                  style: new TextStyle(
                    fontSize: 14.0,
                    color: Colors.black,
                  ),
                  children: <TextSpan>[
                    TextSpan(
                        text: _instagramPost.username + ' ',
                        style: new TextStyle(fontWeight: FontWeight.bold)),
                    TextSpan(text: _instagramPost.text),
                  ],
                ),
              ),
              padding: EdgeInsets.only(left: 10, top: 5, bottom: 10),
              width: MediaQuery.of(context).size.width * 0.8,
            )
          ],
        ),
      ],
    );
  }
}

Di kodingan di atas, di warna biru kita mengimport file instagram_post supaya kita bisa menggunakan class InstagramPost di file instagram_card.dart. Kemudian di warna hijau, kita membuat sebuah obyek InstagramPost, dan menggunakan obyek tersebut supaya class InstagramCard bisa menerima obyek InstagramPost di file main.dart. Kita menerima obyek tersebut di fungsi yang biasa disebut constructor. Nah, setelah obyek tersebut diterima, kita bisa menggunakan obyek tersebut untuk menampilkan data2 di card, yang di kodingan di atas berwarna merah. Cukup banyak data yang perlu ditampilkan mulai dari gambar profile (profile picture) sampai teks postingan yang ada di card. Kalau kita jalankan lagi ke emulator, maka tampilan aplikasi masih sama, menampilkan 3 postingan seperti sebelumnya.

gambar 3 - tampilan aplikasi flutter pakai listview

Karena kita sudah memisahkan class InstagramCard jadi file tersendiri dari main.dart, kita bisa lebih mudah mengubah-ubah tampilan card. Kita tinggal mengubah class InstagramCard, maka tampilan semua card akan berubah. Misal kita mau mengubah gambar postingan, dari yang sekarang dimuat dari gambar di folder images, menjadi gambar yang dimuat dari internet. Maka kita tinggal mengubah class InstagramCard seperti berikut ini.

    ...
    Row( //file instagram_card.dart sekitar baris ke-39
      //row #2
      children: <Widget>[
        Expanded(
          child:
              // Image.asset(_instagramPost.picture)
              Image.network(_instagramPost.picture),
        )
      ],
    ),
    ...

Intinya kita tinggal mengubah dari Image.asset() jadi Image.network(). Cuma, kalau kita coba lagi jalankan aplikasi ke emulator, maka gambarnya tidak muncul dan di tab “debug console” di bagian bawah akan ada banyak error. Karena kita mencoba untuk memuat gambar dari variabel _instagramPost.picture, yang isinya adalah “images/insta_pic.jpg” (bisa dilihat di file main.dart sekitar baris ke-14). Padahal, kalau kita pakai Image.network(), maka kita harus memuat gambar dari sebuah link url.

Maka sekarang kita perlu mengubah obyek InstagramPost sesuai kebutuhan. Coba ubah obyek InstagramPost di file main.dart jadi seperti berikut ini:

	...
  @override //file main.dart sekitar baris ke-10
  Widget build(BuildContext context) {
    InstagramPost instagramPost = new InstagramPost(
        profilePicture: 'images/insta_profpic.jpg',
        username: 'meidika_wardana',
        picture:  'https://pintar-android.com/wp_res/insta_pic2.png',
        likeCount: 3,
        text: 'Lagu romantis dari Jason Mraz :D');


    List<Widget> cards =
        new List.generate(3, (i) => new InstagramCard(instagramPost));
	...

Nah.. sekarang kita bisa coba jalankan lagi aplikasi ke emulator dengan Ctrl+F5. Tapi ada kemungkinan aplikasi masih belum menampilkan gambar. Jadi kita kita bisa stop aplikasi dengan menekan tombol stop di VSCode, lalu tekan lagi Ctrl+F5. Maka aplikasi akan menampilkan gambar & isi card sesuai yang kita ubah di InstagramPost barusan.

gambar 4 - tampilan aplikasi dengan gambar baru

Dengan membuat obyek InstagramPost, kita lebih mudah mengubah isi card termasuk gambar yang dimuat. Jadi ngga percuma, kan, kita buat obyek InstagramPost? He3..

Tutorial kali ini sudah bisa dianggap selesai, tapi ada 1 hal kecil yang kurang. Kalau diperhatikan, postingan di aplikasi Instagram asli selalu memuat gambar yang ukurannya kotak sempurna (bujursangkar), kan? Nah, di aplikasi kita, ternyata tampilan gambar masih menyesuaikan ukuran asli gambar tersebut, & belum tentu kotak sempurna. Untuk memperbaiki ini, caranya cukup mudah. Tinggal ubah di file instagram_card.dart, class InstagramCard, lalu tambahkan kodingan seperti berikut ini.

...

class InstagramCard extends StatelessWidget {
  final InstagramPost _instagramPost;

  InstagramCard(this._instagramPost);

  @override
  Widget build(BuildContext context) {
    double _screenWidth = MediaQuery.of(context).size.width;

    return Column(
		...
        Row(
          //row #2
          children: [
            Expanded(
              child: Container(
                child:  // Image.asset(_instagramPost.picture)
                    Image.network(
                  _instagramPost.picture,
                  fit: BoxFit.contain,
                  height: _screenWidth,
                ),
                color: Colors.black,
              ),
            )
          ],
        ),
		...

Coba jalankan lagi aplikasinya ke emulator, maka tampilannya akan lebih mirip Instagram.

gambar 5 - aplikasi yang menampilkan listview dengan data dari model menggunakan Flutter sudah selesai

Secara pribadi, saya lebih suka tampilan sebelumnya. Tapi karena kali ini kita mau bikin aplikasi yang semirip mungkin dengan Instagram, maka kita perlu ubah sedikit hal kecil tadi 🙂 .

Kodingan lengkap untuk tutorial ini ada di https://github.com/meidikawardana/instagram_list .

Demikian tutorial kali ini, mengenai menampilkan listview dengan data dari model menggunakan Flutter. Semoga bermanfaat dan jangan lupa like page pintar-android.com di FB untuk mendapatkan artikel & tutorial lainnya yang pastinya berguna di dunia pemrograman khususnya android.

===============================================================

Tersedia buku-buku untuk belajar pemrograman Android.

Buku pertama, menginstall Android Studio: https://play.google.com/store/books/details?id=EOufCwAAQBAJ .

Buku kedua, membuat recyclerview yang menampilkan gambar2 dari internet menggunakan json: https://play.google.com/store/books/details?id=b-boDAAAQBAJ .

Buku registrasi user, membuat fitur login & register: https://play.google.com/store/books/details?id=FHMqDwAAQBAJ

Buku Onesignal: https://play.google.com/store/books/details?id=4n1oDwAAQBAJ

Leave a Reply

Your email address will not be published. Required fields are marked *