Lock in $30 Savings on PRO—Offer Ends Soon! ⏳

FOWD: Stylesheet Organization with Sass

FOWD: Stylesheet Organization with Sass

Chris Eppstein

May 16, 2012
Tweet

More Decks by Chris Eppstein

Other Decks in Technology

Transcript

  1. Chris Eppstein Architect: Caring.com Creator: Compass Stylesheet Authoring Framework Core

    Developer: Sass Stylesheet Language @chriseppstein Wednesday, May 16, 12
  2. Do your stylesheets feel like this? Incomprehensible wall of tangled

    styles is incomprehensible http://wikibon.org/blog/wp-content/uploads/2011/10/5.„eg Wednesday, May 16, 12
  3. Caring.com Four Designers in Four Years. Wednesday, May 16, 12

    Like most startups we were moving fast. We knew we hadn’t found the right tone, design, resonance with our user base.
  4. Sass: A double edged sword 3.5 MB of CSS across

    100+ files Wednesday, May 16, 12 This would be insanity if it was hand authored CSS, but sass let us keep it manageable while we were learning, evolving, looking for product/market fit.
  5. We found it! Our users loved the new design. http://newplateaus.areavoices.com/2012/05/01/are-older-people-happier/

    Wednesday, May 16, 12 Finally we’re getting thank you letters and people get upset if our site goes down.
  6. .foundational { ...} Wednesday, May 16, 12 We built a

    living styleguide. In this talk, I’m going to explain the process we used to create it.
  7. You Have Styles in the Way Wednesday, May 16, 12

    styles from the cascade and document inheritance that are hurting instead of helping
  8. You Have Accidentally the Stylesheets Wednesday, May 16, 12 Ended

    up here because you didn’t have a plan. Because what you need
  9. Or Else Your stylesheets will sap the will to live

    from your soul http://wikibon.org/blog/wp-content/uploads/2011/10/5.„eg Wednesday, May 16, 12
  10. You need better tools. Wednesday, May 16, 12 Better tools

    that provide insulation between what you write and what you serve. So that you are free to organize without constraints.
  11. Property Soup Le average sass stylesheet. Wednesday, May 16, 12

    This is decent sass, could be a lot worse, would be a lot worse in css. but it can be so much better.
  12. Constructing an Object Wednesday, May 16, 12 From each category

    you can usually only pick 1 class to apply to the same element.
  13. Constructing an Object Wednesday, May 16, 12 From each category

    you can usually only pick 1 class to apply to the same element.
  14. Constructing an Object Wednesday, May 16, 12 From each category

    you can usually only pick 1 class to apply to the same element.
  15. Constructing an Object Wednesday, May 16, 12 From each category

    you can usually only pick 1 class to apply to the same element.
  16. Constructing an Object Wednesday, May 16, 12 From each category

    you can usually only pick 1 class to apply to the same element.
  17. Constructing an Object Wednesday, May 16, 12 From each category

    you can usually only pick 1 class to apply to the same element.
  18. Constructing an Object Wednesday, May 16, 12 From each category

    you can usually only pick 1 class to apply to the same element.
  19. Constructing an Object Unstyled Background Container Typography Foreground Margin/Padding Wednesday,

    May 16, 12 From each category you can usually only pick 1 class to apply to the same element.
  20. Constructing an Object .calming .shadow-box .reading-text .green-bg-type .vertically-padded Wednesday, May

    16, 12 From each category you can usually only pick 1 class to apply to the same element.
  21. Property Soup Le average sass stylesheet. Wednesday, May 16, 12

    How should we organize our style properties? <wait for it> Alphabetize them! <ayfkm> We can do better than this. We will organize our properties by style concern.
  22. Property Soup Le average sass stylesheet. Alphabetized Wednesday, May 16,

    12 How should we organize our style properties? <wait for it> Alphabetize them! <ayfkm> We can do better than this. We will organize our properties by style concern.
  23. Property Soup Le average sass stylesheet. Alphabetized Wednesday, May 16,

    12 How should we organize our style properties? <wait for it> Alphabetize them! <ayfkm> We can do better than this. We will organize our properties by style concern.
  24. Typography The non-color aspects of text. Wednesday, May 16, 12

    Note how the typography and foreground are mixed up?
  25. Foreground border-color, color, shadow-color Wednesday, May 16, 12 you can’t

    declare text shadow color explicitly, so we have to put all text shadows in the foreground, otherwise the shadow details would be in the typography.
  26. An Object Description In Sass, we describe objects using words

    and high-level concepts, not style primitives. Wednesday, May 16, 12 Isn’t this simpler to understand if you’re reading the code? We read code more often than we write it. Be nice to your future self.
  27. An Object Description In Sass, we describe objects using words

    and high-level concepts, not style primitives. Wednesday, May 16, 12 Isn’t this simpler to understand if you’re reading the code? We read code more often than we write it. Be nice to your future self.
  28. An Object Description Our object description is longer now. Not

    Re-Usable Re-Usable Wednesday, May 16, 12
  29. A Sad Reality If you use @extend like this, your

    stylesheets will be huge. Wednesday, May 16, 12 So unless you need the flexibility that semantic markup brings for shared content, etc
  30. We Need Browser Support for @extend Wednesday, May 16, 12

    Do this right now. I’ll wait. Now back to the show.
  31. Library: ‣No output. ‣Mostly presentational in nature. Foundation: ‣Core, Shared

    Styles. ‣Maps Presentation to Domain. Application: ‣Features. ‣One-off Pages. ‣Experimental styles. ‣Server traffic patterns Wednesday, May 16, 12
  32. Library: ‣No output. ‣Mostly presentational in nature. Foundation: ‣Core, Shared

    Styles. ‣Maps Presentation to Domain. Application: ‣Features. ‣One-off Pages. ‣Experimental styles. ‣Server traffic patterns Wednesday, May 16, 12
  33. Library: ‣No output. ‣Mostly presentational in nature. Foundation: ‣Core, Shared

    Styles. ‣Maps Presentation to Domain. Application: ‣Features. ‣One-off Pages. ‣Experimental styles. ‣Server traffic patterns Wednesday, May 16, 12
  34. Progression of a Design Prototype Variations Multiple Uses Domain Concepts

    Presentational Concepts Concept App Styles Foundation Classes Mixin Library Wednesday, May 16, 12 This is a generalization, not a rule. Sometimes you skip a step, some concepts never appear in the foundation.
  35. Progression of a Design Prototype Variations Multiple Uses Domain Concepts

    Presentational Concepts Concept App Styles Foundation Classes Mixin Library Wednesday, May 16, 12 This is a generalization, not a rule. Sometimes you skip a step, some concepts never appear in the foundation.
  36. Style Concern: Structure • Floated Grid - Provides the structure

    of a page. CSS3 will bring alternate layout methods. • Page layouts - Defines how primary elements adhere to the grid and respond. Blog Post Wednesday, May 16, 12
  37. Style Concern: Typography • Defines how a collection of typographic

    elements are styled. • Vertical Rhythm • There is no default typography. Wednesday, May 16, 12 opt-in typography is not the industry standard approach. The industry is mostly wrong about this. Typographic inheritance can be annoying.
  38. Style Concern: Typography • Defines how a collection of typographic

    elements are styled. • Vertical Rhythm • There is no default typography. Opt-in To Typography Wednesday, May 16, 12 opt-in typography is not the industry standard approach. The industry is mostly wrong about this. Typographic inheritance can be annoying.
  39. Style Concern: Typography • Defines how a collection of typographic

    elements are styled. • Vertical Rhythm • There is no default typography. Wednesday, May 16, 12 opt-in typography is not the industry standard approach. The industry is mostly wrong about this. Typographic inheritance can be annoying.
  40. Style Concern: Typography • Defines how a collection of typographic

    elements are styled. • Vertical Rhythm • There is no default typography. Wednesday, May 16, 12 opt-in typography is not the industry standard approach. The industry is mostly wrong about this. Typographic inheritance can be annoying.
  41. Style Concern: Container • Define a space using boxes and

    separators. • Accommodate whatever content you put in them. Wednesday, May 16, 12
  42. Style Concern: Container • Define a space using boxes and

    separators. • Accommodate whatever content you put in them. Wednesday, May 16, 12
  43. Style Concern: Container • Define a space using boxes and

    separators. • Accommodate whatever content you put in them. Wednesday, May 16, 12
  44. Style Concern: Container • Define a space using boxes and

    separators. • Accommodate whatever content you put in them. Wednesday, May 16, 12
  45. Style Concern: Spacers • Add space using dimensions from the

    vertical-rhythm and grid • Margins • Paddings • Un-paddings Wednesday, May 16, 12
  46. Style Concern: Spacers • Add space using dimensions from the

    vertical-rhythm and grid • Margins • Paddings • Un-paddings Wednesday, May 16, 12
  47. Style Concern: Spacers • Add space using dimensions from the

    vertical-rhythm and grid • Margins • Paddings • Un-paddings Wednesday, May 16, 12
  48. Style Concern: Background • Gives an area background color, pattern,

    or imagery. • Combine with any container. Wednesday, May 16, 12
  49. Style Concern: Background • Gives an area background color, pattern,

    or imagery. • Combine with any container. Wednesday, May 16, 12
  50. Style Concern: Background • Gives an area background color, pattern,

    or imagery. • Combine with any container. Wednesday, May 16, 12
  51. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  52. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  53. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  54. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  55. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  56. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  57. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  58. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 16, 12 It would be nice if the relationship was .foreground {@extend .background;} but it’s not (1 foreground has many backgrounds). This @extend approach introduces a fair bit of bloat, but it forces consistency. It’s a trade-off you can decide to make or not.
  59. Style Concern: Lists/Tables/Forms • These are unique beasts • Might

    be part of a typography • Use them semantically • Class on the main element Wednesday, May 16, 12
  60. Style Concern: Widgets • Styles for your interactive elements •

    SMACSS - Jonathan Snook Wednesday, May 16, 12
  61. Style Concern: Widgets • Styles for your interactive elements •

    SMACSS - Jonathan Snook Wednesday, May 16, 12
  62. Style Concern: Widgets • Styles for your interactive elements •

    SMACSS - Jonathan Snook Wednesday, May 16, 12
  63. Style Concern: Widgets • Styles for your interactive elements •

    SMACSS - Jonathan Snook Wednesday, May 16, 12
  64. Style Concern: Theming • Color Palette • Semantic Color Relationships

    • Default Variables • Compile Stylesheet with a different configuration Wednesday, May 16, 12
  65. Style Concern: Theming • Color Palette • Semantic Color Relationships

    • Default Variables • Compile Stylesheet with a different configuration Wednesday, May 16, 12
  66. Style Concern: Theming • Color Palette • Semantic Color Relationships

    • Default Variables • Compile Stylesheet with a different configuration Wednesday, May 16, 12
  67. Style Concern: Theming • Color Palette • Semantic Color Relationships

    • Default Variables • Compile Stylesheet with a different configuration Wednesday, May 16, 12
  68. Style Concern: Theming • Color Palette • Semantic Color Relationships

    • Default Variables • Compile Stylesheet with a different configuration Wednesday, May 16, 12
  69. Naming is a Collaboration Designers must pick or approve the

    name. Unfortunately, designers are not often good at naming things. Wednesday, May 16, 12 Coders have to name everything they make, but designers don’t. Naming is a skill that must be developed. You have to learn to explain your intuition and instinct.
  70. Naming Docent Developers, your job is to help them develop

    a shared design vocabulary. Wednesday, May 16, 12 If you are a developer and a designer, you now have an excuse for talking to yourself.
  71. The Name Game Find a name that describes the intent

    of a design element, not the appearance. Wednesday, May 16, 12
  72. The Name Game A too-specific name is better than a

    too-generic name. Wednesday, May 16, 12
  73. Losing the Name Game Wednesday, May 16, 12 Sometimes you

    cannot find a good name, or you find some use of a design that doesn’t match the current name.
  74. Losing the Name Game Give up: Pick two names Wednesday,

    May 16, 12 Sometimes you cannot find a good name, or you find some use of a design that doesn’t match the current name.
  75. Losing the Name Game Give up: Pick two names Consistency:

    Change the design Wednesday, May 16, 12 Sometimes you cannot find a good name, or you find some use of a design that doesn’t match the current name.
  76. Losing the Name Game Give up: Pick two names Consistency:

    Change the design Wait: Don’t name it Wednesday, May 16, 12 Sometimes you cannot find a good name, or you find some use of a design that doesn’t match the current name.
  77. The Designer Wins http://blog.hubspot.com/Portals/53/images/charlie-sheen-winning.png Wednesday, May 16, 12 Don’t force

    a design change just because a name doesn’t match. Intuition is a tricky thing, if you trust your designer, trust their gut feeling. If you don’t trust your designer... :(
  78. Classes or IDs? Use IDs for unique page elements. Specificity

    is good when styling something specific. Wednesday, May 16, 12 not always possible to find a document order. specificity is BETTER than !important. !important is a nuclear option.
  79. Specificity Wars Time to Refactor! Wednesday, May 16, 12 Fight

    the specificity wars, by refactoring; not by rejecting specificity. Document order is not enough. Keep the same order of specificity at the same level of abstraction.
  80. Structure of a Library Module 1.Dependency Imports 2.Variables, almost always

    defaulted. 3.Functions 4.Mixins 5.Placeholder selectors 6.Style Selectors Wednesday, May 16, 12 Placeholders: only import once or use the mixin hack if your module has these Selectors: Usually don't mix with Functions/mixins/placeholders
  81. Breaking the Rules ‣Experiment with new designs ‣Accommodate non-conforming design.

    ‣Build what you need today ‣Meet your deadlines ‣Diligently factor out what is common Wednesday, May 16, 12
  82. Documentation ‣It's better to show than to tell. ‣Make a

    living styleguide for documentation and prototyping. ‣This is your design catalog. ‣Teach the design, don't just exemplify it. Wednesday, May 16, 12
  83. Downsides ‣Learning curve ‣Harder to debug ‣Classitis ‣A lot of

    work Wednesday, May 16, 12 1-2 days of training to become capable. 3-4 weeks to be competent. It will take > 1 month for an experienced team to build a comprehensive styleguide.
  84. Benefits File Size 3.5 MB 1.2 MB Wednesday, May 16,

    12 Better factorization => less duplication. 2/3 reduction of total site-wide styles.
  85. Benefits Efficient communication Wednesday, May 16, 12 More efficient team

    thru better communication thanks to new vocabulary. completely Describing a page design can be done in ~15 minutes.
  86. Benefits Low Coupling Wednesday, May 16, 12 a clean separation

    in responsibilities, means changes breaks things less often in unexpected ways
  87. Benefits Built to last http://www.flickr.com/photos/wilhelmja/4233621517/ Wednesday, May 16, 12 Ok.

    Pyramids are probably a bit of an exagguration. These styles will be used and evolved for several years -- an eternity on the internet. These styles will be used by a team. For the love of god, don't do
  88. Thank you! Compass is Charityware. Please donate on our behalf

    to the United Mitochondrial Disease Foundation http://umdf.org/compass Wednesday, May 16, 12