Archived

Difference between revisions of "Use a leading space in Page and Module Class Suffix parameters"

From Joomla! Documentation

(Rewording)
Line 1: Line 1:
[[Glossary#Page Class Suffix|Page Class Suffix]] and [[Glossary#Module Class Suffix|Module Class Suffix]] parameters allow you to create new CSS classes in the HTML that Joomla! generates. This in turn allows you to apply individual CSS code to change the appearance of individual Menu Items or Modules.
+
[[Glossary#Page Class Suffix|Page Class Suffix]] and [[Glossary#Module Class Suffix|Module Class Suffix]] parameters allow you to change the CSS classes in the HTML that Joomla! generates. This in turn allows you to apply individual CSS code to change the appearance of individual Menu Items or Modules.
  
You can enter in these parameters with a leading space, for example " myNewClass" (that is, <space> + "myNewClass"). If you enter a Class Suffix with a leading space, Joomla! will create a ''new CSS class'' instead of modifying the existing class. In the previous example, the HTML code for a "componentheading" element would be changed from <pre><div class="componentheading"></pre> to <pre><div class="componentheading myNewClass"></pre>
+
The suffix will be appended to an already provided class, changing it to a different class. To avoid that, you can enter a suffix with a leading space. For example " myNewClass" (that is, <space> + "myNewClass"). If you enter a suffix with a leading space, the default class remains in effect and the one you provided is added. With " myNewClass", the HTML code for a "componentheading" element would be changed from <pre><div class="componentheading"></pre> to <pre><div class="componentheading myNewClass"></pre>
  
Now, this "div" element has two CSS classes assigned to it. The existing styling will still work correctly, since the element still has the "componentheading" class assigned to it. To change the style for this element, you simply add new CSS for the new class.  
+
Now, this "div" element has two CSS classes assigned to it. The existing styling will still work correctly, since the element still has the "componentheading" class assigned to it. To change the style for this element, you simply add new CSS for class "myNewClass".  
  
 
For example, to change the background color for the heading just in this one Menu Item, you could add code something like this to your template's CSS file:
 
For example, to change the background color for the heading just in this one Menu Item, you could add code something like this to your template's CSS file:

Revision as of 08:43, 25 September 2013

This page has been archived. This page contains information for an unsupported Joomla! version or is no longer relevant. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

Page Class Suffix and Module Class Suffix parameters allow you to change the CSS classes in the HTML that Joomla! generates. This in turn allows you to apply individual CSS code to change the appearance of individual Menu Items or Modules.

The suffix will be appended to an already provided class, changing it to a different class. To avoid that, you can enter a suffix with a leading space. For example " myNewClass" (that is, <space> + "myNewClass"). If you enter a suffix with a leading space, the default class remains in effect and the one you provided is added. With " myNewClass", the HTML code for a "componentheading" element would be changed from

<div class="componentheading">

to

<div class="componentheading myNewClass">

Now, this "div" element has two CSS classes assigned to it. The existing styling will still work correctly, since the element still has the "componentheading" class assigned to it. To change the style for this element, you simply add new CSS for class "myNewClass".

For example, to change the background color for the heading just in this one Menu Item, you could add code something like this to your template's CSS file:

.componentheading.myNewClass {
    background-color: #FFE4E1; /* mistyrose */ 
}

Because you are specifying both the "componentheading" and the "myNewClass" in the CSS selector, this style will only be applied to this one element.

One word of caution: make sure your new CSS style name does not duplicate any existing CSS classes! Otherwise, you will get styles applied incorrectly.

See the Using Class Suffixes tutorial for more information.