İçeriğe geç
Muhammet Şafak
en
Arayüz 2 dk okuma

Vue ile bileşen tabanlı arayüz mimarisine geçiş

Sayfa odaklı düşünmekten bileşen (component) odaklı düşünmeye geçişi ve Vue.js'in bunu pratikte nasıl sağladığını anlatıyorum.

Maket tahtasında profil, navigasyon, akış ve ayarlar çerçeveleri; mor kalem profil panelini söküyor

Bu yazı 8 yıl önce yazıldı — o günün koşullarını yansıtır.


Uzun süre arayüz geliştirirken kafamda “sayfa” kavramı vardı. Bir sayfa var, içinde bir form var, form gönderilince bir şey oluyor. jQuery ile event listener’lar yazıyordum, DOM’u elle güncelliyordum, her şey bir aradaydı. Küçük projelerde bu yeterdi. Ama sayfa büyüdükçe, farklı yerlerde aynı UI parçası tekrarlandıkça, “bu kodu nereye koyacağım” sorusu cevapsız kalmaya başladı.

Vue.js ile çalışmaya başladıktan sonra o soruyu sormayı bıraktım. Çünkü artık “sayfayı” değil, “bileşeni (component)” birim olarak düşünüyorum.

Bileşen nedir?

Bileşen, kendi şablonunu, mantığını ve stilini bir arada barındıran, yeniden kullanılabilir bir arayüz birimidir. Bir düğme, bir form alanı, bir kart, bir açılır menü — bunların her biri ayrı bir bileşen olabilir.

Vue’da tek dosyalı bileşen (Single File Component — SFC) formatı bu ayrımı çok somutlaştırıyor. .vue uzantılı bir dosya açtığınızda şablonu, JavaScript mantığını ve CSS’i aynı yerde görüyorsunuz:

<template>
  <div class="user-card">
    <h3>{{ user.name }}</h3>
    <p>{{ user.email }}</p>
  </div>
</template>

<script>
export default {
  props: {
    user: {
      type: Object,
      required: true
    }
  }
}
</script>

<style scoped>
.user-card {
  padding: 1rem;
  border: 1px solid #ddd;
}
</style>

Bu bileşeni istediğim her yerde şöyle kullanabiliyorum:

<UserCard :user="currentUser" />

Sayfa değil, bileşen hiyerarşisi

Bileşen odaklı düşünmenin en büyük değişikliği şu oldu: artık bir sayfayı tasarlamak yerine o sayfayı oluşturacak bileşenlerin hiyerarşisini tasarlıyorum.

Örneğin bir kullanıcı listesi sayfası düşünelim. Eskiden tek bir HTML dosyasında her şeyi yazardım. Şimdi:

  • UserListPage — sayfa bileşeni, veriyi çeker
  • UserList — listeyi render eden bileşen
  • UserCard — tek bir kullanıcıyı gösteren kart

Bu üçü ayrı ayrı dosyalar. UserCard’ı başka bir sayfada da kullanabiliyorum; değiştirmem gerektiğinde tek bir yerde değiştiriyorum.

Veri akışı: props ve event

Bileşenler arası iletişim başlangıçta kafamı karıştırdı. Vue’nun yaklaşımı şu: veri yukarıdan aşağıya akar (props aracılığıyla), olaylar aşağıdan yukarıya çıkar (emit aracılığıyla).

Üst bileşen, alt bileşene props ile veri geçirir. Alt bileşen bir şey değiştirmek istediğinde, bunu doğrudan değiştirmez; bir event yayar.

<!-- Alt bileşen: DeleteButton.vue -->
<template>
  <button @click="handleClick">Sil</button>
</template>

<script>
export default {
  methods: {
    handleClick() {
      this.$emit('delete')
    }
  }
}
</script>
<!-- Üst bileşen -->
<DeleteButton @delete="removeUser(user.id)" />

Bu kural ilk başta fazla resmi görünüyor. Ama birkaç iç içe bileşenle çalıştığınızda, verinin nerede değiştiğini net olarak görebilmek gerçekten büyük bir rahatlık.

Yeniden kullanılabilirlik pratikte ne kazandırıyor?

Geçen ay üzerinde çalıştığım projede aynı kart tasarımını dört farklı sayfada kullandım. Renk temasını değiştirmem gerektiğinde tek dosyayı güncelledi, dört sayfa anında değişti. Eskiden bu değişikliği dört ayrı dosyada, büyük ihtimalle birinde unutarak yapardım.

Yeniden kullanılabilirlik soyut bir kavram gibi durur; ama pratikte “dört yerde değil bir yerde değiştir” anlamına geliyor. Bu küçük fark, proje büyüdükçe çok daha önemli hâle geliyor.

Ne zaman bileşene bölmeli?

Her şeyi bileşene bölmek de doğru değil. Çok küçük ya da çok özel bir şeyi bileşene ayırmak gereksiz karmaşıklık yaratıyor. Benim şu an uyguladığım kural basit: bir arayüz parçası birden fazla yerde kullanılacaksa, ya da kendi içinde anlamlı bir mantığı varsa, bileşen olsun.

Tek seferlik ve sayfa özelinde bir şeyse, sayfa bileşeninin şablonu içinde kalmaya devam edebilir. Refactor etmek her zaman mümkün; erken soyutlamak yerine ihtiyaç ortaya çıkınca ayırmayı tercih ediyorum.

Geçiş süreci

Tamamen yeni bir proje başlatmak farklı; ama mevcut bir projeye Vue eklemek de kademeli yapılabiliyor. Vue’yu tüm sayfaya değil, yalnızca dinamik olmasını istediğiniz bir DOM düğümüne mount edebiliyorsunuz. Bu sayede mevcut Blade şablonlarını korurken yalnızca ihtiyaç duyduğunuz yerleri bileşenlere dönüştürebiliyorum.

Bileşen odaklı düşünmek bir süre alıyor. Ama bir kez içselleştirdiğinizde, sayfayı monolitik bir blok olarak değil, birleştirilebilir parçaların toplamı olarak görmek çok daha doğal hissettiriyor.

Sık sorulanlar

5 soru

  • Bileşen (component) nedir?

    Bileşen, kendi şablonunu, mantığını ve stillerini kapsülleyen yeniden kullanılabilir bir arayüz birimidir. Bir buton, form alanı, kart ya da dropdown, her biri ayrı bir bileşen olabilir. Vue'nun Single File Component biçiminde bir .vue dosyası şablonu, JavaScript mantığını ve CSS'i tek yerde tutar.

  • Vue'da bileşenler birbiriyle nasıl haberleşir?

    Veri aşağı doğru props ile, olaylar yukarı doğru emit ile akar. Üst bileşen alt bileşene veriyi props ile iletir; alt bileşen bir şeyi değiştirmek istediğinde veriyi doğrudan değiştirmez, bir event emit eder. İç içe birkaç bileşenle çalışmaya başlayınca verinin nerede değiştiğini net görebilmek gerçek bir rahatlama olur.

  • Ne zaman bileşene bölmeli?

    Bir arayüz parçası birden fazla yerde kullanılacaksa ya da kendine ait anlamlı bir mantığı varsa. Tek seferlik ve sayfaya özgü bir şey sayfa bileşeninin şablonunda kalabilir. Çok küçük ya da çok özel bir şeyi ayırmak gereksiz karmaşıklık yaratır; bu yüzden erken soyutlamak yerine ihtiyacın ortaya çıkmasını beklemeyi tercih ediyorum.

  • Yeniden kullanılabilirlik pratikte ne kazandırıyor?

    Bir şeyi dört yerde değil tek yerde değiştirmeyi. Aynı kart tasarımını dört farklı sayfada kullandım; renk temasını değiştirmem gerektiğinde tek bir dosyayı güncelledim ve dört sayfa birden değişti. Eski yöntemle dört dosyayı ayrı ayrı düzenleyecektim ve neredeyse kesin biri gözden kaçacaktı.

  • Mevcut bir projeye Vue eklenebilir mi?

    Evet, kademeli olarak. Dinamik davranışa ihtiyaç duyduğunuz tek bir DOM düğümüne Vue bağlayabilirsiniz; tüm sayfayı ele geçirmeniz gerekmez. Böylece mevcut Blade şablonları olduğu gibi kalır ve yalnızca gerçekten ihtiyacı olan parçaları bileşene çevirirsiniz.

Yorumlar

Yorum yapmak için GitHub hesabınızla giriş yapmanız yeterli. Yorumlar GitHub Discussions üzerinde saklanır.

İlgili Yazılar

Sitede Ara

Yazı, proje ve sayfalarda arama yapmak için yazmaya başlayın.

Esc ile kapat Pagefind ile güçlendirildi