Elevate your Coding Efficiency with CSS Naming Conventions

Sep 8, 2023 · 9 min read

Elevate your Coding Efficiency with CSS Naming Conventions

CSS naming convention improves collaboration among team members when working on projects and enhances a project’s maintainability and scalability by allowing developers to streamline their workflows. In this article, we will delve into the world of CSS naming conventions, showing practical examples and the benefits they bring to your development process.

In front-end development, writing clean and efficient code makes for a better programmer. It doesn’t matter if it’s a personal project you are working on, a collaborative assignment, an agile-driven project, or a test project for a job application. A fundamental section developers usually overlook is the implementation of CSS naming conventions, with some finding out the hard way just how frightening poorly written CSS code is when it comes to debugging and managing enormous codebases. Whether you may be aware of it or not, during coding tests or technical interviews, your naming practices pass across information on your development practices. They can be used to evaluate your behaviors and efficiency. So, in this article, we’ll show the best practices for CSS naming, so you’ll be able to raise the quality of your code. By the end of the article, readers should clearly understand CSS naming conventions and their benefits and will also be familiar with different style naming conventions. The ultimate goal for readers is to equip them with actionable insight and practical advice on these conventions, which they can apply to their own development workflows to code cleaner and more efficiently.

Importance of Clean and Efficient Coding in Front-end Development

When working on the front end of web applications, there tend to be a lot of styling requirements to improve the site’s appeal and create a friendly and intuitive user interface. During development, there are different choices for building components and applying styles to a web page; These choices could be pure CSS, using a CSS framework like TailwindCSS or Bootstrap, or opting for a UI component library instead, e.g. Radix UI. Regardless of the choice implemented for development, a need arises to make code easily readable and maintainable. This has led to the practice of different concepts in web development, such as component-based development, code reviews, Agile methodologies, etc. Clean code development is one of these practices and focuses on writing easily readable and maintainable code. This is achieved by using reasonable names, reusable components to avoid duplication, and following best practices. Adhering to clean code principles when coding can provide the following benefits to your application workflow:

Readability and understandability: Clean code makes it easier to understand the purpose of code blocks at a glance. It provides a level of understanding that makes working with a team of other developers feasible as less time is spent understanding the code intent and functionality.
Debugging and maintainability: With clean code, there are concise code blocks, modularized components, less code duplication, and meaningful names of functions and variables. This makes it easy to trace errors when they occur and to make enhancements to the code, adding new features with a lower risk of introducing bugs in the code.
Code Reusability: Clean code enforces the need for modularization during development. This principle makes code more organized and shorter, as a module/component needed to perform specific tasks can be imported, and the required props to perform the said task can be passed to the component to achieve the desired result. In this practice, developers leverage existing components and functions when developing different application parts, resulting in a faster development pace.
Improved collaboration: Having a dirty code infrastructure is characterized by a lack of structure and offers poor readability. This makes it difficult to extend work on the application to a team of other developers as it takes more time to onboard them and have them work together on the codebase. With clean code, collaboration is feasible, and there are well-laid-down rules for structuring code to ensure the team works together without a hitch.
Easier onboarding of new members to ongoing projects: With clean code, it is easier for new members to get up to speed with developing a project. There are clearly structured codes and logic, following established patterns and conventions, which makes the onboarding process shorter and new members can quickly get started contributing to the project while making pristine contributions following the established conventions.

Understanding CSS Naming Conventions

In this section, we will discuss the concept of CSS naming conventions, the advantages of its application, and its role in driving clean and efficient code.

What are CSS Naming Conventions

Conventions are practices that are widely accepted, standardized behavioral guides specifying steps to follow when making decisions or drawing up a design for a specific use case. The importance of widely accepted conventions is to promote understandability among large sets of people. What, then, is a CSS naming convention? CSS naming conventions refer to a set of recognized laid-down guidelines and best practices that are implemented when naming classes and ids to be used for styles in a CSS code. These guidelines enforce that the names assigned to these classes/ids should be consistent and descriptive, offering a former of organization or hierarchy. This makes the CSS code easily maintainable and readable without the need for many comments stating the intent of the style blocks.

Advantages of Using Well-Defined Naming Conventions in Codebases

Using well-defined naming conventions for CSS classes/ids will provide the following benefits to your workflow:

Code consistency: The naming convention states the rules to be followed when assigning names to CSS properties; this makes the naming style standardized and ensures that all team members follow a similar approach throughout development, producing a more professional and cohesive result.
Readability and understandability: Following CSS naming conventions make it easy for developers to identify at a glance the purpose of a style block, its corresponding components in the code, and its form of association with its children, parent, and sibling elements. This reduces the time spent trying to comprehend the styling structure in the codebase.
Searchability: Using well-defined names makes searching and refactoring CSS code more efficient and time-effective.
Maintainability and scalability: CSS elements can easily be revisited for changes or bug fixes when naming conventions are followed. New features or improvements can be made to existing code without introducing errors.
Reduced bugs and errors: With naming conventions, classes can be declared specific to certain elements and their properties, reducing the occurrence of errors in cases where CSS properties have no clear-cut names, and developers may misuse or misinterpret their purpose. With this, using a CSS naming convention provides an infrastructure for easily understandable, maintainable, and scalable codebases. It promotes collaboration, reducing the occurrence of errors while making for a sustainable and healthy software architecture.

CSS Naming Principles and Best Practices

Having defined the CSS naming convention in the previous section, we will discuss best practices to adhere to when structuring code and guidelines for consistent naming of classes in CSS.

Guiding Principles for Creating Meaningful and Consistent Class Names

Conciseness and cohesiveness: Names assigned to classes should be as concise as possible while still providing the much-needed information on its purpose. Avoid using excessively long names that can be difficult to use or read. Class names should also be cohesive, linking sibling elements or showing the relationship between parent and child elements.
Avoid over-nesting: When assigning names to classes, the naming pattern should be kept shallow, and selectors should not be overly nested. This is to promote readability and make the code easier to maintain.
Consistent casing: The choice of casing for classes should be kept consistent throughout development. Examples of casing include kebab-case (denoted with lower cases and hyphens), camelCase (the initial letter is a low cap, and in the case of multiple words, the consecutive new words have their first letter capitalized), and PascalCase (here, all words that make up the name have their first letter capitalized).
Avoid abbreviations: Avoid using abbreviations except for cases where these abbreviations are widely used and understood. This promotes clarity, allowing the purpose of the class name to be identified at a glance. Popular abbreviations include btn for buttons, nav for navigation bars, and cta for call-to-action components.
Contextual naming: Before assigning names to classes, consider the context in which the element is to be used and the feature/functionality it provides. This provides insight into choosing the best possible names for elements and avoids naming clashes in development.
Consistent naming across project development: Before development, establish a naming convention and guidelines for the project to ensure all team members follow them consistently to provide an easily maintainable and cohesive codebase.
Avoid generic or vague names: Class names should reflect the intention and meaning of the element they are assigned to. It should be a descriptive name that conveys its functions to make it easier to search for and understand.

Best Practices for Structuring CSS Code

To keep your CSS code organized, the following are best practices you should try to adhere to in your codebase:

Modular-based approach: CSS code that may be required multiple times in development to perform a specific task can be made into smaller reusable code blocks to avoid repetition.
Follow a naming convention: Incorporate a CSS naming convention into your workflow to help create structured and descriptive class names.
Separate structure and presentation: When organizing CSS, separate styles associated with the layout and positioning of the element from the other styles covering its presentation (styles associated with colors, fonts, borders, etc.). e.g., a wrapper class may be defined to provide styles for an element max-width and its margins/padding.
Limit usage of !important: The !important behavioral modifier enforces a strict behavior to whatever element it’s applied to and overrides changes. Overused can lead to conflicts, making it difficult to update the existing style as the property with the !important modifier takes preeminence.
Use of comments: Comments help to provide context to code blocks and can be used to explain complex sections or reasons for styling in a particular way. This makes it easier for other developers to understand written code.
Consistent formatting: When structuring code, use proper indentation, spacing, and line breaks to enhance readability. Formatters such as Prettier or Beautify can be incorporated into a code editor to handle code formatting automatically.
Group-related styles: Style blocks associated with related elements should be placed in the stylesheet.
Concise CSS selectors: CSS selectors should not be overly long or deeply nested with complex descendant selectors.
Appropriate selector naming: Selectors should be named specifically to the elements they are applied to. Using vague name selectors will lead to conflicts, style overriding, and unwanted behavior.
Avoid Using IDs for Styling: Using IDs to apply styles can create issues when trying to modify the styles of that component. Rather, you should use IDs as a means of unique identification while styling using CSS classes for easy code maintainability.

Practical Examples of CSS Naming Conventions

This section covers different CSS naming conventions available today, practical applications in real-world scenarios, and examples of its implementation in the form of code snippets.

BEM (Block, Element, Modifier): BEM is a popular CSS naming convention that was developed by Yandex, a Russian tech company, to provide a modular approach to CSS styling, offers code reusability and make maintaining large-scale CSS feasible. BEM is an acronym for Block, Element, and Modifier, and these represent the following principles:
- Block: Blocks are standalone components that may be created during development. These are usually parent/top-level elements that may wrap around child elements. Blocks are denoted using lowercase and hyphens. e.g., .nav, .header, .carousel, .card, etc.
- Element: An element is part of a block that cannot exist independently as it depends on a parent for its definition. It is a child block, prefixed by double underscores (__) to indicate its relationship. Suppose we are building a card component with title, description, and image elements. The code block below shows the application of BEM in naming the classes of these elements:

/* The parent card element */
.card {
 /* styles for the parent component*/
}
/* The children: title, description, image */
.card__title {
 /* styles for the title */
}
.card__description {
 /* styles for the description */
}
.card__image {
 /* styles for the image */
}

Modifiers: Modifiers refer to a modification of the state of a block or element, and they are represented with a double hyphen prefix (—). Modifiers are appended to the block or element name representing a variation of. An example of a modifier is --active to denote the active state of an element/block. The code block below shows the addition of modifiers to the card block defined above:

/* Modifier for dark mode */
.card--dark{
  /* styles for the parent component in dark mode */
}
.card__title--dark {
  /* styles for the title on dark mode */
}

BEM aims at making class names easily identifiable at a glance and also makes it possible to identify where the element can be used and its relationship with other elements. Using BEM, we can also signify when an element is a descendant of a particular class when writing styles in CSS. Suppose a class title is a descendant of another class card, we can style this as shown in the code block below:

.card {
 /* Styles for the card block */
 &__title {
  /* Styles for the title element inside the card block */
 }
}

Namespace Prefixes: The use of Namespace prefixes is a naming convention that involves the addition of a specific prefix to class names to pass across information on its purpose and usage within a project. This helps to provide context about the class names and avoid naming conflicts, as prefixes are unique from others even though they may have similar names. An example implementation of the use of Namespace prefixes is illustrated in the code block below:

/* Styling a home and about us page hero section cta buttons */
.home .cta-button {
 background-color: blanchedalmond;
}
.aboutUs .cta-button {
 background-color: yellow;
}

Suppose we have two cta buttons on the home page; this can be addressed as follows:

<!-- HTML structure -->
<div class="home">
 <button class="cta-a-button">Button A</button>
 <button class="cta-b-button">Button B</button>
</div>

And for the CSS:

/* CSS with namespace prefixes */
.home .cta-a-button {
 background-color: blanchedalmond;
}
.home .cta-b-button {
 background-color: yellow;
}

Atomic CSS: Atomic CSS is a building block implemented in most front-end CSS libraries today, e.g., TailwindCSS. It involves defining small units of single-purpose reusable classes that apply a specific style or property to the element to which it is attached. Example code blocks of Atomic CSS are illustrated below:

/* Atomic CSS for responsive containers */
.container {
 width: 100%;
 max-width: 1280px;
 margin: 0 auto;
}
.container-sm {
 max-width: 768px;
}
/* Atomic CSS property classes */
.mt-2 {
 margin-top: 8px;
}
.px-2 {
 padding-left: 8px;
 padding-right: 8px;
}

These defined classes can then be applied to the required elements:

<div class="container px-2"></div>

Atomic CSS also allows using defined shorthand representation for applying styles to elements. This follows the syntax below:

<!-- Atomic CSS programmatic short forms -->
<!-- syntax:
 shortform(property)
 property is the value to be applied to the specified shortform
 shortform(property):behavior
 behavior could be hover, active, focus, etc.
 shortform(property):behavior--screenSize 
 Screen sizes are lg for large, md for medium, and sm for small
 shortform(property)::pseudo-class
 pseudo-classes can be a for after, b for before, ph for placeholder, etc.
-->
<!-- Example short forms are D for display, C for color, and Bg for background. Applications of these are illustrated below -->
<div class="D(n)"></div>
<!-- The code above sets display to none -->
<p class="C(#333)">hello</p>
<!-- The code above sets the text color to #333 -->
<div class="Bg(transparent):hover--lg"></div>
<!-- The code above applies the property background: transparent; when the div is hovered on in a large screen size -->

SMACSS (Scalable and Modular Architecture for CSS): SMACSS is a CSS naming convention that facilitates easy maintainability by enforcing that CSS code should be split into five major categories:
- Base: In the base category, styles that apply to generic HTML elements, such as the body, div, p, span, etc., are specified here.
- Layout: As the name implies, this section is concerned with organizing code that affects the major layouts of the web application pages. This could be headers and footers, navigation and side menus, etc.
- Module: The module category encapsulates reusable code components or modules, which can be used throughout the project’s development. Examples of such styles can be button styles, card components, etc.
- State: A state category contains behavioral attributes of other class names and can be used to modify their appearance based on specified criteria. This includes styles for handling hover, active, disabled, or hidden elements.
- Theme: This final category deals with using styles for applying color themes to the project. Unlike other naming conventions, SMACSS mainly enforces a logical organizational structure of CSS styles using the five categories discussed above. An example of SMACSS is shown in the code block below:

/* Base styles */
body {
 font-family: monospace;
}
/* Layout styles */
.header {
 color: #fff;
}
/* Module styles */
.button {
 padding: 10px 20px;
 cursor: pointer;
}
/* State styles */
.form-input:focus {
 background-color: #0056b3;
}
/* Theme styles */
.theme-dark {
 background-color: #333;
}

By organizing CSS styles into different categories, CSS codebases are more structured and can be scaled easily, positively impacting readability and code reusability.

Adopting CSS Naming Conventions in Existing Projects

Do you already have an existing project that you wish to scale, and it’s getting more difficult to review and maintain code due to it not following best practices? This section aims to solve this issue by outlining steps to integrate CSS naming conventions into an existing project.

Strategies for Implementing Naming Conventions in Ongoing Projects

Education and training: The first step to implementing a naming convention is to research a naming convention of choice, its usage, and applications. Appropriate documentation and learning materials can be provided to the development team to ensure that all members are onboarded with the principles and rules of the naming convention.
Gradual adoption: Here, the existing code should be gradually refactored in bits to adopt the naming convention rather than trying to change the entire codebase simultaneously. This prevents overwhelming members and reduces the occurrence of errors while facilitating a smooth transition.
Collaboration: In team-built projects, developers should work in groups to incorporate the naming convention. This practice ensures that all team members better understand the application of the naming convention.
Automated CSS linting or formatting: This involves adding an automated plugin that enforces the rules of that naming convention, flagging warnings when there are naming violations, and immediately providing feedback to the development team.
Regular code review: As the naming process is being adopted, there is a need for periodic review of the code to ensure that the naming convention is applied concisely and consistently.
Documenting the naming convention: A style guide stating the type of naming convention, the rules, and example use cases of its application should be added to the codebase. This is for referential purposes and serves as a guide when onboarding new members.
Standardized naming and prefixing: The use of the adopted naming convention (e.g., BEM’s block names or Atomic CSS classes) should be standardized and be the same throughout the project to ensure consistency.

Tools and techniques for refactoring existing CSS code

The following tools/techniques help in the process of refactoring existing code:

Using a version control system such as Git to track changes and facilitate easier rollbacks in the event of abnormal behavior or unwanted changes in the codebase.
Adding code linting and formatting plugins to the codebase to aid code refactoring following the laid down regulations.
Renaming classes incrementally, moving from parent to child elements and siblings. This ensures that you do not disrupt the application, and you can also easily track and manage changes.
Routine testing of code to ensure that it produces the desired results and that there are no unintended side effects to the appearance of the web application.

Conclusion

In front-end development, the importance of clean and efficient coding cannot be overstated. Throughout this article, we’ve explored the impact of clean code on development efficiency and maintainability, as well as the benefits of writing efficient CSS code. One of the fundamental ways to achieve clean and efficient CSS is through the use of well-defined naming conventions. CSS naming conventions play a pivotal role in organizing and structuring codebases, leading to better collaboration, code readability, and maintainability. By adopting meaningful and consistent class names, developers can enhance the clarity of their code and improve its reusability across projects. Developers should be encouraged to integrate CSS naming conventions into their development workflows from the outset. By starting with well-organized and thoughtfully named classes, development teams can build upon a solid foundation, reducing potential bugs and conflicts while promoting a cohesive coding style.

Gain control over your UX

See how users are using your site as if you were sitting next to them, learn and iterate faster with OpenReplay. — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.