CSS ‫עקרונות של כתיבת‬
                             ‫מציגות: קסניה פופוב והדר ויס‬




Principles of writing consistent, idiomatic CSS ‫*מבוסס על‬
‫עקרונות כלליים‬


‫קוד צריך להראות כאילו אדם אחד כתב אותו, גם אם בפועל כמה אנשים כתבו‬   ‫●‬
                                                             ‫אותו.‬
  ‫מתלבטים לגבי הסטייל? תמיד העדיפו להשתמש בסטייל קיים מאשר ליצור‬     ‫●‬
                                                             ‫חדש.‬
‫העקרונות עליהם נדבר...‬




‫כתיבת‬
                  ‫ריווח‬
‫הערות‬


        ‫מבנה‬
        ‫הקוד‬
‫ריווח‬

   ‫הריווח משפר את הקריאות של מסמך העיצוב, לכן חשוב להקפיד שהריווח יהיה‬
                                                             ‫אחיד, כלומר:‬
      ‫לא לערבב רווחים וטאבים - לבחור באחד מהם )עדיף לבחור ברווחים(.‬      ‫●‬

‫אם משתמשים ברווחים, יש להגדיר את מס' הרווחים שישמשו להזחה )עדיף 4‬        ‫●‬

                                                              ‫רווחים(.‬
                                                                      ‫טיפ:‬
                 ‫ניתן להגדיר בעורך שכל התווים יוצגו, כולל הרווחים והטאבים.‬
‫כתיבת הערות‬

‫חשוב מאוד לכתוב הערות בתוך הקוד, במיוחד כאשר צוות של כמה אנשים עובד על‬
    ‫אותו הקוד. על-מנת שכל חברי הצוות יוכלו להבין את הקוד, כדאי להקדיש זמן‬
          ‫לתאר את הרכיבים, איך הם עובדים, המגבלות שלהם וכיצד הם בנויים.‬


                                     ‫עיצוב ההערות צריך להיות פשוט ואחיד:‬
                ‫יש למקם הערה בשורה נפרדת בשורה מעל נושא ההערה.‬        ‫●‬

                ‫השתדלו לשמור על שורות קצרות של לא יותר מ08- תווים.‬    ‫●‬

                 ‫השתמשו בהערות כדי להפריד בין חלקים שונים של הקוד.‬    ‫●‬
‫כתיבת הערות - דוגמאות‬
‫מבנה הקוד‬


‫כל סלקטור בשורה נפרדת‬    ‫שימוש אחיד במרכאות‬   ‫להוסיף רווח‬




 ‫כל מאפיין בשורה נפרדת‬
    ‫ובהזחה אחת פנימה‬                                                        ‫להוסיף‬
                                                                        ‫נקודה-פסיק‬




      ‫להוסיף שורה רווח‬                                                  ‫להוסיף רווח‬



  ‫סגירת סוגריים במיקום‬       ‫להוסיף רווח‬            ‫לכתוב צבעים ב-‪hex‬‬
   ‫של תחילת הסלקטור‬                           ‫ולהשתמש בקיצורים כשאפשר‬
‫מבנה הקוד - סידור המאפיינים‬


‫כדאי לסדר את המאפיינים לפי עקרון מסויים, למשל‬
           ‫לפי הא'-ב' או לפי חשיבות המאפיינים.‬


            ‫בדוגמא הזו, המאפיינים מסודרים כך:‬
                            ‫מאפייני מיקום‬   ‫●‬

                      ‫מאפייני ‪box-model‬‬     ‫●‬

                          ‫שאר המאפיינים‬     ‫●‬



   ‫* לשיטה אלפביתית יש חסרון בכך שהמאפיינים‬
     ‫קשורים מפוזרים ולא נמצאים אחד ליד השני.‬
‫מבנה הקוד - מקרים חריגים‬


 ‫כשיש כמה סלקטורים שלהם מאפיין בודד, כדאי‬
 ‫לרשום את הכל בשורה אחת ולהוסיף רווח לפני‬
                             ‫ואחרי המאפיין.‬




   ‫כשיש מאפיין עם כמה ערכים, למשל צל פנימי‬
‫וחיצוני, כדאי לרשום את הערכים בשורות נפרדות‬
                           ‫עם הזחה נוספת.‬
‫תודה! :-(‬

סטנדרטים בכתיבת Css

  • 1.
    CSS ‫עקרונות שלכתיבת‬ ‫מציגות: קסניה פופוב והדר ויס‬ Principles of writing consistent, idiomatic CSS ‫*מבוסס על‬
  • 2.
    ‫עקרונות כלליים‬ ‫קוד צריךלהראות כאילו אדם אחד כתב אותו, גם אם בפועל כמה אנשים כתבו‬ ‫●‬ ‫אותו.‬ ‫מתלבטים לגבי הסטייל? תמיד העדיפו להשתמש בסטייל קיים מאשר ליצור‬ ‫●‬ ‫חדש.‬
  • 3.
    ‫העקרונות עליהם נדבר...‬ ‫כתיבת‬ ‫ריווח‬ ‫הערות‬ ‫מבנה‬ ‫הקוד‬
  • 4.
    ‫ריווח‬ ‫הריווח משפר את הקריאות של מסמך העיצוב, לכן חשוב להקפיד שהריווח יהיה‬ ‫אחיד, כלומר:‬ ‫לא לערבב רווחים וטאבים - לבחור באחד מהם )עדיף לבחור ברווחים(.‬ ‫●‬ ‫אם משתמשים ברווחים, יש להגדיר את מס' הרווחים שישמשו להזחה )עדיף 4‬ ‫●‬ ‫רווחים(.‬ ‫טיפ:‬ ‫ניתן להגדיר בעורך שכל התווים יוצגו, כולל הרווחים והטאבים.‬
  • 5.
    ‫כתיבת הערות‬ ‫חשוב מאודלכתוב הערות בתוך הקוד, במיוחד כאשר צוות של כמה אנשים עובד על‬ ‫אותו הקוד. על-מנת שכל חברי הצוות יוכלו להבין את הקוד, כדאי להקדיש זמן‬ ‫לתאר את הרכיבים, איך הם עובדים, המגבלות שלהם וכיצד הם בנויים.‬ ‫עיצוב ההערות צריך להיות פשוט ואחיד:‬ ‫יש למקם הערה בשורה נפרדת בשורה מעל נושא ההערה.‬ ‫●‬ ‫השתדלו לשמור על שורות קצרות של לא יותר מ08- תווים.‬ ‫●‬ ‫השתמשו בהערות כדי להפריד בין חלקים שונים של הקוד.‬ ‫●‬
  • 6.
    ‫כתיבת הערות -דוגמאות‬
  • 7.
    ‫מבנה הקוד‬ ‫כל סלקטורבשורה נפרדת‬ ‫שימוש אחיד במרכאות‬ ‫להוסיף רווח‬ ‫כל מאפיין בשורה נפרדת‬ ‫ובהזחה אחת פנימה‬ ‫להוסיף‬ ‫נקודה-פסיק‬ ‫להוסיף שורה רווח‬ ‫להוסיף רווח‬ ‫סגירת סוגריים במיקום‬ ‫להוסיף רווח‬ ‫לכתוב צבעים ב-‪hex‬‬ ‫של תחילת הסלקטור‬ ‫ולהשתמש בקיצורים כשאפשר‬
  • 8.
    ‫מבנה הקוד -סידור המאפיינים‬ ‫כדאי לסדר את המאפיינים לפי עקרון מסויים, למשל‬ ‫לפי הא'-ב' או לפי חשיבות המאפיינים.‬ ‫בדוגמא הזו, המאפיינים מסודרים כך:‬ ‫מאפייני מיקום‬ ‫●‬ ‫מאפייני ‪box-model‬‬ ‫●‬ ‫שאר המאפיינים‬ ‫●‬ ‫* לשיטה אלפביתית יש חסרון בכך שהמאפיינים‬ ‫קשורים מפוזרים ולא נמצאים אחד ליד השני.‬
  • 9.
    ‫מבנה הקוד -מקרים חריגים‬ ‫כשיש כמה סלקטורים שלהם מאפיין בודד, כדאי‬ ‫לרשום את הכל בשורה אחת ולהוסיף רווח לפני‬ ‫ואחרי המאפיין.‬ ‫כשיש מאפיין עם כמה ערכים, למשל צל פנימי‬ ‫וחיצוני, כדאי לרשום את הערכים בשורות נפרדות‬ ‫עם הזחה נוספת.‬
  • 10.