Actions

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

From Joomla! Documentation

(Change deletion notice to merge notice)
 
(4 intermediate revisions by 2 users not shown)
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.
+
{{merge|Page Class Suffix}}
 +
[[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:
Line 15: Line 16:
 
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.
 
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 [[Tutorial:Using_Class_Suffixes|Using Class Suffixes]] tutorial for more information.
+
See the [[Using_Class_Suffixes|Using Class Suffixes]] for more information.
 
<noinclude>[[Category:Tips and tricks 1.5]]
 
<noinclude>[[Category:Tips and tricks 1.5]]
 
[[Category:Form fields]]
 
[[Category:Form fields]]

Latest revision as of 11:23, 25 September 2013

Merge-icon.png
Merge Notice

It has been suggested that this article or section be merged with Page Class Suffix. (Discuss). Proposed since 12 months ago.

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 for more information.