Antarmuka

BAB 5: Komponen Antarmuka

Menyusun layar dengan View, Text, Image, dan Pressable, mengatur layout memakai flexbox, serta memilih antara ScrollView, FlatList, dan SectionList.

Bab 4 menghasilkan layar yang berfungsi, tapi tampilannya masih sederhana. Bab ini membahas cara menyusun antarmuka yang rapi di berbagai ukuran layar, memakai komponen bawaan React Native tanpa library tambahan.

Semua komponen di bab ini adalah komponen native. Tidak ada HTML di dalamnya, dan tidak ada CSS cascade. Setiap komponen membawa gayanya sendiri, dan itu mengubah cara berpikir tentang tata letak.

Komponen inti

KomponenFungsiPadanan AndroidPadanan iOS
Viewwadah layoutViewGroupUIView
Textteks, wajib untuk semua tulisanTextViewUILabel
Imagegambar lokal atau dari jaringanImageViewUIImageView
Pressablearea sentuh dengan umpan balikView dengan listener sentuhUIControl
TextInputinput teksEditTextUITextField
ScrollViewwadah yang bisa digulirScrollViewUIScrollView
FlatListdaftar dengan render bertahapRecyclerViewUITableView
SectionListdaftar berkelompokRecyclerView dengan headerUITableView bergrup

Satu aturan yang sering dilanggar pemula: teks harus berada di dalam Text. Menaruh string langsung di dalam View akan menghasilkan error, bukan teks yang tampil.

Flexbox, dengan satu perbedaan penting

React Native memakai flexbox, tapi arah bawaannya berbeda dari web. Di web, flex-direction bawaannya row. Di React Native, bawaannya column.

Artinya, 2 View di dalam satu wadah akan bertumpuk vertikal tanpa kamu menulis apa pun.

React TSXTSX
<View style={{ padding: 16, gap: 12 }}>
  <View style={{ height: 60, backgroundColor: "#c7d2fe" }} />
  <View style={{ height: 60, backgroundColor: "#a5b4fc" }} />
</View>

Untuk menyusun mendatar, tulis flexDirection: "row". Properti gap tersedia dan lebih rapi daripada menambahkan margin pada setiap anak.

5 properti berikut menangani hampir semua kebutuhan:

PropertiEfek
flexDirectionarah susunan, column (bawaan) atau row
justifyContentpembagian ruang pada sumbu utama
alignItemsperataan pada sumbu silang
flexseberapa besar anak mengambil ruang sisa
gapjarak antar anak

Contoh header dengan judul di kiri dan aksi di kanan:

React TSXTSX
<View style={{ flexDirection: "row", alignItems: "center", justifyContent: "space-between", padding: 16 }}>
  <Text style={{ fontSize: 18, fontWeight: "600" }}>Pengaturan</Text>
  <Pressable hitSlop={10}>
    <Text style={{ color: "#6366f1", fontWeight: "600" }}>Simpan</Text>
  </Pressable>
</View>

Untuk membagi ruang secara proporsional, gunakan flex. Anak dengan flex: 2 mendapat 2 kali ruang anak dengan flex: 1.

React TSXTSX
<View style={{ flexDirection: "row", gap: 8 }}>
  <View style={{ flex: 2, height: 80, backgroundColor: "#6366f1" }} />
  <View style={{ flex: 1, height: 80, backgroundColor: "#a5b4fc" }} />
</View>

Satu jebakan yang perlu diketahui: teks panjang di dalam row bisa mendorong elemen lain keluar layar. Penyebabnya, teks tidak otomatis menyusut. Solusinya memberi flexShrink: 1 pada wadah teks, atau flex: 1 bila memang harus mengisi sisa ruang.

React TSXTSX
<View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}>
  <View style={{ width: 44, height: 44, borderRadius: 22, backgroundColor: "#e2e8f0" }} />
  <View style={{ flex: 1 }}>
    <Text numberOfLines={1} style={{ fontWeight: "600" }}>Nama pengguna yang panjang sekali</Text>
    <Text numberOfLines={1} style={{ color: "#64748b" }}>Keterangan tambahan</Text>
  </View>
</View>

Jarak dan skala ukuran

Angka jarak yang acak menghasilkan antarmuka yang terasa tidak konsisten. Pakai skala kelipatan 4 atau 8, dan simpan di satu berkas supaya bisa dipakai berulang.

TypeScriptTS
// lib/jarak.ts
export const jarak = { xs: 4, sm: 8, md: 12, lg: 16, xl: 24, xxl: 32 } as const;
export const radius = { sm: 8, md: 12, lg: 16, penuh: 999 } as const;

Dengan begitu, tinjauan desain tidak berdebat soal 13 atau 14 piksel, karena pilihannya sudah dibatasi.

Teks

Text mendukung beberapa hal yang sering dibutuhkan di mobile:

React TSXTSX
<Text
  numberOfLines={2}
  ellipsizeMode="tail"
  style={{ fontSize: 15, lineHeight: 22, fontWeight: "600" }}
>
  Judul yang panjang akan dipotong setelah 2 baris dengan elipsis di akhir
</Text>

numberOfLines wajib dipakai pada teks dinamis di dalam baris daftar. Tanpa itu, satu judul yang panjang bisa merusak tinggi seluruh baris.

Untuk tulisan yang mengikuti pengaturan ukuran teks sistem, biarkan allowFontScaling tetap aktif. Menonaktifkannya membuat aplikasi terlihat rapi di tangan pengembang, tapi menyulitkan pengguna yang memperbesar teks karena kebutuhan penglihatan.

Teks bersarang bisa dipakai untuk menebalkan sebagian kalimat tanpa memecah paragraf:

React TSXTSX
<Text style={{ fontSize: 15 }}>
  Status pesanan: <Text style={{ fontWeight: "700" }}>dalam pengiriman</Text>
</Text>

Gambar

Ada 2 sumber gambar, dan keduanya berbeda perilaku.

React TSXTSX
// gambar lokal, ukurannya diketahui saat build
const logo = require("../assets/logo.png");

export function Kepala() {
  return (
    <View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}>
      <Image source={logo} style={{ width: 40, height: 40 }} />
      <Image
        source={{ uri: "https://contoh.com/foto.jpg" }}
        style={{ width: 40, height: 40, borderRadius: 20 }}
        resizeMode="cover"
      />
    </View>
  );
}

Gambar dari jaringan wajib diberi ukuran. Tanpa width dan height, gambar tidak punya ruang untuk digambar dan tidak akan muncul.

Untuk daftar berisi banyak gambar, expo-image lebih baik daripada Image bawaan karena punya cache di disk dan transisi placeholder:

React TSXTSX
import { Image } from "expo-image";

<Image
  source={{ uri: item.foto }}
  style={{ width: "100%", aspectRatio: 16 / 9, borderRadius: 12 }}
  contentFit="cover"
  transition={200}
/>

Memakai aspectRatio membuat tinggi gambar menyesuaikan lebar layar, sehingga tidak gepeng di perangkat berbeda.

Sentuhan

Pressable adalah pilihan utama untuk area sentuh. Dia memberi informasi pressed, sehingga umpan balik visual bisa dibuat tanpa library animasi.

React TSXTSX
<Pressable
  onPress={simpan}
  disabled={menyimpan}
  android_ripple={{ color: "#c7d2fe" }}
  style={({ pressed }) => ({
    backgroundColor: menyimpan ? "#a5b4fc" : "#6366f1",
    opacity: pressed ? 0.85 : 1,
    paddingVertical: 14,
    borderRadius: 12,
    alignItems: "center",
  })}
  accessibilityRole="button"
  accessibilityState={{ disabled: menyimpan }}
>
  <Text style={{ color: "#ffffff", fontWeight: "600" }}>Simpan</Text>
</Pressable>

android_ripple memberi efek gelombang khas Android, sedangkan opacity saat ditekan memberi umpan balik di iOS. Keduanya bisa dipakai bersamaan.

Memilih komponen daftar

Kesalahan paling mahal di React Native adalah memakai ScrollView untuk daftar panjang. ScrollView merender semua anaknya sekaligus, sehingga seratus item berarti seratus komponen di memori.

KebutuhanKomponen
konten pendek dan campuran, misalnya halaman profilScrollView
daftar item sejenis, bisa panjangFlatList
daftar berkelompok dengan judul per grupSectionList
daftar sangat panjang dengan baris seragamFlatList dengan getItemLayout

FlatList yang disiapkan dengan benar:

React TSXTSX
<FlatList
  data={daftar}
  keyExtractor={(item) => item.id}
  renderItem={({ item }) => <ItemCatatan catatan={item} />}
  ItemSeparatorComponent={() => <View style={{ height: 10 }} />}
  ListHeaderComponent={<Text style={{ fontSize: 20, fontWeight: "700", marginBottom: 12 }}>Semua catatan</Text>}
  ListEmptyComponent={<KeadaanKosong />}
  refreshControl={<RefreshControl refreshing={menyegarkan} onRefresh={muatUlang} />}
  onEndReached={muatHalamanBerikutnya}
  onEndReachedThreshold={0.4}
  contentContainerStyle={{ padding: 16 }}
/>

getItemLayout dipakai ketika tinggi setiap baris sudah pasti. Dengan itu, FlatList bisa melompat ke posisi tertentu tanpa mengukur baris satu per satu:

React TSXTSX
const TINGGI_BARIS = 76;

<FlatList
  data={daftar}
  keyExtractor={(item) => item.id}
  renderItem={renderBaris}
  getItemLayout={(_, index) => ({ length: TINGGI_BARIS, offset: TINGGI_BARIS * index, index })}
/>

SectionList dipakai ketika data punya grup, misalnya catatan per bulan:

React TSXTSX
<SectionList
  sections={[
    { title: "November 2026", data: catatanNovember },
    { title: "Oktober 2026", data: catatanOktober },
  ]}
  keyExtractor={(item) => item.id}
  renderItem={({ item }) => <ItemCatatan catatan={item} />}
  renderSectionHeader={({ section }) => (
    <Text style={{ fontSize: 13, fontWeight: "700", color: "#64748b", marginTop: 16, marginBottom: 8 }}>
      {section.title}
    </Text>
  )}
  stickySectionHeadersEnabled={false}
/>

Gaya bersyarat dan mode gelap

StyleSheet.create menerima array gaya, dan nilai false diabaikan. Pola ini membuat gaya bersyarat tetap terbaca.

React TSXTSX
const tema = useColorScheme();

<View style={[gaya.kartu, tema === "dark" && gaya.kartuGelap]}>
  <Text style={[gaya.judul, tema === "dark" && gaya.judulGelap]}>Judul</Text>
</View>

Untuk aplikasi yang serius dengan mode gelap, lebih baik menyimpan warna di satu objek dan memilih berdasarkan tema, daripada menulis pasangan gaya untuk setiap komponen.

Aksesibilitas yang murah

3 atribut berikut menyelesaikan sebagian besar kebutuhan pembaca layar:

  • accessibilityRole menyebutkan jenis elemen, misalnya button atau header
  • accessibilityLabel memberi teks untuk elemen tanpa teks, seperti tombol berikon
  • accessibilityHint menjelaskan akibat dari tindakan, dipakai seperlunya

Untuk gambar dekoratif, beri accessibilityElementsHidden atau importantForAccessibility="no" supaya pembaca layar tidak berhenti di sana.

Kesalahan yang sering terjadi

GejalaPenyebabPerbaikan
teks tidak munculstring ditulis langsung di Viewbungkus dengan Text
layout melebar keluar layarteks dalam row tidak menyusutflex: 1 atau flexShrink: 1 pada wadah teks
gambar dari jaringan kosongtidak ada width dan heightberi ukuran tetap atau aspectRatio
daftar tersendat saat digulirScrollView untuk data panjangganti ke FlatList
baris salah saat dihapuskeyExtractor memakai indekspakai id yang stabil
jarak tidak konsistenangka acakpakai skala 4 atau 8

Latihan singkat

  1. Buat kartu profil dengan avatar 56, nama, dan 2 baris keterangan. Pastikan nama panjang terpotong dengan elipsis, bukan mendorong elemen lain.
  2. Ubah daftar catatan di bab sebelumnya agar memakai SectionList, dikelompokkan per bulan.
  3. Tambahkan RefreshControl dan pastikan indikator berhenti setelah data selesai dimuat.

Ringkasan

Antarmuka React Native disusun dari komponen native dengan flexbox, di mana arah bawaan adalah kolom. Text wajib untuk semua tulisan, gambar dari jaringan wajib berukuran, dan pilihan wadah gulir menentukan performa: ScrollView untuk halaman pendek, FlatList dan SectionList untuk data.

Bab 6 membahas apa yang terjadi ketika data harus dipakai di banyak layar, dan kapan state lokal tidak lagi cukup.