×
Namespaces

Variants
Actions
(Difference between revisions)

Customising a Guarana UI checkbox

From Nokia Developer Wiki
Jump to: navigation, search
Forum Nokia KB (Talk | contribs)
hamishwillee (Talk | contribs)
m (Hamishwillee - Add Abstract. Tidy wiki text)
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
+
[[Category:Guarana UI]][[Category:Code Examples]][[Category:Symbian Web Runtime]]
__NOEDITSECTION__
+
{{Abstract|This code example demonstrates how to customise a Guarana UI checkbox.}}
{{CodeSnippet
+
 
|id= 
+
{{ArticleMetaData <!-- v1.2 -->
|platform=
+
|sourcecode= [[Media:customizing a guarana ui checkbox.zip]] [[Media:customizing a guarana ui checkbox.diff.zip]]
|devices=Nokia 5800 XpressMusic
+
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
|category=Web Runtime (WRT)
+
|devices= Nokia 5800 XpressMusic
|subcategory=Guarana UI, UI
+
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
|creationdate=November 27, 2009
+
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
|keywords=
+
|devicecompatability= <!-- Compatible devices (e.g.: All* (must have GPS) ) -->
 +
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 +
|signing= <!-- Empty or one of Self-Signed, DevCert, Manufacturer -->
 +
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 +
|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
 +
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 +
|translated-by= <!-- [[User:XXXX]] -->
 +
|translated-from-title= <!-- Title only -->
 +
|translated-from-id= <!-- Id of translated revision -->
 +
|review-by= <!-- After re-review: [[User:username]] -->
 +
|review-timestamp= <!-- After re-review: YYYYMMDD -->
 +
|update-by= <!-- After significant update: [[User:username]]-->
 +
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 +
|creationdate= 20091127
 +
|author= [[User:Tapla]]
 +
<!-- The following are not in current metadata -->
 +
|id= CS001551
 
}}
 
}}
  
 
==Overview==
 
==Overview==
  
This code snippet demonstrates how to customize a Guarana UI checkbox. You can download the component library from [http://wiki.forum.nokia.com/index.php/Guarana_UI:_a_jQuery-Based_UI_Library_for_Nokia_WRT Forum Nokia]. This snippet assumes that you are familiar with adding the checkbox component on a web page. For more information about this, read the snippet [[Adding a Guarana UI checkbox on a web page]].
+
This snippet assumes that you are familiar with adding the checkbox component on a web page. For more information about this, read the snippet [[Adding a Guarana UI checkbox on a web page]]. You can download the component library from [[Guarana UI: a jQuery-Based UI Library for Nokia WRT]].
 +
 
 +
To replace the checkbox with your own version, first create the graphics that you want to use. After that, replace the file {{Icode|themes/nokia/base/images/checkbox.png}} with your own image file. The original image file contains pictures of the checkbox in four different states: checked and not pushed, checked and pushed, unchecked and not pushed, and unchecked and pushed:
 +
[[File:Guarana checkbox default img.png|none]]
  
To replace the checkbox with your own version, first create the graphics that you want to use. After that, replace the <tt>themes/nokia/base/images/checkbox.png</tt> with your own image file. The original image file contains pictures of the checkbox in four different states: checked and not pushed, checked and pushed, unchecked and not pushed, and unchecked and pushed:<br />
+
To switch between these states when the checkbox is clicked, adjust the background picture with CSS classes as shown here:
[[File:Guarana_checkbox_default_img.png]]<br />
+
The technique used for switching between these states when the checkbox is clicked is to adjust the background picture with the CSS classes. Like this:
+
  
 
<code css>
 
<code css>
Line 25: Line 42:
 
</code>
 
</code>
  
This means that you must customize the CSS file <tt>themes/nokia/base/images/checkbox.css</tt> so that it corresponds to your own image file. For example, if you have created this kind of file:<br />
+
This means that you must customise the CSS file {{Icode|themes/nokia/base/images/checkbox.css}} so that it corresponds to your own image file. For example, if you have created this file:<br />
[[File:Guarana_checkbox_custom_img.png]]<br />
+
[[File:Guarana checkbox custom img.png]]<br />
where the checkbox icon is 34 x 34 pixels, and there are only two states (checked and unchecked) represented, then the customized CSS classes would look like this:
+
where the checkbox icon is 34 x 34 pixels, and there are only two states (checked and unchecked) represented, then the customised CSS classes would look like this:
  
 
<code css>
 
<code css>
Line 56: Line 73:
 
==Postconditions==
 
==Postconditions==
  
The default graphics of a checkbox component are replaced with own graphics and the necessary changes are made to the CSS file.
+
The default graphics of a checkbox component are replaced with your own graphics and the necessary changes are made to the CSS file.
  
 
==See also==
 
==See also==
Line 66: Line 83:
 
This code snippet is part of the stub concept, which means that it has been patched on top of a template application in order to be more useful for developers. The version of the WRT stub application used as a template in this snippet is v1.2.
 
This code snippet is part of the stub concept, which means that it has been patched on top of a template application in order to be more useful for developers. The version of the WRT stub application used as a template in this snippet is v1.2.
  
* The patched, executable application that can be used to test the features described in this snippet is available for download at [[Media:customizing_a_guarana_ui_checkbox.zip]].
+
* The patched, executable application that can be used to test the features described in this snippet is available for download at [[Media:customizing a guarana ui checkbox.zip]].
* You can view all the changes that are required to implement the above-mentioned features (compared to the [[Adding a Guarana UI checkbox on a web page]] snippet). The changes are provided in unified diff and colour-coded diff (HTML) formats in [[Media:customizing_a_guarana_ui_checkbox.diff.zip]].
+
* You can view all the changes that are required to implement the above-mentioned features (compared to the [[Adding a Guarana UI checkbox on a web page]] snippet). The changes are provided in unified diff and colour-coded diff (HTML) formats in [[Media:customizing a guarana ui checkbox.diff.zip]].
 
* For general information on applying the patch, see [[Using Diffs]].
 
* For general information on applying the patch, see [[Using Diffs]].
* For unpatched stub applications, see [[Example stub]].
+
* For unpatched stub applications, see [[Example app stubs with logging framework]].
 
+
[[Category:Web Runtime (WRT)]][[Category:Guarana UI]][[Category:Code Examples]]
+

Latest revision as of 09:19, 5 October 2012

This code example demonstrates how to customise a Guarana UI checkbox.

Article Metadata
Code ExampleTested with
Devices(s): Nokia 5800 XpressMusic
Article
Created: tapla (27 Nov 2009)
Last edited: hamishwillee (05 Oct 2012)

Contents

[edit] Overview

This snippet assumes that you are familiar with adding the checkbox component on a web page. For more information about this, read the snippet Adding a Guarana UI checkbox on a web page. You can download the component library from Guarana UI: a jQuery-Based UI Library for Nokia WRT.

To replace the checkbox with your own version, first create the graphics that you want to use. After that, replace the file themes/nokia/base/images/checkbox.png with your own image file. The original image file contains pictures of the checkbox in four different states: checked and not pushed, checked and pushed, unchecked and not pushed, and unchecked and pushed:

Guarana checkbox default img.png

To switch between these states when the checkbox is clicked, adjust the background picture with CSS classes as shown here:

.nokia-checkbox-unchecked {
background-position: 0 -74px;
}

This means that you must customise the CSS file themes/nokia/base/images/checkbox.css so that it corresponds to your own image file. For example, if you have created this file:
Guarana checkbox custom img.png
where the checkbox icon is 34 x 34 pixels, and there are only two states (checked and unchecked) represented, then the customised CSS classes would look like this:

.nokia-checkbox-icon {
background-image: url(images/checkbox.png);
height: 34px;
width: 34px;
float: left;
}
 
.nokia-checkbox-checked {
background-position: 0px 0;
}
 
.nokia-checkbox-unchecked {
background-position: 0 -34px;
}
 
.nokia-checkbox-pushed .nokia-checkbox-checked {
background-position: 0 0px;
}
 
.nokia-checkbox-pushed .nokia-checkbox-unchecked {
background-position: 0 -34px;
}

[edit] Postconditions

The default graphics of a checkbox component are replaced with your own graphics and the necessary changes are made to the CSS file.

[edit] See also

[edit] Supplementary material

This code snippet is part of the stub concept, which means that it has been patched on top of a template application in order to be more useful for developers. The version of the WRT stub application used as a template in this snippet is v1.2.

This page was last modified on 5 October 2012, at 09:19.
148 page views in the last 30 days.
×