Widget Yerleştirme
Bu sayfa, Horizon board üzerinde Cartography KPI widget'larının nasıl yerleştirildiğini, taşındığını ve yeniden boyutlandırıldığını anlatır.
1. Edit Mode'a Geçin
Board canvas üst barında Edit Mode toggle'ına tıklayın. Edit mode aktifken:
- Grid çizgileri görünür hale gelir
- Mevcut widget'ların drag handle ve resize handle'ları aktifleşir
- Add Chart butonu yeni widget eklemeye izin verir
- Delete ikonları widget kartlarında görünür
2. Add Chart Diyaloğu
Üst bardaki Add Chart butonuna tıklayın. Açılan diyalog Cartography widget kütüphanesini listeler.
| Diyalog Özellikleri |
|---|
| Search — widget adına göre filtre |
| Chart Type Filter — Cartesian / Circular / Gauge / Text / DataGrid / Other |
| Tag Filter — Cartography'de atadığınız tag'ler |
| Folder Tree — Cartography klasör yolu |
| Card Preview — küçük önizleme |
İstediğiniz widget'ı tıklayıp seçin, sonra Add ile board'a ekleyin.
Hızlı Ekleme
Aynı sorguyu farklı widget tipleriyle göstermek istiyorsanız Cartography'de Duplicate ile çoğaltıp farklı bir chart tipi atayın → Cartography Çoğaltma.
3. Widget Yerleşimi
Eklenen widget board'da default konumda belirir (genelde sol üst boş alan). Sürüklemek için widget'ın üst kenarını tutun.
| Hareket | Davranış |
|---|---|
| Drag (sürükle) | Widget'ı yeni hücreye taşı; çakışma varsa snap-back |
| Resize köşe handle'ı | Widget'ı genişlet/daralt (min 7×5 hücre) |
| Delete (X) ikonu | Widget'ı board'dan kaldır (Cartography'de silinmez) |
Snap to Grid
Sürüklenen widget en yakın hücre koordinatına oturur (snap-to-grid). 180 sütunlu V1 grid'de hücre boyutu canvas genişliğine göre dinamik hesaplanır.
4. Widget Sınırları
| Sınır | Değer |
|---|---|
| Bir board'da maksimum widget | 20 |
| Minimum genişlik | 7 hücre |
| Minimum yükseklik | 5 hücre |
| Maksimum genişlik | 180 (tüm satır) |
| Çakışma davranışı | Snap-back; üst üste yerleşme yok |
Maksimum Widget Aşıldığında
20 widget'a ulaştığınızda Add Chart uyarı verir: "Maximum 20 charts per board". Yeni widget eklemek için önce mevcut bir widget'ı kaldırın.
5. Widget Etkileşimleri (Edit Mode Kapalı)
Edit mode'dan çıktığınızda widget'lar interaktif hale gelir:
| Etkileşim | Davranış |
|---|---|
| Cartesian / Circular | Tooltip, zoom, pan, trackball (Cartography ayarlarına göre) |
| Gauge | Sadece görüntü |
| Text | Sadece görüntü |
| DataGrid | Sıralama, filtreleme, satır seçimi |
| Two-Column List | Sadece görüntü |
Edit'te Görmek vs Görmemek
Edit mode aktifken widget'ların interaktif özellikleri devre dışıdır (sürükle/resize öncelikli). Widget'ı son hali ile test etmek için edit mode'dan çıkın.
6. Widget Sıralaması
Layout JSON'da widget sırası z-order belirler: listede sonra eklenen widget üstte render edilir. V1 grid çakışmaya izin vermediği için z-order pratikte nadiren önemlidir.
7. Düzenleme Sonrası Kayıt
Edit mode'dan çıktığınızda layout otomatik kaydedilir. Tarayıcıyı kapatmadan önce Done veya benzeri çıkış butonuna tıkladığınızdan emin olun.
8. Sık Karşılaşılan Hatalar
| Belirti | Olası Neden | Çözüm |
|---|---|---|
| Widget eklenmiyor | 20 limitine ulaşıldı | Mevcut widget'ı kaldırın |
| Widget veriyi yüklemiyor | Compass sorgusu hata veriyor | Compass'ta sorguyu test edin |
| Widget göstermiyor "Widget not found" | Cartography'de silinmiş | Yeni bir widget ile değiştirin |
| Drag/resize çalışmıyor | Edit mode kapalı | Edit Mode toggle'ı açın |