Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Help! My Stylesheets are a Mess!

Help! My Stylesheets are a Mess!

This talk covers the architecture and process we use @ caring.com to manage our stylesheets and front-end design.

Chris Eppstein

May 02, 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 2, 12
  2. Do your stylesheets feel like this? Incomprehensible wall of tangled

    styles is incomprehensible Wednesday, May 2, 12
  3. You Have Styles in the Way Wednesday, May 2, 12

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

    up here because you didn’t have a plan. Because what you need
  5. Or Else Your stylesheets will sap your soul of the

    will to live Wednesday, May 2, 12
  6. You need better tools. Wednesday, May 2, 12 Better tools

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

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

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

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

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

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

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

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

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

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

    2, 12 From each category you can usually only pick 1 class to apply to the same element.
  17. Property Soup Le average sass stylesheet. Wednesday, May 2, 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.
  18. Property Soup Le average sass stylesheet. Alphabetized Wednesday, May 2,

    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.
  19. Property Soup Le average sass stylesheet. Alphabetized Wednesday, May 2,

    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.
  20. Typography The non-color aspects of text. Wednesday, May 2, 12

    Note how the typography and foreground are mixed up?
  21. Foreground border-color, color, shadow-color Wednesday, May 2, 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.
  22. An Object Description In Sass, we describe objects using words

    and high-level concepts, not style primitives. Wednesday, May 2, 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.
  23. An Object Description In Sass, we describe objects using words

    and high-level concepts, not style primitives. Wednesday, May 2, 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.
  24. An Object Description Our object description is longer now. Not

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

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

    Do this right now. I’ll wait. Now back to the show.
  27. 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 2, 12
  28. 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 2, 12
  29. 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 2, 12
  30. Progression of a Design Wednesday, May 2, 12 This is

    a generalization, not a rule. Sometimes you skip a step, some concepts never appear in the foundation.
  31. Progression of a Design Prototype Variations Multiple Uses Domain Concepts

    Presentational Concepts Concept App Styles Foundation Classes Mixin Library Wednesday, May 2, 12 This is a generalization, not a rule. Sometimes you skip a step, some concepts never appear in the foundation.
  32. 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 2, 12
  33. Style Concern: Typography • Defines how a collection of typographic

    elements are styled. • Vertical Rhythm • There is no default typography. Wednesday, May 2, 12 opt-in typography is not the industry standard approach. The industry is mostly wrong about this. Typographic inheritance can be annoying.
  34. 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 2, 12 opt-in typography is not the industry standard approach. The industry is mostly wrong about this. Typographic inheritance can be annoying.
  35. Style Concern: Typography • Defines how a collection of typographic

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

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

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

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

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

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

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

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

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

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

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

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

    • Often linked to a background Wednesday, May 2, 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.
  48. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 2, 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.
  49. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 2, 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.
  50. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 2, 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.
  51. Style Concern: Foreground • Gives color to type and borders

    • Often linked to a background Wednesday, May 2, 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 2, 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 2, 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 2, 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: Lists/Tables/Forms • These are unique beasts • Might

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

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

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

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

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

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

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

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

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

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

    name. Unfortunately, designers are not often good at naming things. Wednesday, May 2, 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.
  66. Naming Docent Developers, your job is to help them develop

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

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

    too-generic name. Wednesday, May 2, 12
  69. Losing the Name Game Wednesday, May 2, 12 Sometimes you

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

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

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

    Change the design Wait: Don’t name it Wednesday, May 2, 12 Sometimes you cannot find a good name, or you find some use of a design that doesn’t match the current name.
  73. The Designer Wins Wednesday, May 2, 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... :(
  74. Classes or IDs? Use IDs for unique page elements. Specificity

    is good when styling something specific. Wednesday, May 2, 12 not always possible to find a document order. specificity is BETTER than !important. !important is a nuclear option.
  75. Specificity Wars Time to Refactor! Wednesday, May 2, 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.
  76. 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 2, 12 Placeholders: only import once or use the mixin hack if your module has these Selectors: Usually don't mix with Functions/mixins/placeholders
  77. 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 2, 12
  78. 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 2, 12
  79. Downsides ‣Learning curve ‣Harder to debug ‣Classitis ‣A lot of

    work Wednesday, May 2, 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.
  80. Benefits Efficient communication Wednesday, May 2, 12 More efficient team

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

    in responsibilities, means changes breaks things less often in unexpected ways
  82. Benefits Built to last Wednesday, May 2, 12 These styles

    will be used for > 2 years. These styles will be used by a team. For the love of god, don't do this for your blog or a marketing/promotional site.
  83. Thank you! Compass is Charityware. Please donate on our behalf

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