Panduan praktis dan terstruktur mengenai panduan al-quran dengan flutter: menampilkan detail surah (part 6) berstandar enterprise. Pelajari konsep, implementasi kode modern, dan tips arsitektur enterprise siap produksi.
Selamat datang di seri tutorial engineering SiHubung! Pada artikel ini, kita akan membedah secara komprehensif implementasi Panduan Al-Quran Dengan Flutter: Menampilkan Detail Surah (Part 6) Berstandar Enterprise dengan standar kode bersih (clean code), performa tinggi, dan arsitektur siap produksi.
Membangun aplikasi web di era modern memerlukan pondasi yang kokoh. Framework modern memberikan fleksibilitas luar biasa bagi developer untuk menghadirkan fitur kompleks secara cepat tanpa mengabaikan aspek keamanan dan keandalan sistem.
Tahapan Implementasi & Walkthrough Kode
Berikut adalah langkah demi langkah teknis yang dapat Anda ikuti langsung pada codebase Anda:
Tahap 1: Penulisan Kode & Konfigurasi
import 'package:alquran_flutter/detail_surah_model.dart';
import 'package:alquran_flutter/remote_resource.dart';
import 'package:flutter/material.dart';
class DetailSurahPage extends StatefulWidget {
final int id;
const DetailSurahPage({super.key, required this.id});
@override
State<DetailSurahPage> createState() => _DetailSurahPageState();
}
class _DetailSurahPageState extends State<DetailSurahPage> {
final remoteResource = RemoteResource();
final List<Ayat> ayatList = [];
DetailSurahModel detailSurah = DetailSurahModel();
@override
void initState() {
getDetailSurah(widget.id);
super.initState();
}
void getDetailSurah(int id) async {
final result = await remoteResource.detailSurah(id);
result.fold(
(error) => {
ScaffoldMessenger.of(
context,
).showSnackBar(SnackBar(content: Text('Error: $error'))),
},
(data) {
setState(() {
detailSurah = data;
ayatList.addAll(data.ayat ?? []);
});
},
);
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
leading: IconButton(
icon: const Icon(Icons.arrow_back_ios_new_rounded),
onPressed: () {
Navigator.pop(context);
},
),
),
body: Column(
children: [
Container(
width: double.infinity,
height: 200,
padding: const EdgeInsets.all(12),
margin: const EdgeInsets.all(16),
decoration: BoxDecoration(
color: Theme.of(context).colorScheme.secondaryContainer,
borderRadius: BorderRadius.circular(20),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Text(
detailSurah.namaLatin ?? '',
style: const TextStyle(
fontSize: 20,
fontWeight: FontWeight.bold,
),
),
Text(
detailSurah.nama ?? '',
style: const TextStyle(
fontSize: 26,
fontWeight: FontWeight.bold,
),
),
],
),
Divider(
color: Colors.blueGrey.withValues(alpha: 0.5),
thickness: 1,
height: 20,
),
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Column(
spacing: 2,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'(${detailSurah.arti})',
style: const TextStyle(
fontSize: 16,
fontWeight: FontWeight.w500,
),
),
Text(
'${detailSurah.tempatTurun?.toUpperCase()} | ${detailSurah.jumlahAyat} Ayat',
),
],
),
],
),
],
),
),
Expanded(
child: ListView.builder(
itemCount: ayatList.length,
itemBuilder: (context, index) {
return cardAyat(ayatList[index]);
},
),
),
],
),
);
}
Widget cardAyat(Ayat ayat) {
return Card(
elevation: 0.5,
shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(20)),
margin: EdgeInsets.symmetric(vertical: 8, horizontal: 16),
child: Padding(
padding: const EdgeInsets.all(8.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
spacing: 8,
children: [
Row(
spacing: 4,
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: [
Container(
padding: EdgeInsets.all(5),
decoration: BoxDecoration(
border: Border.all(
color: Theme.of(context).colorScheme.primary,
width: 1,
),
borderRadius: BorderRadius.circular(10),
),
child: Text(
'${ayat.surah}:${ayat.nomor}',
style: TextStyle(fontSize: 11),
),
),
Expanded(
child: Directionality(
textDirection: TextDirection.rtl,
child: Text(
ayat.ar ?? '',
style: const TextStyle(fontSize: 24),
),
),
),
],
),
Text('${ayat.idn}'),
],
),
),
);
}
}Tahap 2: Penulisan Kode & Konfigurasi
import 'package:alquran_flutter/detail_surah_model.dart';
import 'package:alquran_flutter/remote_resource.dart';
import 'package:flutter/material.dart';Tahap 3: Penulisan Kode & Konfigurasi
class DetailSurahPage extends StatefulWidget {
final int id;
const DetailSurahPage({super.key, required this.id});
@override
State<DetailSurahPage> createState() => _DetailSurahPageState();
}Tahap 4: Penulisan Kode & Konfigurasi
class _DetailSurahPageState extends State<DetailSurahPage> {
final remoteResource = RemoteResource();
final List<Ayat> ayatList = [];
DetailSurahModel detailSurah = DetailSurahModel();
...
}Tahap 5: Penulisan Kode & Konfigurasi
void initState() {
getDetailSurah(widget.id);
super.initState();
}
void getDetailSurah(int id) async {
final result = await remoteResource.detailSurah(id);
result.fold(
(error) => {
ScaffoldMessenger.of(
context,
).showSnackBar(SnackBar(content: Text('Error: $error'))),
},
(data) {
setState(() {
detailSurah = data;
ayatList.addAll(data.ayat ?? []);
});
},
);
}Tahap 6: Penulisan Kode & Konfigurasi
Widget cardAyat(Ayat ayat) {
return Card(
elevation: 0.5,
shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(20)),
margin: EdgeInsets.symmetric(vertical: 8, horizontal: 16),
child: Padding(
padding: const EdgeInsets.all(8.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
spacing: 8,
children: [
Row(
spacing: 4,
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: [
Container(
padding: EdgeInsets.all(5),
decoration: BoxDecoration(
border: Border.all(
color: Theme.of(context).colorScheme.primary,
width: 1,
),
borderRadius: BorderRadius.circular(10),
),
child: Text(
'${ayat.surah}:${ayat.nomor}',
style: TextStyle(fontSize: 11),
),
),
Expanded(
child: Directionality(
textDirection: TextDirection.rtl,
child: Text(
ayat.ar ?? '',
style: const TextStyle(fontSize: 24),
),
),
),
],
),
Text('${ayat.idn}'),
],
),
),
);
}Tahap 7: Penulisan Kode & Konfigurasi
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
leading: IconButton(
icon: const Icon(Icons.arrow_back_ios_new_rounded),
onPressed: () {
Navigator.pop(context);
},
),
),
body: Column(
children: [
Container(
width: double.infinity,
height: 200,
padding: const EdgeInsets.all(12),
margin: const EdgeInsets.all(16),
decoration: BoxDecoration(
color: Theme.of(context).colorScheme.secondaryContainer,
borderRadius: BorderRadius.circular(20),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Text(
detailSurah.namaLatin ?? '',
style: const TextStyle(
fontSize: 20,
fontWeight: FontWeight.bold,
),
),
Text(
detailSurah.nama ?? '',
style: const TextStyle(
fontSize: 26,
fontWeight: FontWeight.bold,
),
),
],
),
Divider(
color: Colors.blueGrey.withValues(alpha: 0.5),
thickness: 1,
height: 20,
),
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Column(
spacing: 2,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'(${detailSurah.arti})',
style: const TextStyle(
fontSize: 16,
fontWeight: FontWeight.w500,
),
),
Text(
'${detailSurah.tempatTurun?.toUpperCase()} | ${detailSurah.jumlahAyat} Ayat',
),
],
),
],
),
],
),
),
Expanded(
child: ListView.builder(
itemCount: ayatList.length,
itemBuilder: (context, index) {
return cardAyat(ayatList[index]);
},
),
),
],
),
);
}Tahap 8: Penulisan Kode & Konfigurasi
import 'package:alquran_flutter/detail_surah_model.dart';
import 'package:alquran_flutter/remote_resource.dart';
import 'package:flutter/material.dart';
import 'package:just_audio/just_audio.dart';
class DetailSurahPage extends StatefulWidget {
final int id;
const DetailSurahPage({super.key, required this.id});
@override
State<DetailSurahPage> createState() => _DetailSurahPageState();
}
class _DetailSurahPageState extends State<DetailSurahPage> {
final remoteResource = RemoteResource();
final List<Ayat> ayatList = [];
DetailSurahModel detailSurah = DetailSurahModel();
late AudioPlayer player;
Stream<Duration> get _positionStream => player.positionStream;
Stream<Duration?> get _durationStream => player.durationStream;
@override
void dispose() {
player.dispose();
super.dispose();
}
@override
void initState() {
player = AudioPlayer();
getDetailSurah(widget.id);
super.initState();
}
void getDetailSurah(int id) async {
final result = await remoteResource.detailSurah(id);
result.fold(
(error) => {
ScaffoldMessenger.of(
context,
).showSnackBar(SnackBar(content: Text('Error: $error'))),
},
(data) {
setState(() {
detailSurah = data;
ayatList.addAll(data.ayat ?? []);
});
player.setUrl(detailSurah.audio ?? '');
},
);
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
leading: IconButton(
icon: const Icon(Icons.arrow_back_ios_new_rounded),
onPressed: () {
Navigator.pop(context);
},
),
),
body: Column(
children: [
Container(
width: double.infinity,
height: 200,
padding: const EdgeInsets.all(12),
margin: const EdgeInsets.all(16),
decoration: BoxDecoration(
color: Theme.of(context).colorScheme.secondaryContainer,
borderRadius: BorderRadius.circular(20),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Text(
detailSurah.namaLatin ?? '',
style: const TextStyle(
fontSize: 20,
fontWeight: FontWeight.bold,
),
),
Text(
detailSurah.nama ?? '',
style: const TextStyle(
fontSize: 26,
fontWeight: FontWeight.bold,
),
),
],
),
Divider(
color: Colors.blueGrey.withValues(alpha: 0.5),
thickness: 1,
height: 20,
),
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Column(
spacing: 2,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'(${detailSurah.arti})',
style: const TextStyle(
fontSize: 16,
fontWeight: FontWeight.w500,
),
),
Text(
'${detailSurah.tempatTurun?.toUpperCase()} | ${detailSurah.jumlahAyat} Ayat',
),
],
),
StreamBuilder<PlayerState>(
stream: player.playerStateStream,
builder: (context, snapshot) {
final playerState = snapshot.data;
final processingState = playerState?.processingState;
final playing = playerState?.playing ?? false;
if (processingState == ProcessingState.loading ||
processingState == ProcessingState.buffering) {
return IconButton(
icon: CircularProgressIndicator(),
onPressed: null,
);
} else if (playing) {
return AnimatedSwitcher(
duration: Duration(milliseconds: 300),
child: IconButton(
icon: Icon(
Icons.pause_circle_filled,
size: 48,
color: Theme.of(context).colorScheme.secondary,
),
onPressed: player.pause,
),
);
} else {
return AnimatedSwitcher(
duration: Duration(milliseconds: 300),
child: IconButton(
icon: Icon(
Icons.play_circle_filled,
size: 42,
color: Theme.of(context).colorScheme.secondary,
),
onPressed: player.play,
),
);
}
},
),
],
),
StreamBuilder<Duration>(
stream: _positionStream,
builder: (context, positionSnapshot) {
final position = positionSnapshot.data ?? Duration.zero;
return StreamBuilder<Duration?>(
stream: _durationStream,
builder: (context, durationSnapshot) {
final duration = durationSnapshot.data ?? Duration.zero;
return Slider(
value: position.inSeconds.toDouble(),
min: 0,
max: duration.inSeconds.toDouble(),
onChanged:
(value) =>
player.seek(Duration(seconds: value.toInt())),
activeColor: Theme.of(context).colorScheme.secondary,
// Color of the part already played
inactiveColor: Colors.grey[300],
);
},
);
},
),
],
),
),
Expanded(
child: ListView.builder(
itemCount: ayatList.length,
itemBuilder: (context, index) {
return cardAyat(ayatList[index]);
},
),
),
],
),
);
}
Widget cardAyat(Ayat ayat) {
return Card(
elevation: 0.5,
shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(20)),
margin: EdgeInsets.symmetric(vertical: 8, horizontal: 16),
child: Padding(
padding: const EdgeInsets.all(8.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
spacing: 8,
children: [
Row(
spacing: 4,
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: [
Container(
padding: EdgeInsets.all(5),
decoration: BoxDecoration(
border: Border.all(
color: Theme.of(context).colorScheme.primary,
width: 1,
),
borderRadius: BorderRadius.circular(10),
),
child: Text(
'${ayat.surah}:${ayat.nomor}',
style: TextStyle(fontSize: 11),
),
),
Expanded(
child: Directionality(
textDirection: TextDirection.rtl,
child: Text(
ayat.ar ?? '',
style: const TextStyle(fontSize: 24),
),
),
),
],
),
Text('${ayat.idn}'),
],
),
),
);
}
}Tahap 9: Penulisan Kode & Konfigurasi
import 'package:just_audio/just_audio.dart';Tahap 10: Penulisan Kode & Konfigurasi
late AudioPlayer player;
Stream<Duration> get _positionStream => player.positionStream;
Stream<Duration?> get _durationStream => player.durationStream;
@override
void dispose() {
player.dispose();
super.dispose();
}
@override
void initState() {
player = AudioPlayer();
getDetailSurah(widget.id);
super.initState();
}Tahap 11: Penulisan Kode & Konfigurasi
void getDetailSurah(int id) async {
final result = await remoteResource.detailSurah(id);
result.fold(
(error) => {
ScaffoldMessenger.of(
context,
).showSnackBar(SnackBar(content: Text('Error: $error'))),
},
(data) {
setState(() {
detailSurah = data;
ayatList.addAll(data.ayat ?? []);
});
// memasukkan url audio
player.setUrl(detailSurah.audio ?? '');
},
);
}Tahap 12: Penulisan Kode & Konfigurasi
// Play Button Audio
StreamBuilder<PlayerState>(
stream: player.playerStateStream,
builder: (context, snapshot) {
final playerState = snapshot.data;
final processingState = playerState?.processingState;
final playing = playerState?.playing ?? false;
if (processingState == ProcessingState.loading ||
processingState == ProcessingState.buffering) {
return IconButton(
icon: CircularProgressIndicator(),
onPressed: null,
);
} else if (playing) {
return AnimatedSwitcher(
duration: Duration(milliseconds: 300),
child: IconButton(
icon: Icon(Icons.pause_circle_filled,
size: 48,
color: Theme.of(context).colorScheme.secondary,
),
onPressed: player.pause,
),
);
} else {
return AnimatedSwitcher(
duration: Duration(milliseconds: 300),
child: IconButton(
icon: Icon(Icons.play_circle_filled,
size: 42,
color: Theme.of(context).colorScheme.secondary,
),
onPressed: player.play,
),
);
}
},
),Tahap 13: Penulisan Kode & Konfigurasi
final playerState = snapshot.data;
final processingState = playerState?.processingState;
final playing = playerState?.playing ?? false;Tahap 14: Penulisan Kode & Konfigurasi
if (processingState == ProcessingState.loading ||
processingState == ProcessingState.buffering) {
return IconButton(
icon: CircularProgressIndicator(),
onPressed: null,
);
}Tahap 15: Penulisan Kode & Konfigurasi
else if (playing) {
return AnimatedSwitcher(
duration: Duration(milliseconds: 300),
child: IconButton(
icon: Icon(Icons.pause_circle_filled, size: 48),
onPressed: player.pause,
),
);
}Tahap 16: Penulisan Kode & Konfigurasi
else {
return AnimatedSwitcher(
duration: Duration(milliseconds: 300),
child: IconButton(
icon: Icon(Icons.play_circle_filled, size: 42),
onPressed: player.play,
),
);
}Tahap 17: Penulisan Kode & Konfigurasi
StreamBuilder<Duration>(
stream: _positionStream,
builder: (context, positionSnapshot) {
final position = positionSnapshot.data ?? Duration.zero;
return StreamBuilder<Duration?>(
stream: _durationStream,
builder: (context, durationSnapshot) {
final duration = durationSnapshot.data ?? Duration.zero;
return Slider(
value: position.inSeconds.toDouble(),
min: 0,
max: duration.inSeconds.toDouble(),
onChanged: (value) =>
player.seek(Duration(seconds: value.toInt())),
activeColor: Theme.of(context).colorScheme.secondary,
// Color of the part already played
inactiveColor: Colors.grey[300],
);
},
);
},
),Tahap 18: Penulisan Kode & Konfigurasi
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => DetailSurahPage(id: surah.nomor ?? 0),
),
);Tahap 19: Penulisan Kode & Konfigurasi
Widget buildSurahCard(SurahModel surah) {
return Container(
padding: const EdgeInsets.symmetric(vertical: 10, horizontal: 16),
margin: const EdgeInsets.symmetric(vertical: 8, horizontal: 16),
decoration: BoxDecoration(
color: Theme.of(context).colorScheme.secondaryContainer,
boxShadow: [
BoxShadow(
color: Colors.blueGrey.withValues(alpha: 0.5),
spreadRadius: 0.5,
offset: Offset(0, 0.5), // changes position of shadow
),
],
borderRadius: BorderRadius.circular(20),
),
child: InkWell(
onTap: () {
// Move to detail page
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => DetailSurahPage(id: surah.nomor ?? 0),
),
);
},
child: Row(
spacing: 8,
mainAxisAlignment: MainAxisAlignment.spaceBetween,
crossAxisAlignment: CrossAxisAlignment.center,
children: [
Stack(
alignment: Alignment.center,
children: [
SvgPicture.asset(
'assets/icons/jewish-star.svg',
colorFilter: ColorFilter.mode(
Theme.of(context).colorScheme.secondary,
BlendMode.srcIn,
),
width: 52,
height: 52,
),
Center(
child: Text(
surah.nomor.toString(),
style: TextStyle(fontWeight: FontWeight.bold),
),
),
],
),
Expanded(
flex: 2,
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
surah.namaLatin ?? '',
style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
),
Text(surah.arti ?? ''),
],
),
),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.end,
children: [
Text(
'${surah.nama}',
style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),
),
Text('${surah.jumlahAyat} Ayat'),
],
),
),
],
),
),
);
}
💡 Tips Rekayasa Perangkat Lunak (SiHubung Engineering Best Practice)
Selalu gunakan pendekatan deklaratif, validasi input seawal mungkin di boundary layer, dan lakukan logging terstruktur untuk memudahkan observability ketika sistem dijalankan di lingkungan cloud produksi.
Kesimpulan
Dengan mengikuti langkah-langkah terstruktur di atas, implementasi modul Anda akan jauh lebih rapi, aman dari bug umum, serta siap diskalakan ke lingkungan produksi.
Nantikan artikel tutorial praktis lainnya seputar fullstack development, microservices, dan otomasi AI di Blog Engineering SiHubung. Selamat mencoba!
