Discord.js V2 Components

---

Merhaba arkadaşlar,

Discord, klasik Embed sisteminin yanında artık çok daha gelişmiş bir mesaj sistemi olan Components V2'yi kullanıma sundu.

Bu sistem sayesinde mesajlar yalnızca bir Embed'den ibaret olmuyor. Yazılar, bölümler, görseller, butonlar, dosyalar ve seçim menüleri tek bir yapı içerisinde oluşturulabiliyor.

Bu konuda Components V2'nin ne olduğunu, neden kullanılması gerektiğini ve hangi bileşenleri içerdiğini anlatacağım.

---

Components V2, Discord'un yeni nesil mesaj oluşturma sistemidir.

Artık mesajlar sadece;

• Embed
  
• Action Row
  
• Button
  

üçlüsünden oluşmuyor.

Bunun yerine tek bir Container içerisine birçok farklı bileşen eklenebiliyor.

Örneğin tek mesaj içerisinde;

• Başlık
  
• Açıklama
  
• Thumbnail
  
• Resim Galerisi
  
• Dosya
  
• Ayırıcılar
  
• Link Butonları
  
• Select Menu
  

aynı anda kullanılabiliyor.

---

Components V2'nin temelini Container oluşturur.

Container'ı küçük bir web sayfası gibi düşünebilirsiniz.

Diğer tüm bileşenler bunun içerisine eklenir.

Örneğin;

Bu yapı sayesinde mesajlar çok daha düzenli görünmektedir.

---

TextDisplay

Mesaj içerisinde düz metin veya Markdown göstermek için kullanılır.

• Başlık
  
• Açıklama
  
• Liste
  
• Kod blokları
  

oluşturabilirsiniz.

---

Section

Birden fazla TextDisplay'i tek grup altında toplar.

İstenirse yanına;

• Thumbnail
  
• Button
  

eklenebilir.

---

Separator

İki içerik arasına görsel ayırıcı ekler.

Uzun mesajların okunmasını oldukça kolaylaştırır.

---

Thumbnail

Section bileşeninin yanında küçük resim göstermenizi sağlar.

Genellikle;

• Bot avatarı
  
• Sunucu ikonu
  
• Ürün resmi
  
• Profil resmi
  

için tercih edilir.

---

MediaGallery

Birden fazla görseli aynı mesaj içerisinde galeri şeklinde gösterebilir.

Özellikle;

• Skin tanıtımı
  
• Ürün listesi
  
• Galeri
  
• Ekran görüntüleri
  

için oldukça kullanışlıdır.

---

File Component

Mesaj içerisine yüklenen dosyaları doğrudan Component olarak göstermenizi sağlar.

JSON, TXT veya diğer dosyalar Components V2 içerisine eklenebilir.

---

Button

Klasik Button sistemi kullanılmaya devam etmektedir.

Desteklenen türler;

• Primary
  
• Secondary
  
• Success
  
• Danger
  
• Link
  

---

Select Menu

Dropdown menüler oluşturabilirsiniz.

Örneğin;

• Channel Select
  
• Role Select
  
• User Select
  
• Mentionable Select
  
• String Select
  

Tamamı Components V2 ile birlikte kullanılabilir.

---

• Daha modern görünüm
  
• Tek mesaj içerisinde daha fazla içerik
  
• Daha okunabilir tasarım
  
• Daha profesyonel kullanıcı deneyimi
  
• Embed sınırlarının büyük ölçüde ortadan kalkması
  
• Daha esnek mesaj düzeni
  

Özellikle panel, ticket, envanter, mağaza ve bilgi komutlarında klasik Embed kullanımına göre çok daha başarılı sonuçlar vermektedir.

---

Components V2 kullanırken mesaj gönderilirken MessageFlags.IsComponentsV2 bayrağının kullanılması gerekir.

Aksi halde Discord mesajı Components V2 olarak değerlendirilmez.

Ayrıca Container içerisine eklenen bileşenlerin sıralaması tamamen geliştirici tarafından belirlenmektedir.

Bu yüzden mesaj tasarımını planlayarak oluşturmanız tavsiye edilir.

---

Components V2'nin neredeyse tüm bileşenlerini örnekleriyle birlikte inceleyebileceğiniz açık kaynak proje:

discord.js-v2-components

Projede;

• Container
  
• TextDisplay
  
• Section
  
• Thumbnail
  
• Separator
  
• MediaGallery
  
• File Component
  
• Button
  
• Channel Select Menu
  

gibi birçok bileşenin çalışma örneği bulunmaktadır.

---