Share
Scopul întregii serii de a ajuta la expunerea WordPress Coding Standards, de ce contează și cum să scrie codul WordPress de calitate. Pentru a face acest lucru, analizăm în detaliu fiecare secțiune a standardelor de codare WordPress.
Până acum, am acoperit:
Astăzi, vom acoperi importanța spațiului alb. Mai exact, vom acoperi indentația, utilizarea spațiului și spațiile care se apropie. Atât de ușor se pare că acestea sunt câteva dintre cele mai ignorate sau utilizate în mod necorespunzător aspecte ale standardelor de codificare.
Înainte de a ne uita la ceea ce se întâmplă cu diferitele standarde de codificare, este important să înțelegem de ce spațiul alb este important nu numai în WordPress, ci și în limbile de programare în general.
Pur și simplu, este pentru că îmbunătățește lizibilitatea.
Acesta este motivul pentru care unele limbi de programare sunt delimitate prin spațiu sau tab, de aceea unele limbi de programare vă cer să spațiați anumite părți ale codului, cum ar fi parametrii de funcții, indexurile matricei și multe altele.
Cand vine vorba de WordPress, conventiile sunt in loc nu numai pentru lizibilitate, ci si pentru a oferi o experienta de lectura si dezvoltare consecventa pentru toti cei care lucreaza pe teme, plug-inuri, aplicatii sau aplicatii core.
Tine minte: Scopul standardelor de codare este de a face ca codul sursă să pară scris de un singur dezvoltator, deoarece stabilește un nivel al așteptărilor dezvoltatorilor care contribuie.
În ceea ce privește indentația, nu este nimic deosebit de nou, revoluționar sau diferit în ceea ce privește WordPress. În general, veți indentați de fiecare dată când începeți un nou bloc.
Aceasta înseamnă că:
Dacă sunteți obișnuit să scrieți cod în limbi în stil C, atunci nu este nimic deosebit de nou aici, corect?
Un exemplu despre cum poate arăta acest lucru este exact acest lucru:
funcția foo (argumente $) if (0 < count( $arguments ) foreach ( $arguments as $arg => valoarea $) echo $ value;
În conformitate cu standardele de codificare:
Indentarea dvs. trebuie să reflecte întotdeauna structura logică. Utilizare filele reale și nu spații, deoarece acest lucru permite cea mai mare flexibilitate în rândul clienților.
Cheia este de a lua în considerare că începutul liniilor ar trebui să înceapă cu file și că codul ar trebui să reflecte a logic structura. Nu supracomplicați și nu încercați să simplificați lucrurile.
Există încă o nuanță pentru spațiul alb în cadrul standardelor de codificare WordPress: filele ar trebui să fie folosite la începutul liniei, dar spațiile ar trebui să fie utilizate oriunde altundeva. În cea mai mare parte, aceasta este o regulă ușor de urmărit; cu toate acestea, în WordPress, de multe ori veți crea mese pentru a trece ca argumente.
În mod ideal, dorim ca fiecare index al matricei să se alinieze astfel încât lizibilitatea să fie cât mai mare posibil, dar avem deseori tendința să folosim filele pentru a le face mai ușor să le aliniem, însă aceasta este de fapt o încălcare a standardelor de codificare.
Accentsconagua
$ args = array ('ID' => 1, 'post_title' => 'Titlul', 'post_content' => 'Conținutul'); Ca atare, asigurați-vă că voi numai utilizați filele la începutul fiecărei linii.
În ceea ce privește WordPress, am constatat că spațiile au fost folosite mult mai liber decât în alte limbi. Nu spun asta doar ca o observație, deoarece a fost o ajustare personală pe care trebuia să o fac în a veni atât de la .NET și Ruby.
Acestea fiind spuse, ca și în majoritatea celorlalte orientări din Cod, nu este nimic deosebit de complex; cu toate acestea, există unele distincții importante care trebuie să fie amintit atunci când scrieți cod.
Spațiile trebuie plasate în următoarele locuri:
||, &&, și !)<, >, ==, ===, etc)=)Cele mai multe dintre acestea sunt relativ directe, însă, din experiența mea, am constatat că regulile de matrice tind să provoace cea mai mare confuzie în rândul dezvoltatorilor, deci aici este o notă rapidă a ceea ce este considerat corect și care nu este:
// Spațiere corectă ... $ arr [$ x] = 'foo'; $ arr [0] = 'bar'; // Spațiere incorectă ... $ arr [$ x] = 'bar'; $ arr [0] = 'bar';
După cum puteți vedea, nu este nimic teribil de complicat, dar este o convenție relativ ușor de pierdut.
Această regulă este probabil cel mai ușor de reținut dintre toate. Pur și simplu, nu ar trebui să existe spații care să rămână la sfârșitul oricărei linii de cod.
În funcție de IDE, este posibil să aveți acest filtru încorporat; de altă dată, poate fi necesar să instalați un plugin care va efectua această acțiune pentru dvs. ori de câte ori salvați fișierul. Dar indiferent de situație, este o caracteristică relativ ușor de integrat în orice IDE pe care îl utilizați.
În plus, majoritatea editorilor - indiferent dacă este vorba de un editor de text glorificat sau de un IDE complet - ar trebui să aibă capacitatea de a activa afișarea filelor și a spațiilor.
Vizualizarea filelor și a spațiului alb în Coda 2 Din nou, aceasta este una dintre cele mai simple convenții de urmat și este posibil ca IDE-ul sau editorul ales să aibă această caracteristică sau un plugin disponibil, care vă va permite să faceți automat acest lucru.
Dacă nu, ar trebui să puteți activa capacitatea de a vedea file, spații, retururi de caroserie și așa mai departe, astfel încât să puteți identifica cu ușurință Unde spațiile înclinate sunt.
Evident, spațiul alb joacă un rol semnificativ în scrierea codului bazat pe WordPress. În acest articol, am explorat indentația, tabelele, spațiile, spațiile înclinate și de ce și cum să le includem în proiectele noastre.
În următorul articol, vom continua să vorbim despre subtilitățile standardelor de codare WordPress, uitandu-ne la stilul de bretele, expresiile regulate și nuanțele folosirii etichetelor PHP prin codul nostru WordPress.
