Penjajaran vertikal: ya atau tidak? [Tutup]

Misalnya, non-vertikal sejajar:

Name:   Hamt
Version:  0.1.0
Cabal-Version:  >= 1.2
License:  BSD3
Author:  Jason Baker

Atau selaras secara vertikal:

Name:           Hamt
Version:        0.1.0
Cabal-Version:  >= 1.2
License:        BSD3
Author:         Jason Baker

Yang mana yang Anda sukai dan mengapa?

Secara pribadi, saya berpendapat bahwa versi kedua dari kode ini sedikit lebih mudah dibaca, tetapi saya tidak berpikir bahwa mempertahankannya membuat keterbacaan itu. Oleh karena itu, saya hanya akan menggunakan versi kedua dari contoh ini jika saya cukup yakin bahwa kode tidak akan berubah.

Menghemat waktu ketika Anda melakukannya seperti ini:

Name: Hamt
Version: 0.1.0
Cabal-Version: >= 1.2
License: BSD3
Author: Jason Baker

Tidak terlalu sulit untuk dibaca.

Saya lebih suka hybrid:

Name    : Hamt
Version : 0.1.0
Cabal-Version :  >= 1.2
License : BSD3
Author  : Jason Baker

Yang pada dasarnya adalah nomor 2 dengan pengecualian untuk garis sesekali yang lebih panjang dari garis di sekitarnya - untuk mencegah sebagian besar garis berjarak terlalu jauh.

Berikut adalah variasi lain untuk tata letak daftar berdasarkan pengalaman dan pendidikan dari program studi di Universitas yang saya ikuti tentang interaksi manusia-komputer dan beberapa buku yang pernah saya baca tentang (G) desain UI dan desain grafis. Saya menggunakannya untuk dialog, dan ketika saya memiliki energi / waktu, untuk CSS (biasanya tidak untuk kode).

          Name : Hamt
       Version : 0.1.0
 Cabal-Version : >= 1.2
       License : BSD3
        Author : Jason Baker

Seperti semua yang lain, ia memiliki pro dan kontra.

Pro:

• Istirahat visual yang kuat memisahkan data dari label
• Tampilan desain grafis profesional yang menyenangkan secara estetika (terutama untuk file yang diselesaikan dan diterbitkan)
• Data lebih dekat dengan label, membuatnya lebih mudah untuk diasosiasikan (mengurangi kemungkinan membaca melintasi baris ke data yang salah)
• Ideal untuk tata letak kotak dialog

Cons:

• Membutuhkan lebih banyak waktu untuk memformat dengan benar
• Membutuhkan penataan kembali saat item terpanjang baru ditambahkan
• Tidak berguna untuk kode

HTH

Saya lebih suka yang pertama, tetapi tanpa tab (yang saya kira kosong); hanya satu ruang kosong saja. Bagi saya itu lebih mudah dibaca ketika data tidak "mirip", seperti dalam kasus yang diberikan. Ini juga membuatnya lebih sulit (saat mengedit data tersebut) untuk "salah membaca baris", yaitu ketika Anda memiliki tiga baris dengan katakanlah, nomor versi. Dan kemudian saat mengedit satu, Anda secara tidak sengaja mengedit yang lain di tempatnya.

Namun, ketika datanya serupa, masuk akal untuk meletakkannya di kolom seperti pada contoh kedua Anda (hanya saja tidak ada yang serupa, tetapi Anda mendapatkan intinya).

Sayangnya menjadi pertanyaan gaya, ini sangat subjektif dan Anda mungkin akan memiliki banyak hasil yang bertentangan. Selain itu, gaya yang digunakan sangat bergantung pada penggunaan TAB atau spasi Anda.


Sedangkan untuk dua sen saya, saya lebih suka variasi dari versi kedua. Saya suka yang terbaik ini:

Name            : Hamt
Version         : 0.1.0
Cabal-Version   : >= 1.2
License         : BSD3
Author          : Jason Baker

Ini adalah versi yang paling mudah dibaca dan mudah digunakan yang telah saya coba. Satu-satunya downside nyata adalah bahwa saya harus mencari tahu apa bidang terluas, dan kadang-kadang akhirnya harus memperluas semuanya ketika satu terlalu lebar (ini biasanya hanya terjadi dengan CSS). Namun ada beberapa poin yang perlu diperhatikan.

Pertama, saya biasanya lebih suka TAB dibandingkan dengan spasi, namun pengaturan TAB yang sebenarnya bervariasi; misalnya, saya terbiasa dengan TAB 4-ruang untuk kode C (++) atau HTML dan TAB 2-ruang untuk kode Pascal atau Assembler, sedangkan untuk beberapa hal seperti CSS, saya tidak memiliki preferensi untuk lebar TAB. Variasi ini cukup rumit, tetapi kemudian editor yang saya gunakan melempar komplikasinya sendiri. Beberapa editor memungkinkan Anda mengatur pengaturan TAB per bahasa, tetapi beberapa tidak (bahkan beberapa yang memiliki profil berbeda).

Anda dapat menghindari komplikasi ini dengan melepaskan TAB yang mendukung ruang. Karena kode biasanya dalam font dengan lebar tetap, menggunakan spasi berfungsi dengan baik, sedangkan jika Anda memformat bidang dalam formulir, resume, atau teks non-kode lainnya dan menggunakan font proporsional, Anda perlu TAB untuk menjaga hal-hal tetap selaras. .

Saya lebih suka TAB secara umum karena walaupun dengan kode lebar tetap, saya merasa frustasi karena harus kursor melalui beberapa ruang untuk setiap TAB. Saya ingat bahwa IDE Borland lama memiliki opsi untuk mengarahkan kursor melalui TAB (khususnya seluruh panjang spasi putih) sebagai entitas tunggal alih-alih sebagai dua, empat, dll ruang. Itu membuatnya praktis untuk memasukkan TAB sebagai spasi sambil membuat navigasi kursor menjadi mudah dan cepat. Sayangnya saya belum melihat editor Windows modern yang dapat melakukan itu.

Akhirnya, apakah orang lain akan menggunakan kode Anda atau tidak, memainkan faktor besar dalam pemilihan gaya. Saya biasanya satu-satunya yang menggunakan kode saya, jadi saya bisa memformat semuanya sesuai dengan selera saya tanpa memperhatikan editor atau pengaturan orang lain. Jika Anda bekerja dengan orang lain, Anda harus mempertimbangkannya karena mereka perlu mempertimbangkan Anda.


Singkatnya, keterbacaan baik dan sangat diinginkan, namun pengaturan dan editor Anda dan orang lain yang perlu menggunakan kode akan menjadi penting ketika membuat keputusan. Jika Anda sendirian, Anda bisa menggunakan format yang paling mudah dibaca. Anda mungkin perlu membiasakan diri menggunakannya, tetapi kemungkinan besar akan terbayar dalam jangka panjang, terutama ketika Anda perlu kembali ke kode yang Anda tulis beberapa waktu lalu: keterbacaan sama pentingnya dengan komentar dalam memahami apa yang dilakukan kode. Jika Anda bekerja dengan orang lain, maka Anda akan ingin bekerja sama untuk menyusun semacam panduan desain untuk digunakan oleh tim.