Nasıl Kullanılır trker-icon
Profesyonel ikonları iş akışınıza dahil edin. Projenize uyan yöntemi seçin — hepsini kullanmak zorunda değilsiniz.
Çıktı Formatları
Projenize uygun dağıtım formatını seçin. Her birinin farklı avantajları var — ihtiyaçlarınıza göre tercih edebilirsiniz.
Hangi formatı kullanmalıyım?
🗂️ SVG Sprite — Çoğu web uygulaması için ideal. Tek dosya, tarayıcı cache'ler, tam CSS kontrolü.
📄 Inline SVG — Az sayıda ikon veya path bazlı CSS kontrolü gerektiğinde.
🔤 Icon Font — Zaten icon font kullanıyorsan veya sıfır kurulumla CDN istiyorsan.
🖼️ PNG — Yalnızca SVG desteklenmeyen ortamlar için (email, native app).
| Özellik | 🗂️ SVG Sprite | 📄 Inline SVG | 🔤 Icon Font | 🖼️ PNG |
|---|---|---|---|---|
| Kurulum | ||||
| Entegrasyon | sprite.svg'yi indir + <use href> ile referans ver | SVG markup'ı direkt HTML'e yapıştır | CSS'i dahil et (CDN veya kendi sunucun) | <img> tag'i ekle, CSS gerekmez |
| Zorluk | ●●● Kolay | ●●● Kolay | ●●● Kolay | ●●● Kolay |
| CDN desteği | gerekmiyor | gerekmiyor | ✓ | gerekmiyor |
| Performans | ||||
| Tek HTTP isteği | ✓ | ~ asset isteği yok | ✓ | ✗ |
| Tarayıcı cache'leyebilir | ✓ | ✗ | ✓ | ~ dosya başına — her ikon ayrı cache'lenir |
| Dosya boyutu | ✓ pack ile küçük tutulabilir | ~ ikon sayısıyla büyür | ✓ pack ile küçük tutulabilir | ~ ikon sayısı × boyut |
| Gzip / Brotli | ✓ gzip ~70% | ✓ sadece sayfa bazlı | ✓ gzip ~70% | ~ zaten binary sıkıştırılmış |
| Görsel | ||||
| Keskin render (her boyut) | ✓ | ✓ | ~ küçük boyutlarda hafif bulanık | ✗ büyütülünce pikselleşir |
| CSS ile renk | ✓ | ✓ path bazlı renk kontrolü | ✓ | ✗ |
| CSS animasyon / hover | ✓ | ✓ | ~ sadece element bazlı | ✗ |
| Çok renkli ikon desteği | ✓ renkler SVG'ye hardcode edilir | ✓ path bazlı, tam kontrol | ✗ tek renk, font desteklemez | ✓ export sırasında sabit |
| Kısıtlamalar | ||||
| Tüm ikonlar mevcut | ✓ | ✓ | ~ fill-based only | ✓ |
| Temiz HTML markup | ✓ | ✗ | ✓ | ✓ |
Format seçin
SVG Sprite
Önerilen Kurulum yokSadece ihtiyacın olan ikonlarla özel bir sprite oluştur — sayfa bazlı bile olabilir. Dosyayı projeye ekle, <use href> ile referans ver. Tek HTTP isteği, tarayıcı cache'ler, tam CSS renk kontrolü.
Artılar
Eksiler
<!-- sprite.svg dosyasını sayfanın başına göm -->
<svg xmlns="http://www.w3.org/2000/svg" style="display:none">
<symbol id="trker-home" viewBox="0 0 640 640">
<path fill="currentColor" d="M..."/>
</symbol>
</svg>
<!-- Kullan -->
<svg class="w-6 h-6 text-blue-500">
<use href="#trker-home"/>
</svg>
<!-- Veya external dosya -->
<svg class="w-6 h-6">
<use href="/icons/sprite.svg#trker-home"/>
</svg>
Kurulum
Her yöntem bağımsız bir seçenektir. Projenize uygun olanı seçin.
Build adımı yok. HTML'inize tek satır ekleyin, hazırsınız.
<head> etiketine ekleyin
Mevcut sağlayıcılar:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/trker-icon@latest/dist/trker-icon.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/trker-icon/latest/trker-icon.css">
<link rel="stylesheet" href="https://unpkg.com/trker-icon@latest/dist/trker-icon.css">
Premium CDN mevcut
Premium ikon setine CDN üzerinden erişmek için yükseltin.
Temel Kullanım
Vanilla HTML
Laravel Blade Bileşenleri
Blade şablonlarınızda ikonları dinamik olarak kullanmak:
<i class="trker trker-{{ $pageIcon }}"></i>
// Component based
<x-trker-icon name="settings" class="text-primary" />
Stil ve Yardımcı Sınıflar
Boyutlandırma
Basit sınıf ekleriyle ikonları ölçeklendirin. Tüm boyutlar mevcut font-size'a göredir.
.trker-xs
.trker-sm
.trker-lg
.trker-2x
.trker-3x
.trker-4x
.trker-5x
Sabit Genişlik
Tüm ikonları aynı genişliğe zorlar — hizalı listeler ve navigasyon menüleri için idealdir.
<i class="trker trker-star trker-fw"></i>
Döndür & Çevir
İkonları 90° adımlarla döndürün veya yatay/dikey olarak aynalayın.
.trker-rotate-90
.trker-rotate-180
.trker-rotate-270
.trker-flip-h
.trker-flip-v
<i class="trker trker-arrow-right trker-flip-h"></i>
Kenarlık
İkonun etrafına çerçeve ekleyin. Yuvarlak, dairesel veya kare seçin.
.trker-border
.trker-border-circle
.trker-border-square
Pull (Float)
Bir ikonu sola veya sağa kaydırın, metin etrafında sarsın.
Your text wraps around the icon...
Yığın
Bileşik ikonlar oluşturmak için iki ikonu üst üste katmanlayın.
<i class="trker trker-circle trker-stack-2x"></i>
<i class="trker trker-star trker-stack-1x"></i>
</span>
Animasyonlar
Altı yerleşik animasyon sınıfı — ekstra CSS gerekmez.
.trker-spin
.trker-pulse
.trker-beat
.trker-bounce
.trker-shake
.trker-fade
<i class="trker trker-heart trker-beat"></i>
<i class="trker trker-bell trker-shake"></i>
Renkler & Framework'ler
İkonlar mevcut yazı rengini miras alır — herhangi bir CSS framework'ü veya saf CSS ile stillendirebilirsiniz.
#ef4444
#f97316
#fbbf24
#10b981
#3b82f6
#8b5cf6
#ec4899
#64748b
Use Tailwind's text-* utilities directly on the icon element.
text-red-500
text-blue-500
text-emerald-500
text-primary shadow-neon
<i class="trker trker-star text-red-500"></i>
<i class="trker trker-star text-blue-500"></i>
<i class="trker trker-star text-emerald-500"></i>
<!-- Hover state -->
<i class="trker trker-heart text-slate-400 hover:text-pink-500"></i>
<!-- Arbitrary value -->
<i class="trker trker-star text-[#ff6b6b]"></i>
Erişilebilirlik
İkonlar görsel öğelerdir — anlam taşımadıkça ekran okuyucuların bunları duyurmasına gerek yoktur. Arayüzünüzü erişilebilir tutmak için bu kalıpları uygulayın.
İkon yalnızca görseldir. Yardımcı teknolojilerden gizleyin.
<i class="trker trker-save"
aria-hidden="true"></i>
Save
</button>
İkon tek başına bilgi taşıyor. Metin alternatifi sağlayın.
role="img"
aria-label="Warning"></i>
Butonda görünür metin yok. Ekran okuyucuların eylemi duyurabilmesi için aria-label kullanın.
<i class="trker trker-x"
aria-hidden="true"></i>
</button>
Metin zaten eylemi açıklıyor. Tekrarı önlemek için ikonu gizleyin.
<i class="trker trker-download"
aria-hidden="true"></i>
Download
</a>
Kısa kural: ikonu kaldırmak anlamı değiştiriyorsa metin alternatifi ekleyin. Değiştirmiyorsa aria-hidden="true" kullanın.
CSS'inizi sade tutun
Yalnızca gerçekten kullandığınız ikonları dahil edin. İkon tarayıcısından özel bir paket oluşturun — hangi ikonların ve hangi CSS modüllerinin dahil olacağını siz seçin. Daha küçük dosya, daha hızlı yükleme.
Başlamaya hazırsınız!
Kapsamlı kütüphanemizi keşfedin ve sonraki projeniz için mükemmel ikonları bulun.