Semua hal yang berhubungan dengan pemrograman tentunya membutuhkan comments dalam sebuah kode program atau source code yang kita kerjakan. Comments tersebut tentunya sangat berguna bagi para programmer.
Comments adalah sebuah baris dari source code yang tidak dapat dieksekusi oleh compiler. jadi walaupun sebanyak apa comments yang kita buat, itu tidak akan mempengaruhi error dalam program aplikasi yang kita buat atau dikerjakan.
Pada pembahasan kali ini kita akan membahas comments pada plugin flutter yang digunakan untuk membuat aplikasi, comments ini sangat perlu digunakan dalam merancang sebuah projek baik itu berbasis web atau aplikasi agar para programer atau developer bisa lebih mengenali source code dari yang mereka buat.
Comments pada flutter yang akan di bahas kali ini yaitu ada beberapa jenis comments, yaitu sebagai berikut :
Comments dengan simbol // adalah sebuah comments yang dapat digunakan untuk memberikan tulisan comments sejumlah satu baris, perhatikan gambar berikut ini
 |
comments //
|
Pada kode program sederhana tersebut, saya menambahkan comments dengan tulisan "//program sederhana" kemudian saya compile, maka hasilnya seperti biasa saja dan tidak terjadi perubahan sama sekali. kemudian jika saya menambahkan comments lagi sepeti berikut ini
 |
| comments //judul halaman |
Disitu saya menambahkan comments untuk bagian judul halaman, maka jika di run hasilnya sama saja dan tidak terjadi perubahan ataupun error, hal itu membuktikan bahwa comments tidak dieksekusi atau di compile sekaligus pada source code, sehingga kita juga bisa menghapus comments yang ada pada program sederhana flutter di atas, jika kita hapus seperti berikut ini
 |
| mengapus comments lainnya |
Maka comments pada kode program tersebut akan terhapus dan source code akan terlihat lebih rapi seperti berikut ini
 |
| Setelah menghapus comments lainnya |
Comments berikut ini adalah comments yang digunakan untuk memberikan tulisan comments lebih dari satu baris, biasanya comments ini digunakan untuk mendeskripsikan aplikasi atau halaman aplikasi yang dikerjakan. Contoh penggunaan comments tersebut yaitu sebagai berikut :
 |
| penggunaan comments : /* */ |
Penggunaan comments tersebut cukup jelas untuk menambahkan tulisan comments dengan lebih dari satu baris dengan simbol pembukanya yaitu /* dan simbol penutup comments tersebut yaitu */.
docs comments adalah comments yang dapat digunakan untuk perpindahan halaman dari beberapa source code jika dalam satu folder project terdapat file program flutter lebih dari satu. sebagai contoh, disini saya akan memecahkan program ini menjadi dua bagian dengan masing-masing nama yaitu main.dart & home.dart. Untuk class dengan nama "MyHomePage" dan "_MyHomePageState" akan dipindahkan ke file home.dart, Jadi kita harus memindahkan source code dari kedua class terlebih dahulu dengan cara nemenekan shortcut ctrl+x
 |
| cut MyHomePage & MyHomePage |
Setelah itu pindahkan ke file home,dart
 |
| home.dart |
Akan tetapi file home.dart masih terlihat error, karena kita belum mengimport package:flutter/material.dart, sehingga yang harus dilakukan yaitu mengimport package tersebur terlebih dahulu seperti berikut ini
 |
| import package:flutter/material.dart |
Sehingga error yang ada pada file home.dart teratasi, akan tetapi jika kita masuk ke file main.dart, akan ada error dari source code tersebut, khususnya dari error MyHomePage seperti berikut ini
 |
| error MyHomePage |
Error tersebut terjadi karena kita belum menghubungkan file main.dart kita dengan file home.dart, sehingga kita harus mengimport file home,dart ke dalam main.dart, sehingga error akan teratasi
 |
| import home.dart |
Selanjutnya, untuk penggunaan docs comments, format penulisannya yaitu
"/// comments [class tujuan]
 |
| format penulisan docs comments |
Jika kita sorot pointer ke class tujuan sambil menagan tombol ctrl, maka pointer terlihat seperti berikut ini, yang artinya kita bisa mengkliknya.
 |
| hover |
Jika kita klik, maka akan langsung beralih ke tampilan file home.dart
 |
| home.dart |
Comments berikut ini hampir sama seperti comments sebelumnya yaitu comments /* */ yang digunakan untuk menulis comments lebih dari satu baris, hal yang membedakannya yaitu, jika kita menggunakan comments /** **/ maka comments tersebut adalah penggunaan dari docs comments yang digunakan untuk berpindah halaman dengan jumlah lebih dari satu. untuk penggunaannya yaitu sebagai berikut
 |
| docs comments /** **/ |
Baik, mungkin itu dulu pembahasan mengenai comments pada flutter, semoga bermanfaat bagi pembaca sekaligus yang ingin melakukan praktikum dari materi ini. Sekian dan terima kasih.
Tidak ada komentar:
Posting Komentar