Sürükleyici tam ekran web siteleri ve uygulamaları kolayca oluşturabiliyoruz ancak web'deki her şeyde olduğu gibi bunu yapmanın birkaç yolu var. Bu durum, özellikle daha fazla tarayıcının tam ekran olarak başlatılan "yüklü web uygulaması" deneyimini desteklediği günümüzde daha da önemlidir.
Uygulamanızı veya sitenizi tam ekran yapma
Kullanıcılar veya geliştiriciler, web uygulamalarını tam ekran yapmanın birkaç yolu vardır.
- Kullanıcı hareketine yanıt olarak tarayıcının tam ekrana geçmesini isteyin.
- Uygulamayı ana ekrana yükleyin.
- Adres çubuğunu otomatik olarak gizleyerek tam ekran görünümü taklit edin.
Kullanıcı hareketine yanıt olarak tarayıcının tam ekrana geçmesini isteme
Tüm platformlar eşit değildir. iOS Safari'de tam ekran API'si yoktur ancak Android'de Chrome, Firefox ve IE 11+ sürümlerinde vardır. Oluşturduğunuz çoğu uygulama, JS API'si ile tam ekran spesifikasyonu tarafından sağlanan CSS seçicilerinin bir kombinasyonunu kullanır. Tam ekran deneyimi oluştururken dikkat etmeniz gereken ana JS API'leri şunlardır:
element.requestFullscreen()(şu anda Chrome, Firefox ve IE'de ön ekli) öğeyi tam ekran modunda görüntüler.document.exitFullscreen()(şu anda Chrome, Firefox ve IE'de ön ekli. Firefox,cancelFullScreen()kullanır) tam ekran modunu iptal eder.document.fullscreenElement(şu anda Chrome, Firefox ve IE'de ön ekli) Öğelerden herhangi biri tam ekran modundaysa doğru değerini döndürür.
Uygulamanız tam ekran olduğunda tarayıcının kullanıcı arayüzü kontrollerini kullanamazsınız. Bu, kullanıcıların deneyiminizle etkileşim kurma şeklini değiştirir. İleri ve geri gibi standart gezinme kontrolleri yoktur. Yenile düğmesi gibi bir çıkış kapıları yoktur. Bu senaryoya hazırlıklı olmak önemlidir. Tarayıcı tam ekran moduna girdiğinde sitenizin stilini ve sunumunu değiştirmenize yardımcı olması için bazı CSS seçicileri kullanabilirsiniz.
<button id="goFS">Go fullscreen</button>
<script>
var goFS = document.getElementById('goFS');
goFS.addEventListener(
'click',
function () {
document.body.requestFullscreen();
},
false,
);
</script>
Yukarıdaki örnek biraz yapaydır. Tedarikçi firma ön eklerinin kullanımıyla ilgili tüm karmaşıklığı gizledim.
Gerçek kod çok daha karmaşıktır. Mozilla, tam ekranı açıp kapatmak için kullanabileceğiniz çok kullanışlı bir komut dosyası oluşturdu. Gördüğünüz gibi, tedarikçi ön eki durumu, belirtilen API'ye kıyasla karmaşık ve zahmetlidir. Aşağıdaki biraz basitleştirilmiş kodda bile karmaşıklık devam ediyor.
function toggleFullScreen() {
var doc = window.document;
var docEl = doc.documentElement;
var requestFullScreen =
docEl.requestFullscreen ||
docEl.mozRequestFullScreen ||
docEl.webkitRequestFullScreen ||
docEl.msRequestFullscreen;
var cancelFullScreen =
doc.exitFullscreen ||
doc.mozCancelFullScreen ||
doc.webkitExitFullscreen ||
doc.msExitFullscreen;
if (
!doc.fullscreenElement &&
!doc.mozFullScreenElement &&
!doc.webkitFullscreenElement &&
!doc.msFullscreenElement
) {
requestFullScreen.call(docEl);
} else {
cancelFullScreen.call(doc);
}
}
Web geliştiricileri olarak karmaşıklıktan nefret ederiz. Kullanabileceğiniz güzel ve üst düzey soyut bir API, Sindre Sorhus'un Screenfull.js modülüdür. Bu modül, biraz farklı iki JS API'sini ve tedarikçi firma öneklerini tek bir tutarlı API'de birleştirir.
Fullscreen API ile ilgili ipuçları
Doküman tam ekran yapılıyor
Gövde öğesini tam ekran yaptığınızı düşünmek doğaldır ancak WebKit veya Blink tabanlı bir oluşturma motoru kullanıyorsanız gövde genişliğini tüm içeriği içerecek mümkün olan en küçük boyuta küçültmenin tuhaf bir etkisi olduğunu görürsünüz. (Mozilla Gecko kullanılabilir.)
Bu sorunu düzeltmek için body öğesi yerine document öğesini kullanın:
document.documentElement.requestFullscreen();
Video öğesini tam ekran yapma
Bir video öğesini tam ekran yapmak, diğer öğeleri tam ekran yapmakla tamamen aynıdır. Video öğesinde requestFullscreen yöntemini çağırırsınız.
<video id="videoElement"></video>
<button id="goFS">Go Fullscreen</button>
<script>
var goFS = document.getElementById('goFS');
goFS.addEventListener(
'click',
function () {
var videoElement = document.getElementById('videoElement');
videoElement.requestFullscreen();
},
false,
);
</script>
<video> öğenizde controls özelliği tanımlanmamışsa kullanıcı tam ekrana geçtikten sonra videoyu kontrol edemez. Bunu yapmanın önerilen yolu, videoyu ve kullanıcının görmesini istediğiniz kontrolleri sarmalayan temel bir kapsayıcı kullanmaktır.
<div id="container">
<video></video>
<div>
<button>Play</button>
<button>Stop</button>
<button id="goFS">Go fullscreen</button>
</div>
</div>
<script>
var goFS = document.getElementById('goFS');
goFS.addEventListener(
'click',
function () {
var container = document.getElementById('container');
container.requestFullscreen();
},
false,
);
</script>
Bu, kapsayıcı nesnesini CSS sözde seçiciyle birleştirebileceğiniz için size çok daha fazla esneklik sağlar (örneğin, "goFS" düğmesini gizlemek için).
<style>
#goFS:-webkit-full-screen #goFS {
display: none;
}
#goFS:-moz-full-screen #goFS {
display: none;
}
#goFS:-ms-fullscreen #goFS {
display: none;
}
#goFS:fullscreen #goFS {
display: none;
}
</style>
Bu kalıpları kullanarak tam ekranın ne zaman çalıştığını algılayabilir ve kullanıcı arayüzünüzü buna göre uyarlayabilirsiniz. Örneğin:
- Başlangıç sayfasına geri dönen bir bağlantı sağlayarak
- İletişim kutularını kapatma veya geri gitme mekanizması sağlayarak
Ana ekrandan tam ekran sayfa başlatma
Kullanıcı bir web sayfasına gittiğinde tam ekran web sayfası başlatmak mümkün değildir. Tarayıcı tedarikçileri, her sayfa yüklemesinde tam ekran deneyiminin çok can sıkıcı olduğunun farkındadır. Bu nedenle, tam ekrana girmek için bir kullanıcı hareketi gerekir. Ancak tedarikçiler, kullanıcıların uygulamaları "yüklemesine" izin verir. Yükleme işlemi, işletim sistemine kullanıcının platformda uygulama olarak başlatmak istediğini belirten bir sinyaldir.
Büyük mobil platformlarda meta etiketleri veya manifesto dosyalarını kullanarak bunu uygulamak oldukça kolaydır.
iOS
iPhone'un kullanıma sunulmasından bu yana kullanıcılar, ana ekrana web uygulamaları yükleyip bunları tam ekran web uygulamaları olarak başlatabiliyor.
<meta name="apple-mobile-web-app-capable" content="yes" />
İçerik "yes" olarak ayarlanırsa web uygulaması tam ekran modunda çalışır, aksi takdirde çalışmaz. Varsayılan davranış, web içeriğini görüntülemek için Safari'yi kullanmaktır. window.navigator.standalone salt okunur Boole JavaScript özelliğini kullanarak bir web sayfasının tam ekran modunda gösterilip gösterilmeyeceğini belirleyebilirsiniz.
Apple
Android için Chrome
Chrome ekibi, kullanıcı ana ekrana eklediğinde tarayıcıya sayfayı tam ekran başlatmasını söyleyen bir özellik uyguladı. iOS Safari modeline benzer.
<meta name="mobile-web-app-capable" content="yes" />
Web uygulamanızı, cihazın ana ekranına bir uygulama kısayolu simgesi eklenecek ve uygulama, Android için Chrome'un "Ana ekrana ekle" menü öğesi kullanılarak tam ekran "uygulama modunda" başlatılacak şekilde ayarlayabilirsiniz.
Google Chrome
Web uygulaması manifestini kullanmak daha iyi bir seçenektir.
Web Uygulaması Manifesti (Chrome, Opera, Firefox, Samsung)
Web uygulamaları için manifest, geliştirici olarak size, uygulamanızın kullanıcıya uygulamaları görmeyi beklediği alanlarda (ör. mobil ana ekran) nasıl görüneceğini kontrol etme, kullanıcının neleri başlatabileceğini ve daha da önemlisi bunları nasıl başlatabileceğini yönlendirme olanağı veren basit bir JSON dosyasıdır. Gelecekte manifest, uygulamanız üzerinde daha fazla kontrol sahibi olmanızı sağlayacak ancak şu anda yalnızca uygulamanızın nasıl başlatılabileceğine odaklanıyoruz. Özellikle:
- Tarayıcıya manifest dosyanız hakkında bilgi verme
- Nasıl başlatılacağını açıklama
Manifesti oluşturup sitenizde barındırdıktan sonra, uygulamanızı kapsayan tüm sayfalarınıza aşağıdaki gibi bir bağlantı etiketi eklemeniz yeterlidir:
<link rel="manifest" href="/manifest.json" />
Chrome, Android için 38. sürümden (Ekim 2014) beri manifestleri desteklemektedir. Manifestler, web uygulamanızın ana ekrana yüklendiğinde nasıl görüneceğini (short_name, name ve icons özellikleri aracılığıyla) ve kullanıcı başlatma simgesini tıkladığında nasıl başlatılacağını (start_url, display ve orientation aracılığıyla) kontrol etmenizi sağlar.
Örnek bir manifest aşağıda gösterilmiştir. Bir manifest dosyasında bulunabilecek her şeyi göstermez.
{
"short_name": "Kinlan's Amaze App",
"name": "Kinlan's Amazing Application ++",
"icons": [
{
"src": "launcher-icon-4x.png",
"sizes": "192x192",
"type": "image/png"
}
],
"start_url": "/index.html",
"display": "standalone",
"orientation": "landscape"
}
Bu özellik tamamen aşamalıdır ve özelliği destekleyen bir tarayıcının kullanıcıları için daha iyi, daha entegre deneyimler oluşturmanıza olanak tanır.
Kullanıcı sitenizi veya uygulamanızı ana ekrana eklediğinde, bunu bir uygulama gibi kullanmayı amaçlar. Bu nedenle, kullanıcıyı bir ürün açılış sayfasına değil, uygulamanızın işlevine yönlendirmeniz gerekir. Örneğin, kullanıcının uygulamanızda oturum açması gerekiyorsa bu sayfa, başlatmak için iyi bir sayfadır.
Yardımcı programlar
Yardımcı program uygulamalarının çoğu bu özellikten hemen yararlanabilir. Bu uygulamaların, mobil platformlardaki diğer uygulamalar gibi bağımsız olarak başlatılmasını istersiniz. Bir uygulamaya bağımsız olarak başlatılmasını söylemek için bunu Web Uygulaması Manifesti'ne ekleyin:
"display": "standalone"
Oyunlar
Oyunların çoğu, manifest dosyasından hemen yararlanır. Oyunların büyük çoğunluğu tam ekran olarak ve belirli bir yönde başlatılmak ister.
Dikey kaydırmalı bir oyun veya Flappy Birds gibi bir oyun geliştiriyorsanız oyununuzun her zaman dikey modda olmasını istersiniz.
"display": "fullscreen",
"orientation": "portrait"
Öte yandan, bir bulmaca oyunu veya X-Com gibi bir oyun geliştiriyorsanız oyunun her zaman yatay yönü kullanmasını isteyebilirsiniz.
"display": "fullscreen",
"orientation": "landscape"
Haber siteleri
Haber siteleri çoğu durumda tamamen içerik tabanlı deneyimlerdir. Çoğu geliştirici, yeni Sites sitelerine manifest eklemeyi düşünmez. Manifest, neyin başlatılacağını (haber sitenizin ön sayfası) ve nasıl başlatılacağını (tam ekran veya normal bir tarayıcı sekmesi olarak) tanımlamanıza olanak tanır.
Seçim size ve kullanıcılarınızın deneyiminize nasıl erişmek isteyeceğini düşündüğünüze bağlıdır. Sitenizin, bir sitede olmasını beklediğiniz tüm tarayıcı arayüzüne sahip olmasını istiyorsanız ekranı browser olarak ayarlayabilirsiniz.
"display": "browser"
Haber sitenizin, deneyimlerini uygulama olarak ele alan ve kullanıcı arayüzünden web benzeri tüm Chrome öğelerini kaldıran haber odaklı uygulamaların çoğuna benzemesini istiyorsanız display özelliğini standalone olarak ayarlayabilirsiniz.
"display": "standalone"
Sahte adres çubuğu: Adres çubuğunu otomatik olarak gizleme
Adres çubuğunu aşağıdaki gibi otomatik olarak gizleyerek "sahte tam ekran" yapabilirsiniz:
window.scrollTo(0, 1);
Bu oldukça basit bir yöntemdir. Sayfa yüklenir ve tarayıcı çubuğuna ekrandan çıkması söylenir. Maalesef standartlaştırılmamıştır ve iyi desteklenmemektedir. Ayrıca bir dizi tuhaflıkla da başa çıkmanız gerekir.
Örneğin, tarayıcılar genellikle kullanıcı sayfaya geri döndüğünde sayfadaki konumu geri yükler. window.scrollTo kullanıldığında bu durum geçersiz kılınır ve kullanıcı rahatsız olur. Bu sorunu çözmek için son konumu localStorage'da depolamanız ve uç durumlarla (ör. kullanıcının sayfayı birden fazla pencerede açması) ilgilenmeniz gerekir.
Kullanıcı deneyimi yönergeleri
Tam ekrandan yararlanan bir site oluştururken kullanıcılarınızın seveceği bir hizmet oluşturabilmek için dikkat etmeniz gereken birkaç olası kullanıcı deneyimi değişikliği vardır.
Gezinme denetimlerine güvenmeyin
iOS'te donanım geri düğmesi veya yenileme hareketi yoktur. Bu nedenle, kullanıcıların uygulamada gezinirken kilitlenmemelerini sağlamanız gerekir.
Tüm büyük platformlarda tam ekran modunda mı yoksa yüklü modda mı çalıştığınızı kolayca tespit edebilirsiniz.
iOS
iOS'te, kullanıcının uygulamayı ana ekrandan başlatıp başlatmadığını görmek için navigator.standalone boole değerini kullanabilirsiniz.
if (navigator.standalone == true) {
// My app is installed and therefore fullscreen
}
Web Uygulaması Manifesti (Chrome, Opera, Samsung)
Yüklü bir uygulama olarak başlatıldığında Chrome gerçek tam ekran deneyiminde çalışmadığından document.fullscreenElement null değerini döndürür ve CSS seçiciler çalışmaz.
Kullanıcı, sitenizde bir hareketle tam ekran istediğinde, kullanıcı arayüzünüzü tam ekran durumuna tepki verecek şekilde uyarlamanıza olanak tanıyan CSS sözde seçici de dahil olmak üzere standart tam ekran API'leri kullanılabilir.
selector:-webkit-full-screen {
display: block; // displays the element only when in fullscreen
}
selector {
display: none; // hides the element when not in fullscreen mode
}
Kullanıcı sitenizi ana ekrandan başlatırsa display-mode medya sorgusu, web uygulaması manifestinde tanımlanan değere ayarlanır. Tam ekran modunda ise
şu şekilde olur:
@media (display-mode: fullscreen) {
}
Kullanıcı uygulamayı bağımsız modda başlatırsa display-mode medya sorgusu standalone olur:
@media (display-mode: standalone) {
}
Firefox
Kullanıcı siteniz üzerinden tam ekran istediğinde veya uygulamayı tam ekran modunda başlattığında, CSS sözde seçici de dahil olmak üzere tüm standart tam ekran API'leri kullanılabilir. Bu sayede, kullanıcı arayüzünüzü tam ekran durumuna tepki verecek şekilde uyarlayabilirsiniz:
selector:-moz-full-screen {
display: block; // hides the element when not in fullscreen mode
}
selector {
display: none; // hides the element when not in fullscreen mode
}
Internet Explorer
IE'de CSS sözde sınıfında kısa çizgi yoktur ancak bunun dışında Chrome ve Firefox'a benzer şekilde çalışır.
selector:-ms-fullscreen {
display: block;
}
selector {
display: none; // hides the element when not in fullscreen mode
}
Spesifikasyon
Spesifikasyondaki yazım, IE tarafından kullanılan söz dizimiyle eşleşir.
selector:fullscreen {
display: block;
}
selector {
display: none; // hides the element when not in fullscreen mode
}
Kullanıcıyı tam ekran deneyiminde tutma
Tam ekran API'si bazen biraz titiz olabilir. Tarayıcı tedarikçileri, kullanıcıları tam ekran bir sayfaya kilitlemek istemez. Bu nedenle, mümkün olan en kısa sürede tam ekrandan çıkmak için mekanizmalar geliştirmişlerdir. Bu nedenle, birden fazla sayfaya yayılan tam ekran bir web sitesi oluşturamazsınız. Bunun nedenleri şunlardır:
- URL'yi
window.location = "http://example.com"kullanarak programatik olarak değiştirmek tam ekran modundan çıkılmasına neden olur. - Sayfanızdaki harici bir bağlantıyı tıklayan kullanıcılar tam ekrandan çıkar.
- URL'yi
navigator.pushStateAPI aracılığıyla değiştirmek de tam ekran deneyiminden çıkılmasına neden olur.
Kullanıcıya tam ekran deneyimi sunmaya devam etmek istiyorsanız iki seçeneğiniz vardır:
- Tam ekrana geçmek için yüklenebilir web uygulaması mekanizmalarını kullanın.
- # parçasını kullanarak kullanıcı arayüzünüzü ve uygulama durumunuzu yönetin.
URL'yi güncellemek için #söz dizimini (window.location = "#somestate") kullanarak ve window.onhashchange etkinliğini dinleyerek uygulama durumundaki değişiklikleri yönetmek için tarayıcının kendi geçmiş yığınını kullanabilir, kullanıcının donanım geri düğmelerini kullanmasına izin verebilir veya geçmiş API'sini aşağıdaki gibi kullanarak basit bir programatik geri düğmesi deneyimi sunabilirsiniz:
window.history.go(-1);
Kullanıcının ne zaman tam ekrana geçeceğini seçmesine izin verme
Kullanıcı için, bir web sitesinin beklenmedik bir şey yapmasından daha can sıkıcı bir durum yoktur. Kullanıcı sitenize gittiğinde onu tam ekrana geçmesi için kandırmaya çalışmayın.
İlk dokunma etkinliğini kesmeyin ve requestFullscreen() yöntemini çağırın.
- Rahatsız edici.
- Tarayıcılar, gelecekte bir noktada kullanıcıdan uygulamanın tam ekranı kaplamasına izin vermesini isteyebilir.
Uygulamaları tam ekran başlatmak istiyorsanız her platform için yükleme deneyimlerini kullanmayı düşünün.
Kullanıcıyı uygulamanızı ana ekrana yüklemeye zorlamayın.
Yüklü uygulama mekanizmaları aracılığıyla tam ekran deneyimi sunmayı planlıyorsanız kullanıcıya karşı düşünceli olun.
- Dikkatli olun. Uygulamayı yükleyebileceklerini bildirmek için banner veya altbilgi kullanın.
- Kullanıcı istemi kapatırsa tekrar göstermeyin.
- Kullanıcılar, hizmetinizden memnun kalmadıkları sürece ilk ziyaretlerinde uygulamayı yüklemek istemeyebilir. Sitenizde olumlu bir etkileşimden sonra kullanıcıdan yükleme yapmasını isteyebilirsiniz.
- Sitenizi düzenli olarak ziyaret eden bir kullanıcı uygulamayı yüklemiyorsa gelecekte de yükleme olasılığı düşüktür. Kullanıcıları spam'e boğmayın.
Sonuç
Tam olarak standartlaştırılmış ve uygulanmış bir API'miz olmasa da bu makalede sunulan bazı yönergeleri kullanarak istemciden bağımsız olarak kullanıcının tüm ekranından yararlanan deneyimler oluşturabilirsiniz.