In questo codelab imparerai ad adattare i tuoi contenuti in base alla qualità della rete. Il video in background di questa pagina verrà caricato solo quando gli utenti sono collegati a una rete rapida. Nelle reti più lente, verrà caricata un'immagine.
L'API Network Information consente di accedere alle informazioni sulla qualità della connessione dell'utente. Ti servirà la proprietà effectiveType
per decidere quando pubblicare un video e quando pubblicare un'immagine. effectiveType
può essere 'slow-2g'
, '2g'
, '3g'
o '4g'
.
Passaggio 1: controlla il tipo di connessione
Il file index.html
contiene un tag <video>
per visualizzare il video di sfondo (riga 22). Il codice in script.js
carica il video impostando l'attributo src
del tag video. Il codice di caricamento dei video è descritto più dettagliatamente nel passaggio 2.
Per caricare il video in modo condizionale, controlla innanzitutto se l'API Network Information è disponibile; in caso affermativo, controlla il tipo di connessione.
- In
script.js
, aggiungi un'istruzioneif
che verifichi se l'oggettonavigator.connection
esiste e se ha la proprietàeffectiveType
. - Aggiungi un'istruzione
if
per controllare ileffectiveType
della rete.
if (navigator.connection && !!navigator.connection.effectiveType) {
if (navigator.connection.effectiveType === '4g') {
// Only load video on the fastest connections.
} else {
// In any other case load the image.
}
}
Inserisci il codice di caricamento del video esistente in un'istruzione else
, in modo che il video venga caricato anche nei browser che non supportano l'API Network Information.
if (navigator.connection && !!navigator.connection.effectiveType) {
if (navigator.connection.effectiveType === '4g') {
// video loading code
} else {
// image loading code
}
} else {
const video = document.getElementById('coverVideo');
const videoSource = video.getAttribute('data-src');
video.setAttribute('src', videoSource);
video.setAttribute('style', 'height: 100%; width: 100%; display:inline');
}
Passaggio 2: carica il video
Se effectiveType
è '4g'
, utilizza il codice di caricamento del video dall'inizio del codelab.
if (navigator.connection.effectiveType === '4g') {
const video = document.getElementById('coverVideo');
const videoSource = video.getAttribute('data-src');
video.setAttribute('src', videoSource);
video.setAttribute('style', 'height: 100%; width: 100%; display:inline');
} else {
// image loading code
}
Ecco come funziona il codice di caricamento del video: inizialmente il tag <video>
non scarica né mostra nulla perché l'attributo src
non è impostato. L'URL del video da caricare viene specificato utilizzando l'attributo data-src
.
<video id="coverVideo" playsinline autoplay loop muted data-src="https://cdn.glitch.com/b6491350-b058-4eb6-aa6c-55c93122073e%2FMatrix%2C%20Console%2C%20Hacking%2C%20Code.mp4?1551464245607"></video>
Gli attributi dati ti consentono di archiviare informazioni aggiuntive sugli elementi HTML standard. Un elemento dati può avere qualsiasi nome, purché inizi con "data-".
Per visualizzare effettivamente il video nella pagina, devi recuperare il valore da data-src
e impostarlo come attributo src
dell'elemento video.
Innanzitutto, recupera l'elemento DOM che contiene l'asset:
const video = document.getElementById('coverVideo');
Poi recupera la posizione della risorsa dall'attributo data-src
:
const videoSource = video.getAttribute('data-src');
Infine, impostalo come attributo src
dell'elemento video:
video.setAttribute('src', videoSource);
L'ultima riga si occupa del posizionamento CSS:
video.setAttribute('style', 'height: 100%; width: 100%; display:inline');
Passaggio 3: carica l'immagine
Per caricare un'immagine in modo condizionale su reti più lente, utilizza la stessa strategia utilizzata per il video.
Aggiungi un elemento immagine a index.html
(subito dopo l'elemento video) e utilizza
l'attributo data-src
anziché src
.
<img id="coverImage" data-src="https://cdn.glitch.com/36529535-5976-40f8-979b-40c898b86bd0%2F36529535-5976-40f8-979b-40c898b86bd0_1_Sn80dgiwpMjBVrqjfiDbnA.jpg?1553003835358" />
In script.js
, aggiungi il codice per impostare l'attributo src
dell'immagine in base al valore effectiveType
della rete.
if (navigator.connection.effectiveType === '4g') {
const video = document.getElementById('coverVideo');
const videoSource = video.getAttribute('data-src');
video.setAttribute('src', videoSource);
video.setAttribute('style', 'height: 100%; width: 100%; display:inline');
} else {
const image = document.getElementById('coverImage');
const imageSource = image.getAttribute('data-src');
image.setAttribute('src', imageSource);
image.setAttribute('style', 'height: 100%; width: 100%; display:inline');
}
Prova
Per testarlo:
- Per visualizzare l'anteprima del sito, premi Visualizza app, quindi premi A schermo intero .
- Premi "Control+Maiusc+J" (o "Comando+Opzione+J" su Mac) per aprire DevTools.
- Fai clic sulla scheda Rete.
- Fai clic sul menu a discesa Limitazione, che per impostazione predefinita è impostato su Nessuna limitazione. Seleziona 3G veloce.
Ora ricarica la pagina con il 3G veloce ancora attivo. L'app carica un'immagine in background anziché il video:
Credito extra: rispondere ai cambiamenti
Ricordi che questa API ha un onchange
listener di eventi?
Puoi utilizzarlo per molte cose: adattare dinamicamente i contenuti, ad esempio la qualità video; riavviare i trasferimenti di dati differiti quando viene rilevato un passaggio a un tipo di rete ad alta larghezza di banda; o inviare notifiche agli utenti quando la qualità della rete cambia.
Ecco un semplice esempio di come utilizzare questo ascoltatore. Aggiungila a script.js
. Questo
codice chiamerà la funzione displayNetworkInfo
ogni volta che le informazioni sulla rete
cambiano.
navigator.connection.addEventListener('change', displayNetworkInfo);
Nella pagina index.html
è già presente un elemento <h2>
vuoto. Ora definisci la funzione displayNetworkInfo
in modo che mostri le informazioni sulla rete nell'elemento <h2>
e invoca la funzione.
function displayNetworkInfo() {
document.getElementById('connection').innerHTML = navigator.connection.effectiveType;
}
displayNetworkInfo();
Ecco lo stato finale dell'app su Glitch.
Per riprovare:
- Per visualizzare l'anteprima del sito, premi Visualizza app, quindi premi A schermo intero .
- Premi "Control+Maiusc+J" (o "Comando+Opzione+J" su Mac) per aprire DevTools.
- Fai clic sulla scheda Rete.
- Fai clic sul menu a discesa Limitazione, che per impostazione predefinita è impostato su Nessuna limitazione. Seleziona 3G veloce.
- Ricarica l'app.
L'app aggiornerà le informazioni sulla rete su 3G: