×
Namespaces

Variants
Actions
(Difference between revisions)

Simple Web Runtime Design Patterns Using YUI 3

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Automated change of category from Web Runtime (WRT) to Symbian Web Runtime)
hamishwillee (Talk | contribs)
m (Hamishwillee - Bot update - Fix metadata etc)
Line 1: Line 1:
 +
{{ArticleMetaData <!-- v1.2 -->
 +
|sourcecode= [[Media:FadeOut YUI.zip]] [[Media:ExpandCollapse YUI.zip]] [[Media:Slide YUI.zip]] [[Media:Toggle YUI.zip]]
 +
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 +
|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
 +
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
 +
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 +
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 +
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 +
|signing= <!-- Signing requirements - 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= 20091105
 +
|author= [[User:Symbianyucca]]
 +
}}
 
[[Category:Symbian Web Runtime]]
 
[[Category:Symbian Web Runtime]]
 
[[Category:Design]]
 
[[Category:Design]]
[[Category:Mobile_Design]]
+
[[Category:Mobile Design]]
 
[[Category:Code Examples]]
 
[[Category:Code Examples]]
  
Line 42: Line 64:
 
Provide a user or system-initiated trigger to instantly show or hide views or elements within the widget.
 
Provide a user or system-initiated trigger to instantly show or hide views or elements within the widget.
  
[[Image:01-hide.png]]  
+
[[File:01-hide.png]]  
  
 
Figure: This widget has three views yet only one can be active at a time.  
 
Figure: This widget has three views yet only one can be active at a time.  
  
You can use the normal display block/none for the toggling Effect.
+
You can use the normal display block/none for the toggling Effect.
 
<code xml>
 
<code xml>
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
Line 116: Line 138:
 
</code>
 
</code>
  
WRT Widget for the example code can be found from File: [[File:Toggle_YUI.zip|Toggle_YUI.zip]]
+
WRT Widget for the example code can be found from File: [[File:Toggle YUI.zip|Toggle YUI.zip]]
  
 
== 2. Slide transition ==
 
== 2. Slide transition ==
Line 132: Line 154:
 
Create a connection between the original and final view (or state) through use of an animated transition.  
 
Create a connection between the original and final view (or state) through use of an animated transition.  
  
[[Image:02-slide.png]]  
+
[[File:02-slide.png]]  
  
 
'''Figure:''' The slide transition is used to gradually close the content area.
 
'''Figure:''' The slide transition is used to gradually close the content area.
Line 179: Line 201:
 
</code>
 
</code>
  
WRT Widget for the example code can be found from File: [[File:Slide_YUI.zip|Slide_YUI.zip]]
+
WRT Widget for the example code can be found from File: [[File:Slide YUI.zip|Slide YUI.zip]]
  
 
== 3. Fade in/out ==
 
== 3. Fade in/out ==
Line 196: Line 218:
 
Incorporate a transition to gradually fade the visibility of an element into or out of view.
 
Incorporate a transition to gradually fade the visibility of an element into or out of view.
  
[[Image:03-fade.png]]  
+
[[File:03-fade.png]]  
  
 
'''Figure:''' The transition is used to gradually fade out View 1 and fade in View 2.
 
'''Figure:''' The transition is used to gradually fade out View 1 and fade in View 2.
Line 286: Line 308:
 
</code>
 
</code>
  
WRT Widget for the example code can be found from File: [[File:FadeOut_YUI.zip|FadeOut_YUI.zip]]
+
WRT Widget for the example code can be found from File: [[File:FadeOut YUI.zip|FadeOut YUI.zip]]
  
 
Notes: As WRT currently does not support opacity through CSS, the example code does not really work, you could get it working better by adding WRT’s “fade” transition codes into it.
 
Notes: As WRT currently does not support opacity through CSS, the example code does not really work, you could get it working better by adding WRT’s “fade” transition codes into it.
Line 309: Line 331:
 
Hide a portion of this information then provide the user with a means to trigger the reveal of this information when required. This action should be easily discoverable, easy to trigger and the reveal should (ideally) occur in context of the original data.
 
Hide a portion of this information then provide the user with a means to trigger the reveal of this information when required. This action should be easily discoverable, easy to trigger and the reveal should (ideally) occur in context of the original data.
  
[[Image:04-collapse.png ]]
+
[[File:04-collapse.png ]]
  
 
'''Figure:''' The area is expanded to reveal additional content.
 
'''Figure:''' The area is expanded to reveal additional content.
Line 367: Line 389:
 
</code>
 
</code>
  
WRT Widget for the example code can be found from File: [[File:ExpandCollapse_YUI.zip|ExpandCollapse_YUI.zip]]
+
WRT Widget for the example code can be found from File: [[File:ExpandCollapse YUI.zip|ExpandCollapse YUI.zip]]
  
 
''Notes:'' Another way to create expanding and collapsing elements is to hide and show sub-elements causing the display block of the container block to expand and contract as necessary. This method does not typically incorporate animation as a means of transition.
 
''Notes:'' Another way to create expanding and collapsing elements is to hide and show sub-elements causing the display block of the container block to expand and contract as necessary. This method does not typically incorporate animation as a means of transition.

Revision as of 08:43, 7 May 2012

Article Metadata
Code ExampleArticle
Created: symbianyucca (05 Nov 2009)
Last edited: hamishwillee (07 May 2012)

Contents

Simple Web Runtime Design Patterns Using YUI 3

Tip: Also see the Simple Web Runtime Design Patterns Using Dojo

Tip: Also see the Simple Web Runtime Design Patterns Using Mootools

Tip: Also see the Simple Web Runtime Design Patterns Using jQuery

Introduction to design patterns using YUI 3 Design patterns are “known solutions to common design problems”. The following design patterns make use of the YUI version 3 JavaScript™ library and are intended for designers and developers working with Web Runtime (WRT) and the S60 mobile browser.

“YUI 3 is Yahoo!'s next-generation JavaScript and CSS library; it powers the new Yahoo! homepage and incorporates what we've learned in five years of dedicated library development. Today, the YUI 3 Core and a full utility set are ready for use. All YUI projects are BSD-licensed and are available for forking and contribution on GitHub.” developer.yahoo.com

The YUI Library is fully documented on its website; detailed API documentation accompanies the library download. It has six types of components: YUI core, utilities, UI controls, CSS components, developer tools, and build tools. To get started visit the YUI developer page at developer.yahoo.com/yui/3/


Note: The following examples have been tested on the 5th Edition, N97 device. Support for YUI will vary amongst 3rd Edition devices.

1. Show/Hide design pattern

Problem summary A user must interact with multiple views of an application yet only one view can be visible on-screen at a time.

Use

• To switch views within the widget.

• To show and hide elements within a view.

• Within a tabbed interface; to show and hide tabbed views.


Solution Provide a user or system-initiated trigger to instantly show or hide views or elements within the widget.

01-hide.png

Figure: This widget has three views yet only one can be active at a time.

You can use the normal display block/none for the toggling Effect.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title></title>
<script type="text/javascript" src="http://yui.yahooapis.com/3.0.0/build/yui/yui-min.js"></script>
<script type="text/javascript">
 
var myY = null;
 
YUI().use('node', doInit);
 
function showList(){
myY.one('#list').setStyle('display','block');
myY.one('#detail').setStyle('display','none');
}
 
function showDetails(){
myY.one('#detail').setStyle('display','block');
myY.one('#list').setStyle('display','none');
}
 
function showToggle(){
if(myY.one('#detail').getStyle('display') == 'block'){
myY.one('#list').setStyle('display','block');
myY.one('#detail').setStyle('display','none');
}else{
myY.one('#detail').setStyle('display','block');
myY.one('#list').setStyle('display','none');
}
}
 
function doInit(Y){
 
myY = Y;
myY.get('#btn_list').on('click', showList);
myY.get('#btn_detail').on('click', showDetails);
myY.get('#btn_toggle').on('click', showToggle);
 
myY.one('#list').setStyle('display','block');
}
 
</script>
 
<style type="text/css">
div {
height: 5em;
display: none; }
div#list {
background:#f00; }
div#detail {
background:#0f0; }
</style>
</head>
<body>
<button id="btn_list">List</button>
<button id="btn_detail">Detail</button>
<button id="btn_toggle">Toggle</button>
<div id="list">
<h1>List View</h1>
</div>
 
<div id="detail">
<h1>Detail View</h1>
</div>
</body>
</html>

WRT Widget for the example code can be found from File: File:Toggle YUI.zip

2. Slide transition

Problem summary Abrupt changes in view or state are uncomfortable and often disorienting to the user.

Use

• To gradually hide an item within a view.


Solution Create a connection between the original and final view (or state) through use of an animated transition.

02-slide.png

Figure: The slide transition is used to gradually close the content area.


You can Uuse the Y.Anim API for changing the height with timer and easing algorithm to get thi Effect.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title></title>
<script type="text/javascript" src="http://yui.yahooapis.com/3.0.0/build/yui/yui-min.js"></script>
<script type="text/javascript">
 
YUI().use('anim', function(Y) {
 
var anim1 = new Y.Anim({
node: '#slide',
to: { height: 0 },
duration: 2.0,
});
 
var anim2 = new Y.Anim({
node: '#slide',
to: { height: 100 },
duration: 2.0,
});
 
Y.get('#btn_slide').on('click', anim1.run, anim1);
Y.get('#btn_reset').on('click', anim2.run, anim2);
});
</script>
<style type="text/css">
div {
height: 100px;
background: #f00; }
</style>
</head>
<body>
<button id="btn_slide">Slide</button>
<button id="btn_reset">Reset</button>
<div id="slide"></div>
<h1>Slide</h1>
</body>
</html>

WRT Widget for the example code can be found from File: File:Slide YUI.zip

3. Fade in/out

Problem summary Abrupt changes in view are uncomfortable and often disorienting to the user.

Use

• When transitioning between widget views.

• To attract attention to, yet smooth out the loading of new data, images or other media.


Solution Incorporate a transition to gradually fade the visibility of an element into or out of view.

03-fade.png

Figure: The transition is used to gradually fade out View 1 and fade in View 2.

The Y.Anim can again be used for this effect, and instead of working with height we would be working with the opacity.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title></title>
<script type="text/javascript" src="http://yui.yahooapis.com/3.0.0/build/yui/yui-min.js"></script>
<script type="text/javascript">
 
var myY = null;
 
YUI().use('anim', doInit);
 
function doFade(){
 
var listFrom = myY.one('#list').getStyle('opacity');
var detaFrom = myY.one('#detail').getStyle('opacity');
 
myY.animList.set('from',{opacity: listFrom});
myY.animDetail.set('from',{opacity: detaFrom});
 
if(detaFrom < 1){
myY.animList.set('to',{opacity: 0});
myY.animDetail.set('to',{opacity: 1});
}else{
myY.animList.set('to',{opacity: 1});
myY.animDetail.set('to',{opacity: 0});
}
 
myY.animList.run();
myY.animDetail.run();
}
 
function doInit(Y){
 
myY = Y;
 
myY.animList = new Y.Anim({
node: '#list',
from: { opacity: 0 },
to: { opacity: 1 },
duration: 2.0,
});
 
myY.animDetail = new myY.Anim({
node: '#detail',
from: { opacity: 0 },
to: { opacity: 1 },
duration: 2.0,
});
 
myY.get('#btn_fade').on('click', doFade);
}
 
</script>
<style type="text/css">
div {
display: block; }
div#list {
height: 100px;
width: 150px;
position:absolute;
top: 50px;
background:#f00; }
div#detail {
height: 100px;
width: 150px;
position:absolute;
top: 50px;
background:#0f0;
opacity: 0;}
</style>
</head>
<body>
<button id="btn_fade">Fade Transition</button>
<div id="list">
<h1>List View</h1>
</div>
<div id="detail">
<h1>Detail View</h1>
</div>
</body>
</html>

WRT Widget for the example code can be found from File: File:FadeOut YUI.zip

Notes: As WRT currently does not support opacity through CSS, the example code does not really work, you could get it working better by adding WRT’s “fade” transition codes into it.

4. Expand/Collapse

Problem summary Users require access to content or functionality but they only need it under certain circumstances and/or there is insufficient space to provide all of it at all times.

Use

• To reveal or obscure additional content associated with an element.

• Within a messaging application, to temporarily collapse non-critical information such as sender address, date, persons Ccd. etc.

• When needing to view content (i.e. text, images) that is currently represented in a thumbnail view.

• When making content editable. Ex. Expand a text field to allow for more visible content while editing.


Solution Hide a portion of this information then provide the user with a means to trigger the reveal of this information when required. This action should be easily discoverable, easy to trigger and the reveal should (ideally) occur in context of the original data.

04-collapse.png

Figure: The area is expanded to reveal additional content.

This is basically the same effect as the sliding, so the Y.Anim is used again to change the height of the item.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title></title>
<script type="text/javascript" src="http://yui.yahooapis.com/3.0.0/build/yui/yui-min.js"></script>
<script type="text/javascript">
 
YUI().use('anim', function(Y) {
 
var anim1 = new Y.Anim({
node: '#item',
to: { height: 40 },
duration: 2.0,
});
 
var anim2 = new Y.Anim({
node: '#item',
to: { height: 200 },
duration: 2.0,
});
 
Y.get('#btn_collapse').on('click', anim1.run, anim1);
Y.get('#btn_expand').on('click', anim2.run, anim2);
});
</script>
<style type="text/css">
p, h1 {
padding: 0; margin: 0; }
div#item {
height: 40px;
background:#f00;
overflow: hidden; }
div#more {
background:#0f0; }
</style>
</head>
<body>
<button id="btn_expand">Expand</button>
<button id="btn_collapse">Collapse</button>
<div id="item">
<h1>Header</h1>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Maecenas lorem. Duis pellentesque. Cras nec tortor vel lacus fermentum facilisis. Nam id pede eu eros posuere cursus. Mauris dolor ligula, eleifend vitae, aliquam sit amet, bibendum vel, est. Cras sit amet augue sit amet ligula cursus scelerisque.</p>
</div>
<div id="more">
<h1>More...</h1>
</div>
</body>
</html>

WRT Widget for the example code can be found from File: File:ExpandCollapse YUI.zip

Notes: Another way to create expanding and collapsing elements is to hide and show sub-elements causing the display block of the container block to expand and contract as necessary. This method does not typically incorporate animation as a means of transition.

172 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×