ImageUpload¶
ImageUpload, görsel seçimi ve onayı sunan tek dosyalı bir alandır. File bileşeninin veri bağlamasını, dosya adı ve revizyon özniteliklerini, şablon kaynaklarını, zorunlu alan doğrulamasını ve düzenleme ayarlarını devralır. Varsayılan seçici filtresi image/*değeridir; açıkça belirtilen bir Accept seçimi daraltabilir, ancak bileşen yine de bir görsel gerektirir.
1 | |
Bağlı veri skaler dosya kimliği olarak kalır. Birden fazla dosya başvurusu için FileList kullanın.
Önizleme ve Onay¶
Yerel seçim, bırakma, yapıştırma ve kamerayla yakalama işlemleri, yüklemeden önce Görseli İncele ekranını açar. Görseli Kullan sonucu kabul eder; iptal edilirse mevcut form değeri değişmeden kalır ve yerel yükleme başlamaz. Son kullanılan dosyalar, şablonlar ve bulut sonuçları da bir onay önizlemesi gerektirir. Saklanan veya harici sonuçlar yalnızca önizlenebilir; baytları yerel kırpma düzenleyicisine alınmaz.
Yerel JPEG ve statik PNG görseller için inceleme penceresi 90 derecelik döndürme, yüzde cinsinden kırpma sınırları, sıfırlama ve piksel boyutları sunar. Kırpma sınırları döndürme işleminden sonra uygulanır. Düzenleyici, form alanını kompakt tutmak için standart tema denetimlerini bir iletişim kutusunda kullanır.
Mevcut bir form görselinin önizlemesi, dosya adı üzerinden açılır. Görsel yüklenemiyorsa bir açıklama gösterilir ve dosyayı açma bağlantısı kullanılabilir kalır.
Sıkıştırma¶
Compression isteğe bağlıdır ve varsayılan değeri Noneolarak belirlenmiştir. Önayarlar en-boy oranını korur ve görseli büyütmez.
| Önayar | Otomatik işleme |
|---|---|
None | Otomatik yeniden boyutlandırma veya yeniden sıkıştırma olmadan seçilen baytları koru. |
Document | JPEG veya statik PNG'yi uzun kenarı 2000 piksel olacak şekilde sığdır. |
Web | JPEG veya statik PNG'yi uzun kenarı 1280 piksel olacak şekilde sığdır. |
EMail | JPEG veya statik PNG'yi uzun kenarı 800 piksel olacak şekilde sığdır. |
KeepRatio | Özgün boyutları koru; yüzde 85 kaliteyle JPEG kodlamayı dene. Diğer biçimler değiştirilmeden kalır. |
JPEG işlemede yüzde 85 kodlama kalitesi kullanılır. PNG yeniden boyutlandırma, PNG biçimini ve saydamlığı korur. Otomatik işleme daha büyük bir dosya üretirse seçilen dosya korunur. Kullanıcı görseli açıkça kırptığında veya döndürdüğünde karşılaştırma düzenlenmiş dosyaya göre yapılır ve düzenleme korunur. JPEG düzenlemeleri, seçili olsa bile yeniden kodlama gerektirir. None.
GIF, WebP, SVG, animasyonlu PNG ve diğer biçimler otomatik olarak dönüştürülmez ve yerel crop/rotation denetimler sunulmaz. Başlangıç meta verileri statik olduğunu belirleyemeyen PNG dosyaları da korunur. Bu alanın dosyayı kabul etmesi için tarayıcıda önizlenebilir olması gerekir.
KeepRatio boyutları korur; 2000 piksele yeniden boyutlandırma önayarı değildir. Bu sınır gerektiğinde Document kullanın.
Doğrulama ve İzinler¶
İstemci, 50 MiB'tan (50 * 1024 * 1024 bayt) veya 40 milyon pikselden büyük görselleri ve çözemediği görselleri reddeder. Mevcut olduğunda bilinen raster başlıkları çözümleme öncesinde denetlenir; çözümlenen boyutlar da yeniden denetlenir. Boyut meta verileri mevcutsa uzak önizlemenin boyutu denetlenir. Görsel yükleme 15 saniye sonra zaman aşımına uğrar.
Bu denetimler istemci korumalarıdır; sunucu tarafı yetkilendirme veya içerik doğrulaması değildir. Yükleme uç noktasının dosya politikaları ve dosya read/write izinleri geçerliliğini korur. Şablon ve harici bağlantı seçimi, geçerli kullanıcının izinlerinin ötesinde erişim sağlamaz.