Linee guida per la revisione del codice per CSS, JS e HTML

9

Mi è stato chiesto di creare linee guida per rivedere CSS, JS e HTML. So che ci sono linee guida per la codifica di JS, ma non ne so nulla su HTML e CSS. Per rivedere JS, seguirò certamente queste linee guida e le menzionerò. Ma che dire di CSS e HTML? Oltre agli errori logici e ai problemi di indentazione, ci sono delle cose specifiche che devo controllare quando rileggo markup e / o CSS?

    
posta Kumar 04.05.2011 - 06:37
fonte

6 risposte

5

Alcune cose da cercare:

  • Le informazioni strutturate vengono identificate utilizzando i tag HTML appropriati? H1 - H6 per le intestazioni, UL / OL e LI per le liste, ecc?
  • Non sono utilizzati tag HTML legacy ( <b> , <i> , <center> , <font> )?
  • Il sito utilizza la minor quantità di markup possibile?
  • Le informazioni di stile sono esternalizzate ai file CSS?
  • Tutto il Javascript è esternalizzato? compresi i gestori di eventi?
  • I nomi delle classi CSS si riferiscono alla funzione nella pagina ( img-caption ), e non alla forma ( bold-red ) o al contenuto ( pink-elephant )?
  • Le immagini sono nel formato appropriato (PNG o JPEG, a seconda del tipo)?
  • Sono state utilizzate versioni minimizzate delle librerie Javascript?
  • Facoltativamente, sono stati ridotti al minimo tutti i file JavaScript e CSS sviluppati localmente?
  • Convalida HTML / CSS?
  • È stato usato YSlow (o simile) per controllare / ottimizzare le prestazioni?
  • (principalmente) [SEO] Il sito è accessibile con Javascript disattivato?
  • [SEO] Il contenuto più pertinente si trova nella parte superiore dell'HTML?
risposta data 06.05.2011 - 01:56
fonte
0

Uno degli elementi importanti di uno stile buono in HTML è miglioramento progressivo . Ciò significa che il layout HTML sarà valido anche senza CSS o JavaScript. Quindi, una volta elaborati JS / CSS, apparirà migliore (ad esempio, il vecchio elenco HTML <select> verrà animato).

Questo ha anche a che fare con il markup non intrusivo. Invece di <font style="color:red;font-size:16pt">Hello</font> si usa <div class="red-colored-big-fond">Hello</div> .

Lo stesso con JavaScript. Invece di <button onclick="javascript:alert('a');">Clickme</button> si dovrebbe specificare una classe / ID pulsante e indirizzarla da JavaScript. Rende anche più semplice il mantenimento del codice di markup.

    
risposta data 06.05.2011 - 00:22
fonte
0

Convalidare che viene utilizzata la minor quantità di markup per eseguire l'attività. Assicurati che il markup sia anche semantico, non usare quando un tag fa la stessa identica cosa e dà più informazioni. Convalida che gli span non vengono creati come elementi di blocco e viceversa.

Inoltre, alex mostra un grande punto in maniera indiretta. Assicurati che nessuno usi nomi di classe come "caratteri di colore rosso", perché circa 20 secondi dopo che è stato distribuito per davvero qualcuno lo cambierà in un piccolo carattere blu. Ho visto questo CSS:

.arial12pt { font-family: Verdana; font-size: 8pt; }

Tutto nel tuo markup dovrebbe descrivere cos'è la pagina, non come appare. Sono assolutamente d'accordo sul miglioramento progressivo, ma di nuovo in modo indiretto. La pagina non ha requisiti per guardare ovunque vicino allo stesso con i CSS come senza di esso. Non cercare di renderli uguali, perché tornerai indietro in table-land e spacer.gif.

    
risposta data 06.05.2011 - 00:33
fonte
0

Per quanto riguarda l'HTML, cerco sempre di avere gerarchie e rientranze nei miei file. Ad esempio, se ho un sacco di div:

<div id="content">
   <div id="post">
     <div class="title">
       Blah Blah Title
     </div>
   </div>
</div>

Suppongo che sia abbastanza ovvio per la maggior parte di chi crea layout e modelli, ma molto spesso vedo solo HTML ingarbugliato che non ha gerarchia strutturale, rendendo difficile la lettura per un'altra persona. Immagino che provenga da uno sfondo più CS, questo è qualcosa che mi rimane nella mente. Lo stesso vale per i CSS. Diciamo che stai progettando un div:

#whatever{
    background-image: url('blah.gif');
    color: #FFF000;
}

La rientranza rende molto più facile leggere velocemente quando sei abituato a un'altra lingua mista come PHP / Ruby / Whatever. Di nuovo, dipende da come lavori meglio, ma quando gli altri leggono il mio HTML, mi piace renderlo davvero organizzato:).

Inoltre, come detto sopra, è sempre una buona idea dare un nome alle tue classi CSS e id al tuo layout, specialmente quando diventa peloso (proprio come le variabili e i metodi di denominazione in altre lingue). Qualcos'altro da tenere d'occhio è la temuta "congettura e controllo" dei margini, dei paddings e di altri problemi di allineamento. Qualcosa che cerco spesso di evitare è mettere numeri negativi nei margini e nei paddings. Può creare confusione se non hai creato il layout da solo e se vuoi tornare in seguito e modificarlo, potresti doverlo revisionare. Secondo me è sempre una buona idea non provare nulla di hokey o "kludgy" nei CSS, anche se sembra carino; di solito c'è un modo migliore per farlo, anche se devi ristrutturare il tuo CSS!

    
risposta data 06.05.2011 - 02:09
fonte
0

Per Javascript vorrei sempre che si convalidasse con JSLint, posso pensare a così tanti bug che JSLint capta che non usarlo è semplicemente pazzesco.

    
risposta data 06.05.2011 - 05:37
fonte
0

Mi sono imbattuto in questo documento standard che mi è piaciuto. Farò anche eco a ciò che è stato detto sul miglioramento progressivo. In generale, se qualcun altro scrive HTML / CSS, dovresti essere in grado di guardarlo più tardi e di essere piacevolmente sorpreso di quanto non sia male il markup e dovrebbe essere in grado di apportare semplici modifiche di stile in modo semplice ed efficiente.

    
risposta data 06.05.2011 - 05:52
fonte

Leggi altre domande sui tag