Sjekk ut CSS Wizardry for retningslinjer for å skrive klar, vedlikeholdbar CSS

https://github.com/csswizardry

CSS Wizardry

er en samling vedlikeholdt av Harry Roberts, og ligger på csswizardy-rutenettet, og CSS Wizardry inkluderer bloggen bak koden så å si, hvor Harry skriver om emnene i CSS og skalerbarhet, arkitektur, vedlikehold og mer. Dette stykket vil gjennomgå CSS-Guidelines-depotet, som er utpekt som en retningslinje på høyt nivå for å skrive håndterbar, vedlikeholdbar CSS.

CSS-retningslinjer

CSS-retningslinjene er et sett med notater, råd og generelle retningslinjer, som er et levende dokument som fra og med dette forfatterskapet ble oppdatert 9 dager tidligere, og er en "Star" -favoritt blant noen 2 483 GitHub-brukere. Retningslinjene som er morsmål i engelsk, blir også oversatt til russisk, kinesisk og fransk. Retningslinjene er beregnet på store prosjekter med lange tidslinjer som også kan inneholde et stort team av utviklere og er ment å hjelpe grupper med å arbeide på en enhetlig måte - å holde stilark og kode vedlikeholdbare, transparente, lesbare og skalerbare. Dokumentet dekker syntaks, formatering, dokumentasjon, CSS-anatomi, tilnærming, tankesett og måte å skrive og arkivere CSS-kode.

innhold

Retningslinjene er godt dokumentert gjennomgående og inneholder en innholdsfortegnelse, sortert, som starter med Anatomy of a CSS Document, som dekker den generelle uttalelsen, og deretter kommer inn i en fil versus mange filer, noe jeg er sikker på at har vekket mange debatt blant utviklere. Det forklarer videre å ha en innholdsfortegnelse for CSS i tillegg til seksjonstitler. Noen av de andre innholdsseksjonene i retningslinjen er:

  • Kilde rekkefølge
  • Anatomi av regelsett
  • Å navngi stevner
  • kommentarer
  • Skrive CSS
  • Bygge nye komponenter
  • OOCSS
  • Oppsett
  • Og mer!

Høydepunkter fra retningslinjene

  • Harry anbefaler å begrense stilark til maksimalt 80 tegn bredde når det er mulig; unntak inkluderer gradientsyntaks, nettadresser og kommentarer. Jeg er sikker på at det kan være noen andre unntak, avhengig av enkeltprosjekter.
  • Innholdsfortegnelsen øverst på stilarkene er en som jeg ikke ser ofte, men det vil hjelpe spesielt med hensyn til store CSS-filer, og seksjonstitler er fornuftige, jeg vet at de fleste CSS vil ha en form for seksjonstitler som: / * ---- Parallax Rulling Container Styles ---- * /
  • Kilde rekkefølge er en god tommelfingerregel. Harry anbefaler et velordnet stilark der hver seksjon bygger på og arver en fornuftig organisasjon når hver seksjon kaskaderer nedover filen.
  • Å anbefale navnekonvensjoner for det meste anbefales å bruke bindestrek-avgrensede klasser, for eksempel .class-one, .class_one eller .classOne, men i noen tilfeller er det nødvendig å bruke

© Copyright 2021 | mobilegn.com