Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Replacing icons with CSS: Difference between revisions

From MoodleDocs
(Created page with "It is possible to '''replace icons with CSS'''. You can also place alternate icon set files within your theme's folder but this has some drawbacks compared...")
 
(Replaced content with "{{obsolete}} This page text has been deleted because it was inaccurate and out of date. See Using images in a theme for information on replacing images in a theme.")
 
Line 1: Line 1:
It is possible to '''replace icons with CSS'''. You can also place [[Alternate icon set|alternate icon set]] files within your theme's folder but this has some drawbacks compared with the [[CSS]] approach.
{{obsolete}}


* you must use .gif files, which prevents you using alpha transparency available with .pngs
This page text has been deleted because it was inaccurate and out of date. See [[Using images in a theme]] for information on replacing images in a theme.
* you can't send different images to different browsers (e.g. .gifs to IE, .png to everyone else)
* the images must be the same size as the standard icons (in most cases at least), namely 16x16 pixels
* you can't switch images via javascript/mouseover/rollovers/alternate stylesheets etc.
* you can't make the images part of the clickable area of associated links
 
On the other hand, the drawbacks of the CSS approach are:
 
* the old icons are still downloaded, and part of the HTML even though they are not displayed
* it may not work in every case (a more [[Replacing icons with CSS3|complete method using CSS3]] is available but only works in certain, newer browsers)
 
 
 
== How to replace icons with CSS ==
 
=== Removing current icons ===
 
The first step to providing alternative icons via CSS, is to hide the current icons.
 
==== removing sideblock icons ====
 
    .sideblock .c0 {display: none;}
 
==== removing activity and resource icons ====
 
    .activity img.activityicon {display: none;}
 
==== icons that can't currently be replaced ====
 
* course requires enrollment key icon
* course allows guest access icon
 
==== oddities, problems, issues ====
 
* you can't have different icons for each different resource type (e.g. pdf, weblink, text resource)
 
=== Applying new icons ===
 
The next stage is to apply new icons. These will be added as background images, that occupy the left hand side of the associated link tag, with the text moved along to the right.
 
==== adding sideblock icons ====
 
    .sideblock .c1 a {background-repeat: no-repeat; padding-left: 20px;}
 
Then each individual sideblock icon needs to be applied e.g.
 
    <nowiki>.block_course_list .c1 a {background-image: url(http://moodle.org/pix/i/course.gif);}</nowiki>
 
==== adding activity and resource icons ====
 
    td.activity > a {background-repeat: no-repeat; padding-left: 20px;}
 
Then each individual activity icon needs to be applied e.g.
 
    <nowiki>td.activity.glossary > a {background-image: url(http://moodle.org/mod/glossary/icon.gif);}</nowiki>
 
(this code only works on Firefox and other browsers that support child selectors, there is a workaround but it's fairly ugly. I will add this once it is fine tuned)
 
[[Category:Themes]]

Latest revision as of 07:27, 1 December 2016

Warning: This page is no longer in use. The information contained on the page should NOT be seen as relevant or reliable.


This page text has been deleted because it was inaccurate and out of date. See Using images in a theme for information on replacing images in a theme.