עקרונות כלליים
קוד צריךלהראות כאילו אדם אחד כתב אותו, גם אם בפועל כמה אנשים כתבו ●
אותו.
מתלבטים לגבי הסטייל? תמיד העדיפו להשתמש בסטייל קיים מאשר ליצור ●
חדש.
ריווח
הריווח משפר את הקריאות של מסמך העיצוב, לכן חשוב להקפיד שהריווח יהיה
אחיד, כלומר:
לא לערבב רווחים וטאבים - לבחור באחד מהם )עדיף לבחור ברווחים(. ●
אם משתמשים ברווחים, יש להגדיר את מס' הרווחים שישמשו להזחה )עדיף 4 ●
רווחים(.
טיפ:
ניתן להגדיר בעורך שכל התווים יוצגו, כולל הרווחים והטאבים.
5.
כתיבת הערות
חשוב מאודלכתוב הערות בתוך הקוד, במיוחד כאשר צוות של כמה אנשים עובד על
אותו הקוד. על-מנת שכל חברי הצוות יוכלו להבין את הקוד, כדאי להקדיש זמן
לתאר את הרכיבים, איך הם עובדים, המגבלות שלהם וכיצד הם בנויים.
עיצוב ההערות צריך להיות פשוט ואחיד:
יש למקם הערה בשורה נפרדת בשורה מעל נושא ההערה. ●
השתדלו לשמור על שורות קצרות של לא יותר מ08- תווים. ●
השתמשו בהערות כדי להפריד בין חלקים שונים של הקוד. ●
מבנה הקוד -סידור המאפיינים
כדאי לסדר את המאפיינים לפי עקרון מסויים, למשל
לפי הא'-ב' או לפי חשיבות המאפיינים.
בדוגמא הזו, המאפיינים מסודרים כך:
מאפייני מיקום ●
מאפייני box-model ●
שאר המאפיינים ●
* לשיטה אלפביתית יש חסרון בכך שהמאפיינים
קשורים מפוזרים ולא נמצאים אחד ליד השני.
9.
מבנה הקוד -מקרים חריגים
כשיש כמה סלקטורים שלהם מאפיין בודד, כדאי
לרשום את הכל בשורה אחת ולהוסיף רווח לפני
ואחרי המאפיין.
כשיש מאפיין עם כמה ערכים, למשל צל פנימי
וחיצוני, כדאי לרשום את הערכים בשורות נפרדות
עם הזחה נוספת.