L'HTML costituisce le fondamenta di qualsiasi sito web. È la prima cosa che le persone vedono. Senza di esso, non ci sarebbe alcun sito web.

Per questo motivo, è importante attenersi alle buone pratiche di scrittura di codice. Se non segui le migliori pratiche, creerai un'esperienza utente negativa per chi naviga sul web.

C'è sempre qualcosa di nuovo da imparare in HTML, che tu sia un novellino a programmare o un professionista con tanta esperienza alle spalle.

In questo articolo, parleremo delle migliori pratiche di base in HTML.

Iniziamo. 💃

Le migliori pratiche HTML

Le migliori pratiche HTML sono regole che ti aiuteranno a creare siti web facili da mantenere e leggere.

Qui illustriamo alcune linee guida da tenere a mente quando si costruisce un sito web basato sull'HTML:

Usa un solo elemento h1 per pagina

Ci sono 6 diversi tag di intestazione in HTML, da <h1> a <h6>. Il tag <h1> è l'intestazione principale (il soggetto della pagina web), mentre il tag <h6> è l'intestazione meno importante.

Il tag <h1> è più grande del tag <h2> , il tag <h2> è più grande del tag <h3>, e così via fino al tag <h6>. Ciascuna di queste intestazioni diminuisce di dimensione in base alla sua importanza.

È importante evitare di usare più di un elemento <h1> per pagina.

Non fare questo ⬇️:

<main>
<div>
<h1>Programmare può essere divertente?</h1>
<p>Più scrivi codice, più migliori.</p>
</div>

<div>
<h1>Programmare è divertente</h1>
<p>È sempre meglio quando ci si diverte a scrivere codice</p>
</div>
</main>

Nell'esempio precedente, abbiamo usato il tag <h1> nel primo e secondo <div>. Programmare in questo modo funzionerà, ma sebbene tu raggiunga lo stesso obiettivo, questa non è una buona pratica.

Fai così invece ⬇️:

<main>

<div>
<h1>Programmare può essere divertente?</h1>
<p>Più scrivi codice, più migliori</p>
</div>

<div>
<h2>Programmare è divertente</h2>
<p>È sempre meglio quando ti diverti a scrivere codice</p>
</div>

</main>

Avere un solo elemento <h1> in una pagina web è fondamentale per l'ottimizzazione dei motori di ricerca (Search Engine Optimization, SEO). Aiuta i motori di ricerca a capire di cosa tratta una pagina web (l'idea principale di una pagina).

Non saltare i livelli di intestazione in HTML

Quando si usano i tag di intestazione, è fondamentale procedere da <h1> a <h2>, <h3>, <h4> e così via...

Non usare <h1> e saltare poi subito a <h3> quando usi i tag di intestazione. È difficile per i visitatori del web usare uno screen reader per capire il contenuto della tua pagina web quando salti i livelli di intestazione.

Uno screen reader è una tecnologia che aiuta le persone con difficoltà visive ad accedere a contenuti digitali come siti web o applicazioni ed interagire con essi tramite audio o touch. Gli utenti principali degli screen reader sono persone non vedenti o con una vista molto limitata.

Non fare questo ⬇️:

<h1>Programmare è divertente</h1>
<h3>È sempre meglio quando ci si diverte a scrivere codice</h3>
<h5>La consistenza è chiave</h5>

Fai così invece⬇️:

<h1>Programmare può essere divertente?</h1>
<h2>Più scrivi codice, più migliori</h2>
<h3>Programmare è divertente</h3>

Usa l'elemento figure per aggiungere didascalie alle tue immagini in HTML

È consigliabile usare l'elemento <figure> quando si aggiungono didascalie alle immagini. È importante usare l'elemento <figcaption> insieme all'elemento <figure> affinché funzioni.

Non fare questo ⬇️:

<div>
<img src=“a-man-coding.jpg” alt=“Un uomo che lavora al computer”>
<p>Questa è una foto di un uomo che lavora al computer</p>
</div>

L'esempio precedente funzionerà come previsto, ma non è il modo migliore per farlo. In una situazione in cui l'immagine non si carica, verranno visualizzati sullo schermo il testo alternativo alt e il testo nell'elemento <p>. Sarà difficile per un visitatore usare uno screen reader per distinguere i testi del paragrafo e dell'alt.

Tieni sempre a mente che il fatto che il tuo codice funzioni, non vuol dire che stai seguendo le migliori pratiche.

Fai così invece ⬇️:

<figure>
<img src=“a-man-coding.jpg” alt=“Un uomo che lavora al computer”>
<figcaption> Questa è una foto di un uomo che lavora al computer</figcaption>
</figure>

L'esempio precedente è il modo migliore per aggiungere didascalie alle tue immagini.

È importante aggiungere didascalie alle tue immagini in questo modo per:

• Ottimizzazione dei motori di ricerca: è più facile trovare le tue immagini sui motori di ricerca.
• Sarà più semplice per i visitatori del sito che usano gli screen reader capire il contenuto della tua pagina web.

Non usare div per creare intestazioni e piè di pagina - usa invece gli elementi semantici

Gli elementi semantici HTML rendono la struttura di un documento più significativa su una pagina web. È buona pratica usare gli elementi semantici HTML per il corretto assemblaggio della tua pagina web.

Evita di usare <div> al posto degli elementi semantici HTML. Non usare gli elementi <div> per mostrare intestazioni o piè di pagina sulla tua pagina web. Al loro posto usa gli elementi semantici <header> e <footer>.

L'elemento <header> mostra la navigazione o la parte iniziale della pagina web.

L'elemento <footer> mostra le informazioni sul copyright o i link di navigazione della pagina web.

Non fare questo ⬇️:

<div class="header">
<a href="index.html">Home</a>
<a href="#">About</a>
<a href="#">Contact</a>
</div>

<div class="footer">
<a href="index.html">Home</a>
<a href="#">About</a>
<a href="#">Contact</a>
</div>

Nell'esempio sopra, abbiamo usato il tag <div> come un contenitore per l'intestazione e il piè di pagina . Scriverlo così funzionerà, ma anche se raggiungi lo stesso obiettivo, questa non è questa una buona pratica.

Fai così invece ⬇️:

<header>
<h1></h1>
</header>

<footer>
<a href="index.html">Home</a>
<a href="#">About</a>
<a href="#">Contact</a>
</footer>

L'esempio precedente è il modo migliore per aggiungere piè di pagina ed intestazioni alla tua pagina web.

È importante aggiungere piè di pagina e intestazioni usando gli elementi HTML semantici perché:

• Usare gli elementi semantici per l'intestazione (header) e il piè di pagina (footer) rende il tuo codice più leggibile.
• Fornisce una migliore esperienza utente per i visitatori del sito. Sarà più facile per i visitatori che usano uno screen reader per capire il contenuto della tua pagina web.

Dai un'occhiata a questo articolo per sapere di più sugli elementi HTML semantici.

Evita di usare <b> e <i> per il grassetto o il corsivo del testo di una pagina web

I tag <b> e <i> sono anche conosciuti come i tag per il grassetto e il corsivo. Sono entrambi usati per evidenziare le parole in un testo su una pagina web.

Non dovresti usare <b> e <i> per il grassetto e il corsivo perché non hanno un significato semantico. Usa la proprietà CSS font-weight o usa i tag <strong> e <em> invece.

Usi il tag <strong> per rendere importante un testo su una pagina web. Evidenzia o rende in grassetto un testo su una pagina web. Il tag <em> enfatizza il testo in una pagina web. Mostra anche il testo in corsivo come lo farebbe il tag <i>.

Non fare questo ⬇️:

<p><i>Programma al tuo ritmo</i><p>

<p><b>programma al tuo ritmo</b><p>

I testi visualizzati saranno in grassetto e in corsivo nell'esempio sopra. Questo non avrà nessuna rilevanza per l'utente del web che usa uno screen reader. Non ha alcun significato semantico.

Le specifiche di HTML5 dicono che i tag <b> e <i> dovrebbero essere usati come come ultima risorsa se nessun altro tag è disponibile.

Fai così invece ⬇️:

<p><strong>Programma al tuo ritmo</strong><p>

<p><em>programma al tuo ritmo</em><p>

Non posizionare elementi block-level dentro elementi inline

Gli elementi block-level iniziano in una nuova linea su una pagina web. Di default, occupano una riga intera su una pagina. Non sarai in grado di aggiungere contenuti inline a un elemento block-level senza usare CSS.

Gli elementi <p>, <h1>-<h6> e <div> sono alcuni degli esempi di un elemento block-level.

Gli elementi inline occupa l'area più piccola su una pagina web. Non iniziano su una nuova riga su una pagina web.

Gli elementi <span>, <em> e <a> sono alcuni esempi di elementi inline.

Non puoi posizionare elementi block-level all'interno di elementi inline.

Non fare questo ⬇️:

<a href="#" >

    <p> Visita freecodecamp </p>

</a>

Non puoi inserire un <p> dentro un <a> perché <p> è un elemento block-level e <a> è un elemento inline.

Fai così invece ⬇️:

<p>
Visita <a href="www.freecodecamp. org" target="_blank">FreecodeCamp</a> 
per imparare Javascript
</p>

L'esempio sopra è il modo migliore per annidare elementi inline all'interno un elemento block-level.

È importante notare che:

• L'elemento block-level non può essere annidato dentro un elemento inline.
• L'elemento inline può essere annidato dentro un elemento block-level.
• Elementi inline e block-level possono essere annidati dentro un elemento block-level.

Una nota veloce: annidare, nell'esempio precedente, significa "posizionare all'interno". Perciò, quando dico che non può essere annidato, mi riferisco al fatto che un elemento non può essere collocato all'interno di un altro.

Spero che tu abbia compreso queste tre semplici regole usate per annidare elementi.

È anche possibile convertire elementi block-level in elementi inline e viceversa, usando il CSS. Scrivi display: inline-block e display: inline per convertire un elemento da block-level a inline.

È importante ricordare che solo perché il tuo codice funziona non vuol dire che stai seguendo le pratiche migliori.

Questo è il motivo per cui ti consiglio di usare sempre il servizio di convalida del markup W3C per controllare il tuo codice.

Questo validatore controlla la validità del markup dei documenti HTML, XHTML, SMIL, MathML, ecc.

Puoi controllare il tuo codice copiando il suo URL e incollandolo sul sito o caricando il tuo file HTML.

Conclusione

Spero che questo articolo ti abbia aiutato a imparare qualcosa di nuovo sulle migliori pratiche HTML. Ho provato a includere solo i consigli più utili, così che tu possa iniziare ad usarli fin da subito!

Se hai altre domande o commenti, sentiti libero/a di contattarmi in qualsiasi momento su Twitter @cessss_ e LinkedIn: Success

Proverò a rispondere il prima possibile! Grazie per aver letto questo articolo 💙.

Di recente, il mio manager mi ha incaricato di creare un report automatico. Ho progettato il report affinché fosse semplice. Includeva un po' di numeri da un database e alcune operazioni matematiche basilari. Ero entusiasta di poter finalmente mettere in mostra in azienda le mie incredibili abilità con Python.

Ho completato e consegnato il prodotto. Tutto andava alla grande. O almeno, fino a due settimane più tardi. Il mio report ha cominciato a fallire improvvisamente a causa di un errore di divisione per zero. È il momento di far partire la risata registrata.

La mia breve storia non è particolarmente dettagliata, ma dovrebbe enfatizzare l'importanza di gestire casi limite ed errori quando si scrivono programmi. Questo report sarebbe dovuto essere un'opportunità per mettere in mostra la mia competenza in Python, invece, ne è risultata una figuraccia piuttosto imbarazzante.

Perciò, prendiamoci un momento per imparare le basi della gestione degli errori utilizzando la libreria standard di Python. Metterò in evidenza alcune delle cose di cui hai bisogno per iniziare.

Prima di iniziare a gestire eccezioni, dovresti avere una buona comprensione dei fondamenti di Python. Avrai bisogno di sapere perché le eccezioni vengono generate per poterle trattare!

Ecco cosa tratteremo:

1. Istruzioni try ed except in Python
2. Esecuzione condizionale con la clausola else
3. Eccezioni predefinite
4. Eccezioni personalizzate
5. Considerazioni sulle prestazioni

Istruzioni try ed except in Python

Le istruzioni try ed except sono i metodi principali per trattare le eccezioni. Ecco un esempio:

x = 0
try:
    print(5 / x)
except ZeroDivisionError:
    print("Qualcosa è andato storto")

# Qualcosa è andato storto

Rivediamo il codice qui sopra per essere sulla stessa lunghezza d'onda:

1. La riga 1 assegna il valore 0 alla variabile x
2. Le righe 2 e 3 aprono una clausola try e tentano di dividere 5 per la variabile x
3. Le righe 4 e 5 aprono una clausola except per qualsiasi errore di divisione per zero (ZeroDivisionError) e istruiscono il programma a stampare un messaggio qualora si tentasse di dividere per 0

Probabilmente avrai notato il problema: la variabile x ha valore 0, e sto cercando di dividere 5 per x . Neppure i migliori matematici del mondo sono in grado di dividere per 0, e nemmeno Python può farlo. Quindi, che succede?

Se non ci occupassimo dell'errore, il programma terminerebbe immediatamente, non appena cercasse di dividere 5 per x. Dato che i programmi non sanno cosa fare con le eccezioni senza istruzioni esplicite, abbiamo creato la clausola except nella riga 4 e fornito al programma i passi da seguire in caso di divisione per 0.

Questa è l'intera idea dietro la gestione delle eccezioni: occorre dire al programma cosa fare quando si verifica un errore che non può semplicemente ignorare. Vediamo come funzionano le clausole try ed except.

Analisi dell'istruzione try

Le clausole try ed except seguono un modello che ti permette di gestire in modo affidabile i problemi nel tuo codice. Vediamo come funziona.

Il primo passo è tentare l'esecuzione del codice nella clausola try.

Dopodiché, abbiamo tre possibilità:

Nessun errore nella clausola try

Se il codice nella clausola try viene eseguito senza nessun errore, il programma:

1. Esegue la clausola try
2. Salta tutte le clausole except
3. Prosegue con la sua normale esecuzione

x = 1
try:
    print(5 / x)
except ZeroDivisionError:
    print("Qualcosa è andato storto")

print("Sto eseguendo dopo la clausola try!")

# 5.0
# Sto eseguendo dopo la clausola try!

In questo esempio modificato, puoi vedere che non ci sono problemi nella clausola try (righe 3 e 4). Il codice verrà eseguito, la clausola except verrà saltata e il programma riprenderà l'esecuzione dopo la terminazione delle istruzioni try ed except.

Errori nella clausola try e l'eccezione è specificata

Se il codice nella clausola try genera un'eccezione e il tipo di eccezione viene specificato dopo qualsiasi parola chiave con except , il programma:

1. Salta il codice rimanente nella clausola try
2. Esegue il codice nella clausola except corrispondente
3. Prosegue con la sua normale esecuzione

x = 0
try:
    print(5 / x)
except ZeroDivisionError:
    print("Qualcosa è andato storto")

print("Sto eseguendo dopo la clausola try!")

# Qualcosa è andato storto
# Sto eseguendo dopo la clausola try!

Tornando al mio primo esempio, ho cambiato la nostra variabile x di nuovo al valore 0 e ho provato a dividere 5 per x. Ciò produce un  errore di divisione per zero (ZeroDivisionError). Dato che l'istruzione except specifica questo tipo di eccezione, il codice in quella clausola viene eseguito prima che il programma riprenda la sua normale esecuzione.

Errori nella clausola Try e l'Eccezione NON è Specificata

Infine, se il programma genera un'eccezione nella clausola try, ma l'eccezione non viene specificata in nessuna istruzione except, allora il programma:

1. Interrompe l'esecuzione del programma e dà errore

x = 0
try:
    print(5 / y)
except:
    print("Qualcosa è andato storto")

print("Sto eseguendo dopo la clausola try!")

# NameError: name 'y' is not defined (il nome 'y' non è definito)

Nell'esempio precedente, sto cercando di dividere 5 per la variabile y, che non esiste. Questo genera un errore di nome (NameError). Non abbiamo specificato al programma come gestire i NameError, perciò l'unica opzione è quella di terminare.

Pulizia

try ed except sono gli strumenti principali della gestione degli errori, ma esiste anche una clausola opzionale che puoi usare, chiamata finally. La clausola finally verrà sempre eseguita, che ci sia un errore o meno.

x = 0
try:
    print(5 / x)
except ZeroDivisionError:
    print("Sono la clausola except!")
finally:
    print("Sono la clausola finally!")

print("Sto eseguendo dopo la clausola try!")

# Sono la clausola except!
# Sono la clausola finally!
# Sto eseguendo dopo la clausola try!

In questo esempio, ho creato il nostro amato ZeroDivisionError. Puoi vedere che l'ordine di esecuzione è:

1. La clausola except
2. La clausola finally
3. Qualsiasi codice successivo

Una volta che correggiamo il codice nella clausola try in modo che non generi più errori, vedrai comunque un ordine di esecuzione simile. Al posto della clausola except, verrà eseguita la clausola try.

x = 1
try:
    print(5 / x)
except ZeroDivisionError:
    print("Sono la clausola except!")
finally:
    print("Sono la clausola finally!")

print("Sto eseguendo dopo la clausola try!")

# 5.0
# Sono la clausola finally!
# Sto eseguendo dopo la clausola try!

Noterai che l'unica differenza è che la clausola try viene eseguita con successo perché non vengono generate eccezioni. La clausola finally e il codice successivo vengono eseguiti come previsto.

Questo è utile in alcuni casi in cui vuoi dare una "ripulita" indipendentemente dall'esito delle clausole try e except. Azioni come chiudere connessioni, chiudere file e fare logging sono ottimi candidati per la clausola finally.

Esecuzione condizionale con la clausola else

Un'altra clausola opzionale è la clausola else. La clausola else è semplice: se il codice nella clausola try viene eseguito senza generare errori, allora anche il codice nella clausola else verrà eseguito.

x = 1
try:
    print(5 / x)
except ZeroDivisionError:
    print("Sono la clausola except!")
else:
    print("Sono la clausola else!")
finally:
    print("Sono la clausola finally!")

print("Sto eseguendo dopo la clausola try!")

# 5.0
# Sono la clausola else!
# Sono la clausola finally!
# Sto eseguendo dopo la clausola try!

L'ordine di esecuzione per questo esempio è:

1. La clausola try
2. La clausola else
3. La clausola finally
4. Qualsiasi codice dopo

Se dovessimo incontrare un'eccezione o un errore nella clausola try, la clausola else verrebbe ignorata.

x = 0
try:
    print(5 / x)
except ZeroDivisionError:
    print("Sono la clausola except!")
else:
    print("Sono la clausola else!")
finally:
    print("Sono la clausola finally!")

print("Sto eseguendo dopo la clausola try!")

# Sono la clausola except!
# Sono la clausola finally!
# Sto eseguendo dopo la clausola try!

Eccezioni predefinite

Mi hai visto scrivere a proposito di due diversi errori finora: NameError e ZeroDivisionError. Ma se avessimo bisogno di altre eccezioni?

Esiste un'intera lista di eccezioni predefinite in Python che fanno parte della libreria standard. Probabilmente coprono quasi tutte le necessità che potresti avere nella gestione di errori ed eccezioni.

Ecco solo alcune che potrebbero essere importanti:

• KeyError – Una chiave non viene trovata in un dizionario
• IndexError – L'indice è fuori dai limiti stabiliti di un oggetto iterabile
• TypeError – Una funzione o un'operazione è stata usata su un tipo di oggetto sbagliato
• OSError – Errori generali del sistema operativo

Ce ne sono molte altre, che puoi trovare nella documentazione di Python. Consiglio di darci un'occhiata. Non solo diventerai più bravo a gestire gli errori, ma esplorerai anche cosa può effettivamente andare storto nei i tuoi programmi Python.

Eccezioni personalizzate

Se hai bisogno di funzionalità estese, puoi anche definire delle eccezioni personalizzate.

class ForError(Exception):
    def __init__(self, message):
        self.message = message

    def foo(self):
        print("bar")

Nell'esempio sopra, ho creato una nuova classe e l'ho estesa dalla classe Exception. Ora posso scrivere una funzionalità personalizzata e trattare questa eccezione come qualsiasi altro oggetto.

try:
    raise FooError("Questo è un errore di test")
except FooError as e:
    e.foo()

# bar

Qui ho generato di proposito il mio nuovo FooError. Ho catturato FooError e gli assegno l'alias e. Ora posso accedere al mio metodo foo() che ho costruito nella classe che ho creato.

Questo apre un mondo di possibilità quando si ha a che fare con gli errori. Log personalizzati, tracciamenti più dettagliati, o qualsiasi altra cosa di cui hai bisogno, tutto può essere codificato e creato.

Considerazioni sulle prestazioni

Ora che conosci le basi di try, except e degli oggetti eccezione, puoi cominciare a considerare di usarli nel tuo codice per gestire gli errori in modo elegante. Ma ci sono impatti significativi sulle prestazioni del codice?

La risposta breve è no. Con il rilascio di Python 3.11, non c'è praticamente nessuna riduzione di velocità nell'uso delle istruzioni try ed except quando non vengono sollevate eccezioni.

La cattura degli errori ha causato effettivamente qualche rallentamento. Ma in generale, è meglio catturare questi errori piuttosto che far crashare l'intero programma.

Nelle versioni precedenti di Python, usare le clausole try ed except causava del tempo di esecuzione aggiuntivo. Tieni presente questo dettaglio se non hai la versione aggiornata.

Ricapitolando

Grazie per aver letto fino a qui. Il futuro te e i tuoi futuri clienti ti ringrazieranno per la gestione degli errori.

Abbiamo esaminato le clausole try, except, else, e finally, il loro ordine di esecuzione e in quali circostanze vengono eseguite. Abbiamo anche visto le basi per creare eccezioni personalizzate.

La cosa più importante da ricordare è che le clausole try ed except sono i modi principali per gestire gli errori e dovresti usarle ogni volta che hai del codice rischioso e che potrebbe generare degli errori.

Inoltre, tieni a mente che la cattura degli errori renderà il tuo codice più resiliente e ti farà sembrare un programmatore decisamente migliore.