src/cm/media/js/lib/yui/yui3.0.0/examples/attribute/attribute-getset.html
author raph
Mon, 23 Nov 2009 15:14:29 +0100
changeset 0 40c8f766c9b8
permissions -rw-r--r--
import from internal svn r 4007
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     1
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     2
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     3
<html>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     4
<head>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     5
	<title>YUI Library Examples: Attribute: Attribute Getters, Setters and Validators</title>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     6
    <meta http-equiv="content-type" content="text/html; charset=utf-8">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     7
    	<link rel="stylesheet" type="text/css" href="../../assets/yui.css" >
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     8
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     9
<style>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    10
    /*Supplemental CSS for the YUI distribution*/
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    11
    #custom-doc { width: 95%; min-width: 950px; }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    12
    #pagetitle {background-image: url(../../assets/bg_hd.gif);}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    13
/*    #pagetitle h1 {background-image: url(../../assets/title_h_bg.gif);}*/
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    14
</style>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    15
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    16
<link rel="stylesheet" type="text/css" href="../../assets/dpSyntaxHighlighter.css">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    17
<link type="text/css" rel="stylesheet" href="../../build/cssfonts/fonts-min.css" />
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    18
<script type="text/javascript" src="../../build/yui/yui-min.js"></script>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    19
<style type="text/css">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    20
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    21
    #boxParent {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    22
        overflow:hidden;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    23
        background-color:#004c6d;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    24
        height:25em;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    25
        padding:10px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    26
        margin:5px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    27
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    28
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    29
    #boxParent .yui-box p, #attrs p {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    30
        margin:2px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    31
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    32
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    33
    .attrs {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    34
        border:1px solid #000;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    35
        background-color:#cdcdcd;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    36
        margin:5px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    37
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    38
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    39
    .attrs .header {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    40
        font-weight:bold;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    41
        background-color:#aaa;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    42
        padding:5px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    43
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    44
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    45
    .attrs .body {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    46
        padding:10px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    47
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    48
 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    49
    .attrs .body .hints li {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    50
        padding-bottom:10px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    51
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    52
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    53
    .attrs .footer {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    54
        padding:0px 20px 10px 20px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    55
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    56
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    57
    .attrs label {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    58
        font-weight:bold;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    59
        display:block;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    60
        float:left;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    61
        width:4em;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    62
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    63
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    64
    .attrs .hint {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    65
        font-size:85%;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    66
        color: #004c6d;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    67
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    68
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    69
    .attrs .fields {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    70
        border-top:1px solid #aaa;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    71
        padding:10px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    72
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    73
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    74
    .yui-box {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    75
        padding:5px;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    76
        border:1px solid #000;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    77
        width:8em;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    78
        height:8em;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    79
        text-align:center;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    80
        color:#000;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    81
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    82
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    83
    .yui-box .color, .yui-box .coord {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    84
        font-family:courier;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    85
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    86
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    87
</style>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    88
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    89
</head>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    90
<body id="yahoo-com" class=" yui-skin-sam">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    91
<div id="custom-doc" class="yui-t2">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    92
<div id="hd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    93
	<div id="ygunav">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    94
		<p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    95
            <em>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    96
                <a href="http://developer.yahoo.com/yui/3/">YUI 3.x Home</a> <i> - </i>	
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    97
            </em>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    98
		</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    99
		<form action="http://search.yahoo.com/search" id="sitesearchform">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   100
            <input name="vs" type="hidden" value="developer.yahoo.com">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   101
            <input name="vs" type="hidden" value="yuiblog.com">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   102
		    <div id="sitesearch">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   103
		    	<label for="searchinput">Site Search (YDN &amp; YUIBlog): </label>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   104
			    <input type="text" id="searchinput" name="p">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   105
			    <input type="submit" value="Search" id="searchsubmit" class="ygbt">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   106
		    </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   107
		</form>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   108
    </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   109
	<div id="ygma"><a href="../../"><img src="../../assets/logo.gif"  border="0" width="200" height="93"></a></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   110
	<div id="pagetitle"><h1>YUI Library Examples: Attribute: Attribute Getters, Setters and Validators</h1></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   111
</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   112
<div id="bd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   113
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   114
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   115
	<div id="yui-main">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   116
		<div class="yui-b">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   117
		  <div class="yui-ge">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   118
			  <div class="yui-u first example" id="main">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   119
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   120
	<h2>Attribute: Attribute Getters, Setters and Validators</h2>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   121
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   122
	<div id="example" class="promo">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   123
	<div class="example-intro">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   124
	The <a href="attribute-basic.html">"Basic Attribute Configuration" example</a> shows how you can add attributes to a host class, and set up default values for them using the attribute configuration object. This example explores how you can configure <code>setter</code>, <code>getter</code> and <code>validator</code> functions for individual attributes, which can be used to modify or normalize attribute values during get and set invocations, and prevent invalid values from being stored. 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   125
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   126
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   127
	</div>	
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   128
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   129
	<div class="module example-container ">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   130
			<div class="hd exampleHd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   131
			<p class="newWindowButton yui-skin-sam">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   132
                <a href="attribute-getset_clean.html" target="_blank">View example in new window.</a>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   133
            </p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   134
		</div>		<div id="example-canvas" class="bd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   135
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   136
		
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   137
	<!--BEGIN SOURCE CODE FOR EXAMPLE =============================== -->
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   138
	
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   139
	<div id="attrs" class="attrs">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   140
    <div class="header">Enter new values and click the "Set" buttons</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   141
    <div class="body">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   142
        <ul class="hints">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   143
            <li>Try entering valid and invalid values for x, y; or values which attempt to position the box outside it's parent (parent box co-ordinates are displayed next to the text box).</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   144
            <li>Try entering rgb, hex or keyword color values [ <code>rgb(255,0,0)</code>, <code>#ff0000</code>, <code>red</code> ].</li>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   145
        </ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   146
        <div class="fields">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   147
            <p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   148
                <label for="x">x:</label>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   149
                <input type="text" name="x" id="x" />
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   150
                <button type="button" class="action" id="setX">Set</button>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   151
                <span id="xhint" class="hint"></span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   152
            </p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   153
            <p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   154
                <label for="y">y:</label>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   155
                <input type="text" name="y" id="y" />
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   156
                <button type="button" class="action" id="setY">Set</button>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   157
                <span id="yhint" class="hint"></span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   158
            </p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   159
            <p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   160
                <label for="color">color:</label>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   161
                <input type="text" name="color" id="color" />
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   162
                <button type="button" class="action" id="setColor">Set</button>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   163
            </p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   164
        </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   165
    </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   166
    <div class="footer">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   167
        <button type="button" class="action" id="setXY">Set XY</button>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   168
        <button type="button" class="action" id="setAll">Set All</button>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   169
        <button type="button" class="action" id="getAll">Get All</button>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   170
    </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   171
</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   172
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   173
<div id="boxParent"></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   174
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   175
<script type="text/javascript">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   176
// Get a new YUI instance 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   177
YUI({base:"../../build/", timeout: 10000}).use("node", "attribute", function(Y) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   178
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   179
    var boxParent = Y.one("#boxParent");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   180
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   181
    // Setup a custom class with attribute support
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   182
    function Box(cfg) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   183
        this._createNode(cfg);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   184
        
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   185
        // Attribute configuration
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   186
        var attrs = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   187
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   188
            "parent" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   189
                value: null
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   190
            },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   191
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   192
            "x" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   193
                setter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   194
                    // Pass through x value to xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   195
                    this.set("xy", [parseInt(val), this.get("y")]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   196
                },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   197
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   198
                getter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   199
                    // Get x value from xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   200
                    return this.get("xy")[0];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   201
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   202
            },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   203
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   204
            "y" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   205
                setter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   206
                    // Pass through y value to xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   207
                    this.set("xy", [this.get("x"), parseInt(val)]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   208
                },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   209
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   210
                getter: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   211
                    // Get y value from xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   212
                    return this.get("xy")[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   213
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   214
            },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   215
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   216
            "xy" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   217
                // Actual stored xy co-ordinates
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   218
                value: [0, 0],
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   219
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   220
                setter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   221
                    // Constrain XY value to the parent element.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   222
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   223
                    // Returns the constrained xy value, which will
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   224
                    // be the final value stored.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   225
                    return this.constrain(val);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   226
                },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   227
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   228
                validator: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   229
                    // Ensure we only store a valid data value
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   230
                    return (Y.Lang.isArray(val) && val.length == 2 && Y.Lang.isNumber(val[0]) && Y.Lang.isNumber(val[1]));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   231
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   232
            },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   233
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   234
            "color" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   235
                value: "olive",
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   236
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   237
                getter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   238
                    // Always normalize the returned value to 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   239
                    // a hex color value,  even if the stored 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   240
                    // value is a keyword, or an rgb value.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   241
                    if (val) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   242
                        return Y.Color.toHex(val);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   243
                    } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   244
                        return null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   245
                    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   246
                },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   247
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   248
                validator: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   249
                    // Ensure we only store rgb, hex or keyword values.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   250
                    return (Y.Color.re_RGB.test(val) || Y.Color.re_hex.test(val) || Y.Color.KEYWORDS[val]); 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   251
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   252
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   253
        };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   254
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   255
        this.addAttrs(attrs, cfg);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   256
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   257
        this._sync();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   258
        this._bind();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   259
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   260
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   261
    Box.BUFFER = 5;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   262
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   263
    // Create the box node
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   264
    Box.prototype._createNode = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   265
        this._node = Y.Node.create('<div class="yui-box"><p>Positioned Box</p><p class="coord"></p><p class="color">None</p></div>');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   266
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   267
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   268
    // Update rendered state to match the attribute state
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   269
    Box.prototype._sync = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   270
        this._syncParent();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   271
        this._syncXY();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   272
        this._syncColor();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   273
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   274
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   275
    Box.prototype._syncParent = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   276
        this.get("parent").appendChild(this._node);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   277
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   278
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   279
    Box.prototype._syncXY = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   280
        this._node.setXY(this.get("xy"));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   281
        this._node.one("p.coord").set("innerHTML", "[" + this.get("x") + "," + this.get("y") + "]");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   282
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   283
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   284
    Box.prototype._syncColor = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   285
        this._node.setStyle("backgroundColor", this.get("color"));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   286
        this._node.one("p.color").set("innerHTML", this.get("color"));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   287
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   288
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   289
    // Bind listeners for attribute change events
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   290
    Box.prototype._bind = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   291
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   292
        // Reflect any changes in xy, to the rendered Node
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   293
        this.after("xyChange", this._syncXY);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   294
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   295
        // Reflect any changes in color, to the rendered Node
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   296
        // and output the color value received from get
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   297
        this.after("colorChange", this._syncColor);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   298
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   299
        // Append the rendered node to the parent provided
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   300
        this.after("parentChange", this._syncParent);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   301
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   302
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   303
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   304
    // Get min, max unconstrained values for X. Using Math.round to handle FF3's sub-pixel region values
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   305
    Box.prototype.getXConstraints = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   306
        var parentRegion = this.get("parent").get("region");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   307
        return [Math.round(parentRegion.left + Box.BUFFER), Math.round(parentRegion.right - this._node.get("offsetWidth") - Box.BUFFER)];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   308
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   309
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   310
    // Get min, max unconstrained values for Y.  Using Math.round to handle FF3's sub-pixel region values
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   311
    Box.prototype.getYConstraints = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   312
        var parentRegion = this.get("parent").get("region");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   313
        return [Math.round(parentRegion.top + Box.BUFFER), Math.round(parentRegion.bottom - this._node.get("offsetHeight") - Box.BUFFER)];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   314
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   315
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   316
    // Constrain the x,y value provided
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   317
    Box.prototype.constrain = function(val) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   318
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   319
        // If the X value places the box outside it's parent,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   320
        // modify it's value to place the box inside it's parent.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   321
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   322
        var xConstraints = this.getXConstraints();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   323
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   324
        if (val[0] < xConstraints[0]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   325
            val[0] = xConstraints[0];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   326
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   327
            if (val[0] > xConstraints[1]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   328
                val[0] = xConstraints[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   329
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   330
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   331
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   332
        // If the Y value places the box outside it's parent,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   333
        // modify it's value to place the box inside it's parent.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   334
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   335
        var yConstraints = this.getYConstraints();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   336
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   337
        if (val[1] < yConstraints[0]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   338
            val[1] = yConstraints[0];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   339
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   340
            if (val[1] > yConstraints[1]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   341
                val[1] = yConstraints[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   342
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   343
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   344
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   345
        return val;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   346
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   347
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   348
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   349
    Y.augment(Box, Y.Attribute);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   350
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   351
    // ------
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   352
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   353
    // Create a new instance of Box
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   354
    var box = new Box({
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   355
        parent : boxParent 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   356
    });
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   357
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   358
    // Set references to form controls
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   359
    var xTxt = Y.one("#x");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   360
    var yTxt = Y.one("#y");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   361
    var colorTxt = Y.one("#color");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   362
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   363
    var xHint = Y.one("#xhint");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   364
    var yHint = Y.one("#yhint");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   365
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   366
    function getAll() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   367
        xTxt.set("value", box.get("x"));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   368
        yTxt.set("value", box.get("y"));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   369
        colorTxt.set("value", box.get("color"));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   370
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   371
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   372
    // Bind DOM events for Form Controls
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   373
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   374
    // Use event delegation for the action button clicks
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   375
    Y.on("delegate", function(e) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   376
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   377
        // Get Node target from the event object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   378
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   379
        // We already know it's a button which has an action because
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   380
        // of our selector (button.action), so all we need to do is 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   381
        // route it based on the id.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   382
        var id = e.currentTarget.get("id");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   383
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   384
        switch (id) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   385
            case "setXY":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   386
                box.set("xy", [parseInt(xTxt.get("value")), parseInt(yTxt.get("value"))]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   387
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   388
            case "setX":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   389
                box.set("x", parseInt(xTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   390
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   391
            case "setY":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   392
                box.set("y", parseInt(yTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   393
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   394
            case "setColor":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   395
                box.set("color", Y.Lang.trim(colorTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   396
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   397
            case "setAll":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   398
                box.set("xy", [parseInt(xTxt.get("value")), parseInt(yTxt.get("value"))]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   399
                box.set("color", Y.Lang.trim(colorTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   400
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   401
            case "getAll":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   402
                getAll();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   403
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   404
            default:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   405
                break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   406
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   407
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   408
    }, "#attrs", "click", "button.action");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   409
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   410
    // Bind listeners to provide min, max unconstrained value hints for x, y
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   411
    // (focus/blur doesn't bubble, so bind individual listeners)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   412
    Y.on("focus", function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   413
        var minmax = box.getXConstraints();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   414
        xHint.set("innerHTML", "Valid values: " + minmax[0] + " to " + minmax[1]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   415
    }, xTxt);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   416
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   417
    Y.on("focus", function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   418
        var minmax = box.getYConstraints();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   419
        yHint.set("innerHTML", "Valid values: " + minmax[0] + " to " + minmax[1]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   420
    }, yTxt);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   421
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   422
    Y.on("blur", function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   423
        xHint.set("innerHTML", "");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   424
    }, xTxt);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   425
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   426
    Y.on("blur", function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   427
        yHint.set("innerHTML", "");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   428
    }, yTxt);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   429
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   430
    getAll();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   431
});
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   432
</script>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   433
	
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   434
	<!--END SOURCE CODE FOR EXAMPLE =============================== -->
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   435
	
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   436
		
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   437
		</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   438
	</div>			
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   439
	</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   440
		
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   441
	<h3>Getter, Setter And Validator Functions</h3>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   442
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   443
<p>Attribute lets you configure <code>getter</code> and <code>setter</code> functions for each attribute. These functions are invoked when the user calls Attribute's <code>get</code> and <code>set</code> methods, and provide a way to modify the value returned or the value stored respectively.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   444
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   445
<p>You can also define a <code>validator</code> function for each attribute, which is used to validate the final value before it gets stored.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   446
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   447
<p>All these functions receive the value and name of the attribute being set or retrieved, as shown in the example code below. The name is not used in this example, but is provided to support use cases where you may wish to share the same function between different attributes.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   448
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   449
<h4>Creating The Box Class - The X, Y And XY Attributes</h4>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   450
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   451
<p>In this example, we'll set up a custom <code>Box</code> class representing a positionable element, with <code>x</code>, <code>y</code> and <code>xy</code> attributes.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   452
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   453
<p>Only the <code>xy</code> attribute will actually store the page co-ordinate position of the box. The <code>x</code> and <code>y</code> attributes provide the user a convenient way to set only one of the co-ordinates. 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   454
However we don't want to store the actual values in the <code>x</code> and <code>y</code> attributes, to avoid having to constantly synchronize all three. 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   455
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   456
The <code>getter</code> and <code>setter</code> functions provide us with an easy way to achieve this. We'll define <code>getter</code> and <code>setter</code> functions for both the <code>x</code> and <code>y</code> attributes, which simply pass through to the <code>xy</code> attribute to store and retrieve values:</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   457
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   458
<div id="syntax1" class="yui-syntax-highlight"><div class="numbers"><pre class="javascript" style="font-family:monospace;"><ol><li class="li1"><div class="de1"><span class="co1">// Setup a custom class with attribute support</span></div></li><li class="li1"><div class="de1"><span class="kw2">function</span> Box<span class="br0">&#40;</span>cfg<span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    ...</div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="co1">// Attribute configuration</span></div></li><li class="li1"><div class="de1">    <span class="kw2">var</span> attrs <span class="sy0">=</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">        <span class="st0">&quot;parent&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span></div></li><li class="li2"><div class="de2">            value<span class="sy0">:</span> <span class="kw2">null</span></div></li><li class="li1"><div class="de1">        <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">        <span class="st0">&quot;x&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">            setter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li2"><div class="de2">                <span class="co1">// Pass through x value to xy</span></div></li><li class="li1"><div class="de1">                <span class="kw1">this</span>.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span>parseInt<span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="sy0">,</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;y&quot;</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">            getter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li2"><div class="de2">                <span class="co1">// Get x value from xy</span></div></li><li class="li1"><div class="de1">                <span class="kw1">return</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="br0">&#41;</span><span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="br0">&#125;</span></div></li><li class="li1"><div class="de1">        <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li2"><div class="de2">        <span class="st0">&quot;y&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">            setter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">                <span class="co1">// Pass through y value to xy</span></div></li><li class="li1"><div class="de1">                <span class="kw1">this</span>.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span><span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;x&quot;</span><span class="br0">&#41;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">            getter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">                <span class="co1">// Get y value from xy</span></div></li><li class="li1"><div class="de1">                <span class="kw1">return</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="br0">&#41;</span><span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="br0">&#125;</span></div></li><li class="li2"><div class="de2">        <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">        <span class="st0">&quot;xy&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">            <span class="co1">// Actual stored xy co-ordinates</span></div></li><li class="li1"><div class="de1">            value<span class="sy0">:</span> <span class="br0">&#91;</span><span class="nu0">0</span><span class="sy0">,</span> <span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">,</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">            setter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">                <span class="co1">// Constrain XY value to the parent element.</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">                <span class="co1">// Returns the constrained xy value, which will</span></div></li><li class="li2"><div class="de2">                <span class="co1">// be the final value stored.</span></div></li><li class="li1"><div class="de1">                <span class="kw1">return</span> <span class="kw1">this</span>.<span class="me1">constrain</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">            validator<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li2"><div class="de2">                <span class="co1">// Ensure we only store a valid data value</span></div></li><li class="li1"><div class="de1">                <span class="kw1">return</span> <span class="br0">&#40;</span>Y.<span class="me1">Lang</span>.<span class="me1">isArray</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="sy0">&amp;&amp;</span> </div></li><li class="li1"><div class="de1">                        val.<span class="me1">length</span> <span class="sy0">==</span> <span class="nu0">2</span> <span class="sy0">&amp;&amp;</span> </div></li><li class="li1"><div class="de1">                        Y.<span class="me1">Lang</span>.<span class="me1">isNumber</span><span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="sy0">&amp;&amp;</span> Y.<span class="me1">Lang</span>.<span class="me1">isNumber</span><span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="br0">&#125;</span></div></li><li class="li2"><div class="de2">        <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    ...</div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="kw1">this</span>.<span class="me1">addAttrs</span><span class="br0">&#40;</span>attrs<span class="sy0">,</span> cfg<span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">    ...</div></li><li class="li1"><div class="de1"><span class="br0">&#125;</span></div></li></ol></pre></div><div class="nonumbers"><pre class="javascript" style="font-family:monospace;"><span class="co1">// Setup a custom class with attribute support</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   459
<span class="kw2">function</span> Box<span class="br0">&#40;</span>cfg<span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   460
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   461
    ...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   462
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   463
    <span class="co1">// Attribute configuration</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   464
    <span class="kw2">var</span> attrs <span class="sy0">=</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   465
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   466
        <span class="st0">&quot;parent&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   467
            value<span class="sy0">:</span> <span class="kw2">null</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   468
        <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   469
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   470
        <span class="st0">&quot;x&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   471
            setter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   472
                <span class="co1">// Pass through x value to xy</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   473
                <span class="kw1">this</span>.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span>parseInt<span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="sy0">,</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;y&quot;</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   474
            <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   475
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   476
            getter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   477
                <span class="co1">// Get x value from xy</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   478
                <span class="kw1">return</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="br0">&#41;</span><span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   479
            <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   480
        <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   481
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   482
        <span class="st0">&quot;y&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   483
            setter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   484
                <span class="co1">// Pass through y value to xy</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   485
                <span class="kw1">this</span>.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span><span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;x&quot;</span><span class="br0">&#41;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   486
            <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   487
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   488
            getter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   489
                <span class="co1">// Get y value from xy</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   490
                <span class="kw1">return</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="br0">&#41;</span><span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   491
            <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   492
        <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   493
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   494
        <span class="st0">&quot;xy&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   495
            <span class="co1">// Actual stored xy co-ordinates</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   496
            value<span class="sy0">:</span> <span class="br0">&#91;</span><span class="nu0">0</span><span class="sy0">,</span> <span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   497
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   498
            setter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   499
                <span class="co1">// Constrain XY value to the parent element.</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   500
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   501
                <span class="co1">// Returns the constrained xy value, which will</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   502
                <span class="co1">// be the final value stored.</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   503
                <span class="kw1">return</span> <span class="kw1">this</span>.<span class="me1">constrain</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   504
            <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   505
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   506
            validator<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   507
                <span class="co1">// Ensure we only store a valid data value</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   508
                <span class="kw1">return</span> <span class="br0">&#40;</span>Y.<span class="me1">Lang</span>.<span class="me1">isArray</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="sy0">&amp;&amp;</span> 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   509
                        val.<span class="me1">length</span> <span class="sy0">==</span> <span class="nu0">2</span> <span class="sy0">&amp;&amp;</span> 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   510
                        Y.<span class="me1">Lang</span>.<span class="me1">isNumber</span><span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="sy0">&amp;&amp;</span> Y.<span class="me1">Lang</span>.<span class="me1">isNumber</span><span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   511
            <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   512
        <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   513
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   514
    ...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   515
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   516
    <span class="kw1">this</span>.<span class="me1">addAttrs</span><span class="br0">&#40;</span>attrs<span class="sy0">,</span> cfg<span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   517
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   518
    ...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   519
<span class="br0">&#125;</span></pre></div><textarea id="syntax1-plain">// Setup a custom class with attribute support
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   520
function Box(cfg) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   521
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   522
    ...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   523
          
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   524
    // Attribute configuration
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   525
    var attrs = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   526
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   527
        "parent" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   528
            value: null
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   529
        },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   530
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   531
        "x" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   532
            setter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   533
                // Pass through x value to xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   534
                this.set("xy", [parseInt(val), this.get("y")]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   535
            },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   536
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   537
            getter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   538
                // Get x value from xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   539
                return this.get("xy")[0];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   540
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   541
        },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   542
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   543
        "y" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   544
            setter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   545
                // Pass through y value to xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   546
                this.set("xy", [this.get("x"), parseInt(val)]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   547
            },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   548
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   549
            getter: function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   550
                // Get y value from xy
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   551
                return this.get("xy")[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   552
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   553
        },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   554
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   555
        "xy" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   556
            // Actual stored xy co-ordinates
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   557
            value: [0, 0],
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   558
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   559
            setter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   560
                // Constrain XY value to the parent element.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   561
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   562
                // Returns the constrained xy value, which will
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   563
                // be the final value stored.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   564
                return this.constrain(val);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   565
            },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   566
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   567
            validator: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   568
                // Ensure we only store a valid data value
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   569
                return (Y.Lang.isArray(val) && 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   570
                        val.length == 2 && 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   571
                        Y.Lang.isNumber(val[0]) && Y.Lang.isNumber(val[1]));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   572
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   573
        },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   574
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   575
    ...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   576
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   577
    this.addAttrs(attrs, cfg);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   578
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   579
    ...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   580
}</textarea></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   581
<p>The <code>validator</code> function for <code>xy</code> ensures that only valid values finally end up being stored.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   582
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   583
<p>The <code>xy</code> attribute also has a <code>setter</code> function configured, which makes sure that the box is always constrained to it's parent element. The <code>constrain</code> method which it delegates to, takes the xy value the user is trying to set and returns a constrained value if the x or y values fall outside the parent box. The value which is returned by the <code>setter</code> is the value which is ultimately stored for the <code>xy</code> attribute:</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   584
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   585
<div id="syntax2" class="yui-syntax-highlight"><div class="numbers"><pre class="javascript" style="font-family:monospace;"><ol><li class="li1"><div class="de1"><span class="co1">// Get min, max unconstrained values for X. </span></div></li><li class="li1"><div class="de1"><span class="co1">// Using Math.round to handle FF3's sub-pixel region values</span></div></li><li class="li1"><div class="de1">Box.<span class="me1">prototype</span>.<span class="me1">getXConstraints</span> <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">    <span class="kw2">var</span> parentRegion <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;parent&quot;</span><span class="br0">&#41;</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;region&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">    <span class="kw1">return</span> <span class="br0">&#91;</span>Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">left</span> <span class="sy0">+</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="sy0">,</span> </div></li><li class="li1"><div class="de1">            Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">right</span> <span class="sy0">-</span> <span class="kw1">this</span>._node.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;offsetWidth&quot;</span><span class="br0">&#41;</span> <span class="sy0">-</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1"><span class="br0">&#125;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1"><span class="co1">// Get min, max unconstrained values for Y.  </span></div></li><li class="li2"><div class="de2"><span class="co1">// Using Math.round to handle FF3's sub-pixel region values</span></div></li><li class="li1"><div class="de1">Box.<span class="me1">prototype</span>.<span class="me1">getYConstraints</span> <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">    <span class="kw2">var</span> parentRegion <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;parent&quot;</span><span class="br0">&#41;</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;region&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">    <span class="kw1">return</span> <span class="br0">&#91;</span>Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">top</span> <span class="sy0">+</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="sy0">,</span> </div></li><li class="li1"><div class="de1">            Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">bottom</span> <span class="sy0">-</span> <span class="kw1">this</span>._node.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;offsetHeight&quot;</span><span class="br0">&#41;</span> <span class="sy0">-</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2"><span class="br0">&#125;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1"><span class="co1">// Constrains given x,y values</span></div></li><li class="li1"><div class="de1">Box.<span class="me1">prototype</span>.<span class="me1">constrain</span> <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li2"><div class="de2">    <span class="co1">// If the X value places the box outside it's parent,</span></div></li><li class="li1"><div class="de1">    <span class="co1">// modify it's value to place the box inside it's parent.</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="kw2">var</span> xConstraints <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">getXConstraints</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li2"><div class="de2">    <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">&lt;</span> xConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">        val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">=</span> xConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">    <span class="br0">&#125;</span> <span class="kw1">else</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">&gt;</span> xConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">            val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">=</span> xConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">        <span class="br0">&#125;</span></div></li><li class="li1"><div class="de1">    <span class="br0">&#125;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="co1">// If the Y value places the box outside it's parent,</span></div></li><li class="li1"><div class="de1">    <span class="co1">// modify it's value to place the box inside it's parent.</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="kw2">var</span> yConstraints <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">getYConstraints</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">&lt;</span> yConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">        val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">=</span> yConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">    <span class="br0">&#125;</span> <span class="kw1">else</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">&gt;</span> yConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">            val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">=</span> yConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">        <span class="br0">&#125;</span></div></li><li class="li1"><div class="de1">    <span class="br0">&#125;</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="kw1">return</span> val<span class="sy0">;</span></div></li><li class="li1"><div class="de1"><span class="br0">&#125;</span><span class="sy0">;</span></div></li></ol></pre></div><div class="nonumbers"><pre class="javascript" style="font-family:monospace;"><span class="co1">// Get min, max unconstrained values for X. </span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   586
<span class="co1">// Using Math.round to handle FF3's sub-pixel region values</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   587
Box.<span class="me1">prototype</span>.<span class="me1">getXConstraints</span> <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   588
    <span class="kw2">var</span> parentRegion <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;parent&quot;</span><span class="br0">&#41;</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;region&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   589
    <span class="kw1">return</span> <span class="br0">&#91;</span>Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">left</span> <span class="sy0">+</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="sy0">,</span> 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   590
            Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">right</span> <span class="sy0">-</span> <span class="kw1">this</span>._node.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;offsetWidth&quot;</span><span class="br0">&#41;</span> <span class="sy0">-</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   591
<span class="br0">&#125;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   592
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   593
<span class="co1">// Get min, max unconstrained values for Y.  </span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   594
<span class="co1">// Using Math.round to handle FF3's sub-pixel region values</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   595
Box.<span class="me1">prototype</span>.<span class="me1">getYConstraints</span> <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   596
    <span class="kw2">var</span> parentRegion <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;parent&quot;</span><span class="br0">&#41;</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;region&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   597
    <span class="kw1">return</span> <span class="br0">&#91;</span>Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">top</span> <span class="sy0">+</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="sy0">,</span> 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   598
            Math.<span class="me1">round</span><span class="br0">&#40;</span>parentRegion.<span class="me1">bottom</span> <span class="sy0">-</span> <span class="kw1">this</span>._node.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;offsetHeight&quot;</span><span class="br0">&#41;</span> <span class="sy0">-</span> Box.<span class="me1">BUFFER</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   599
<span class="br0">&#125;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   600
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   601
<span class="co1">// Constrains given x,y values</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   602
Box.<span class="me1">prototype</span>.<span class="me1">constrain</span> <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   603
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   604
    <span class="co1">// If the X value places the box outside it's parent,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   605
    <span class="co1">// modify it's value to place the box inside it's parent.</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   606
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   607
    <span class="kw2">var</span> xConstraints <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">getXConstraints</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   608
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   609
    <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">&lt;</span> xConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   610
        val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">=</span> xConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   611
    <span class="br0">&#125;</span> <span class="kw1">else</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   612
        <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">&gt;</span> xConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   613
            val<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span> <span class="sy0">=</span> xConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   614
        <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   615
    <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   616
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   617
    <span class="co1">// If the Y value places the box outside it's parent,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   618
    <span class="co1">// modify it's value to place the box inside it's parent.</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   619
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   620
    <span class="kw2">var</span> yConstraints <span class="sy0">=</span> <span class="kw1">this</span>.<span class="me1">getYConstraints</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   621
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   622
    <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">&lt;</span> yConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   623
        val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">=</span> yConstraints<span class="br0">&#91;</span><span class="nu0">0</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   624
    <span class="br0">&#125;</span> <span class="kw1">else</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   625
        <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">&gt;</span> yConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   626
            val<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span> <span class="sy0">=</span> yConstraints<span class="br0">&#91;</span><span class="nu0">1</span><span class="br0">&#93;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   627
        <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   628
    <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   629
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   630
    <span class="kw1">return</span> val<span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   631
<span class="br0">&#125;</span><span class="sy0">;</span></pre></div><textarea id="syntax2-plain">// Get min, max unconstrained values for X. 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   632
// Using Math.round to handle FF3's sub-pixel region values
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   633
Box.prototype.getXConstraints = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   634
    var parentRegion = this.get("parent").get("region");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   635
    return [Math.round(parentRegion.left + Box.BUFFER), 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   636
            Math.round(parentRegion.right - this._node.get("offsetWidth") - Box.BUFFER)];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   637
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   638
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   639
// Get min, max unconstrained values for Y.  
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   640
// Using Math.round to handle FF3's sub-pixel region values
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   641
Box.prototype.getYConstraints = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   642
    var parentRegion = this.get("parent").get("region");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   643
    return [Math.round(parentRegion.top + Box.BUFFER), 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   644
            Math.round(parentRegion.bottom - this._node.get("offsetHeight") - Box.BUFFER)];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   645
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   646
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   647
// Constrains given x,y values
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   648
Box.prototype.constrain = function(val) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   649
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   650
    // If the X value places the box outside it's parent,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   651
    // modify it's value to place the box inside it's parent.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   652
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   653
    var xConstraints = this.getXConstraints();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   654
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   655
    if (val[0] < xConstraints[0]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   656
        val[0] = xConstraints[0];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   657
    } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   658
        if (val[0] > xConstraints[1]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   659
            val[0] = xConstraints[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   660
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   661
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   662
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   663
    // If the Y value places the box outside it's parent,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   664
    // modify it's value to place the box inside it's parent.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   665
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   666
    var yConstraints = this.getYConstraints();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   667
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   668
    if (val[1] < yConstraints[0]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   669
        val[1] = yConstraints[0];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   670
    } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   671
        if (val[1] > yConstraints[1]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   672
            val[1] = yConstraints[1];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   673
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   674
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   675
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   676
    return val;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   677
};</textarea></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   678
<p>The <code>setter</code>, <code>getter</code> and <code>validator</code> functions are invoked with the host object as the context, so that they can refer to the host object using "<code>this</code>", as we see in the <code>setter</code> function for <code>xy</code>.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   679
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   680
<h4>The Color Attribute - Normalizing Stored Values Through Get</h4>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   681
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   682
<p>The <code>Box</code> class also has a <code>color</code> attribute which also has a <code>getter</code> and <code>validator</code> functions defined:</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   683
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   684
<div id="syntax3" class="yui-syntax-highlight"><div class="numbers"><pre class="javascript" style="font-family:monospace;"><ol><li class="li1"><div class="de1">...</div></li><li class="li1"><div class="de1"><span class="st0">&quot;color&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">    value<span class="sy0">:</span> <span class="st0">&quot;olive&quot;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li2"><div class="de2">    getter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">            <span class="kw1">return</span> Y.<span class="me1">Color</span>.<span class="me1">toHex</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">        <span class="br0">&#125;</span> <span class="kw1">else</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">            <span class="kw1">return</span> <span class="kw2">null</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">        <span class="br0">&#125;</span></div></li><li class="li1"><div class="de1">    <span class="br0">&#125;</span><span class="sy0">,</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    validator<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">return</span> <span class="br0">&#40;</span>Y.<span class="me1">Color</span>.<span class="me1">re_RGB</span>.<span class="me1">test</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="sy0">||</span> Y.<span class="me1">Color</span>.<span class="me1">re_hex</span>.<span class="me1">test</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> </div></li><li class="li2"><div class="de2">                    <span class="sy0">||</span> Y.<span class="me1">Color</span>.<span class="me1">KEYWORDS</span><span class="br0">&#91;</span>val<span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">    <span class="br0">&#125;</span></div></li><li class="li1"><div class="de1"><span class="br0">&#125;</span></div></li><li class="li1"><div class="de1">...</div></li></ol></pre></div><div class="nonumbers"><pre class="javascript" style="font-family:monospace;">...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   685
<span class="st0">&quot;color&quot;</span> <span class="sy0">:</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   686
    value<span class="sy0">:</span> <span class="st0">&quot;olive&quot;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   687
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   688
    getter<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   689
        <span class="kw1">if</span> <span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   690
            <span class="kw1">return</span> Y.<span class="me1">Color</span>.<span class="me1">toHex</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   691
        <span class="br0">&#125;</span> <span class="kw1">else</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   692
            <span class="kw1">return</span> <span class="kw2">null</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   693
        <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   694
    <span class="br0">&#125;</span><span class="sy0">,</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   695
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   696
    validator<span class="sy0">:</span> <span class="kw2">function</span><span class="br0">&#40;</span>val<span class="sy0">,</span> <span class="kw3">name</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   697
        <span class="kw1">return</span> <span class="br0">&#40;</span>Y.<span class="me1">Color</span>.<span class="me1">re_RGB</span>.<span class="me1">test</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> <span class="sy0">||</span> Y.<span class="me1">Color</span>.<span class="me1">re_hex</span>.<span class="me1">test</span><span class="br0">&#40;</span>val<span class="br0">&#41;</span> 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   698
                    <span class="sy0">||</span> Y.<span class="me1">Color</span>.<span class="me1">KEYWORDS</span><span class="br0">&#91;</span>val<span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   699
    <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   700
<span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   701
...</pre></div><textarea id="syntax3-plain">...
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   702
"color" : {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   703
    value: "olive",
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   704
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   705
    getter: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   706
        if (val) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   707
            return Y.Color.toHex(val);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   708
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   709
            return null;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   710
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   711
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   712
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   713
    validator: function(val, name) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   714
        return (Y.Color.re_RGB.test(val) || Y.Color.re_hex.test(val) 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   715
                    || Y.Color.KEYWORDS[val]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   716
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   717
}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   718
...</textarea></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   719
<p>The role of the <code>getter</code> handler in this case is to normalize the actual stored value of the <code>color</code> attribute, so that users always receive the hex value, regardless of the actual value stored, which maybe a color keyword (e.g. <code>"red"</code>), an rgb value (e.g.<code>rbg(255,0,0)</code>), or a hex value (<code>#ff0000</code>). The <code>validator</code> ensures the the stored value is one of these three formats.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   720
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   721
<h4>Syncing Changes Using Attribute Change Events</h4>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   722
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   723
<p>Another interesting aspect of this example, is it's use of attribute change events to listen for changes to the attribute values. <code>Box</code>'s <code>_bind</code> method configures a set of attribute change event listeners which monitor changes to the <code>xy</code>, <code>color</code> and <code>parent</code> attributes and update the rendered DOM for the Box in response:</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   724
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   725
<div id="syntax4" class="yui-syntax-highlight"><div class="numbers"><pre class="javascript" style="font-family:monospace;"><ol><li class="li1"><div class="de1"><span class="co1">// Bind listeners for attribute change events</span></div></li><li class="li1"><div class="de1">Box.<span class="me1">prototype</span>._bind <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="co1">// Reflect any changes in xy, to the rendered Node</span></div></li><li class="li2"><div class="de2">    <span class="kw1">this</span>.<span class="me1">after</span><span class="br0">&#40;</span><span class="st0">&quot;xyChange&quot;</span><span class="sy0">,</span> <span class="kw1">this</span>._syncXY<span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="co1">// Reflect any changes in color, to the rendered Node</span></div></li><li class="li1"><div class="de1">    <span class="co1">// and output the color value received from get</span></div></li><li class="li1"><div class="de1">    <span class="kw1">this</span>.<span class="me1">after</span><span class="br0">&#40;</span><span class="st0">&quot;colorChange&quot;</span><span class="sy0">,</span> <span class="kw1">this</span>._syncColor<span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="co1">// Append the rendered node to the parent provided</span></div></li><li class="li1"><div class="de1">    <span class="kw1">this</span>.<span class="me1">after</span><span class="br0">&#40;</span><span class="st0">&quot;parentChange&quot;</span><span class="sy0">,</span> <span class="kw1">this</span>._syncParent<span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1"><span class="br0">&#125;</span><span class="sy0">;</span></div></li></ol></pre></div><div class="nonumbers"><pre class="javascript" style="font-family:monospace;"><span class="co1">// Bind listeners for attribute change events</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   726
Box.<span class="me1">prototype</span>._bind <span class="sy0">=</span> <span class="kw2">function</span><span class="br0">&#40;</span><span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   727
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   728
    <span class="co1">// Reflect any changes in xy, to the rendered Node</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   729
    <span class="kw1">this</span>.<span class="me1">after</span><span class="br0">&#40;</span><span class="st0">&quot;xyChange&quot;</span><span class="sy0">,</span> <span class="kw1">this</span>._syncXY<span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   730
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   731
    <span class="co1">// Reflect any changes in color, to the rendered Node</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   732
    <span class="co1">// and output the color value received from get</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   733
    <span class="kw1">this</span>.<span class="me1">after</span><span class="br0">&#40;</span><span class="st0">&quot;colorChange&quot;</span><span class="sy0">,</span> <span class="kw1">this</span>._syncColor<span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   734
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   735
    <span class="co1">// Append the rendered node to the parent provided</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   736
    <span class="kw1">this</span>.<span class="me1">after</span><span class="br0">&#40;</span><span class="st0">&quot;parentChange&quot;</span><span class="sy0">,</span> <span class="kw1">this</span>._syncParent<span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   737
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   738
<span class="br0">&#125;</span><span class="sy0">;</span></pre></div><textarea id="syntax4-plain">// Bind listeners for attribute change events
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   739
Box.prototype._bind = function() {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   740
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   741
    // Reflect any changes in xy, to the rendered Node
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   742
    this.after("xyChange", this._syncXY);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   743
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   744
    // Reflect any changes in color, to the rendered Node
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   745
    // and output the color value received from get
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   746
    this.after("colorChange", this._syncColor);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   747
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   748
    // Append the rendered node to the parent provided
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   749
    this.after("parentChange", this._syncParent);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   750
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   751
};</textarea></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   752
<p>Since only <code>xy</code> stores the final co-ordinates, we don't need to monitor the <code>x</code> and <code>y</code> attributes individually for changes.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   753
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   754
<h4>DOM Event Listeners And Delegation</h4>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   755
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   756
<p>Although not an integral part of the example, it's worth highlighting the code which is used to setup the DOM event listeners for the form elements used by the example:</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   757
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   758
<div id="syntax5" class="yui-syntax-highlight"><div class="numbers"><pre class="javascript" style="font-family:monospace;"><ol><li class="li1"><div class="de1"><span class="co1">// Set references to form controls</span></div></li><li class="li1"><div class="de1"><span class="kw2">var</span> xTxt <span class="sy0">=</span> Y.<span class="me1">one</span><span class="br0">&#40;</span><span class="st0">&quot;#x&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1"><span class="kw2">var</span> yTxt <span class="sy0">=</span> Y.<span class="me1">one</span><span class="br0">&#40;</span><span class="st0">&quot;#y&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1"><span class="kw2">var</span> colorTxt <span class="sy0">=</span> Y.<span class="me1">one</span><span class="br0">&#40;</span><span class="st0">&quot;#color&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1"><span class="co1">// Use event delegation for the action button clicks</span></div></li><li class="li1"><div class="de1">Y.<span class="me1">on</span><span class="br0">&#40;</span><span class="st0">&quot;delegate&quot;</span><span class="sy0">,</span> <span class="kw2">function</span><span class="br0">&#40;</span>e<span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="co1">// Get Node target from the event object. </span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="co1">// We already know it's a button which has an action because</span></div></li><li class="li1"><div class="de1">    <span class="co1">// of our selector (button.action), so all we need to do is </span></div></li><li class="li1"><div class="de1">    <span class="co1">// route it based on the id.</span></div></li><li class="li1"><div class="de1">    <span class="kw2">var</span> id <span class="sy0">=</span> e.<span class="me1">currentTarget</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;id&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">&nbsp;</div></li><li class="li1"><div class="de1">    <span class="kw1">switch</span> <span class="br0">&#40;</span>id<span class="br0">&#41;</span> <span class="br0">&#123;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">case</span> <span class="st0">&quot;setXY&quot;</span><span class="sy0">:</span></div></li><li class="li1"><div class="de1">            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span>parseInt<span class="br0">&#40;</span>xTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>yTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="kw1">break</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">        <span class="kw1">case</span> <span class="st0">&quot;setX&quot;</span><span class="sy0">:</span></div></li><li class="li1"><div class="de1">            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;x&quot;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>xTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="kw1">break</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">case</span> <span class="st0">&quot;setY&quot;</span><span class="sy0">:</span></div></li><li class="li1"><div class="de1">            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;y&quot;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>yTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">            <span class="kw1">break</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">case</span> <span class="st0">&quot;setColor&quot;</span><span class="sy0">:</span></div></li><li class="li1"><div class="de1">            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;color&quot;</span><span class="sy0">,</span> Y.<span class="me1">Lang</span>.<span class="me1">trim</span><span class="br0">&#40;</span>colorTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="kw1">break</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">case</span> <span class="st0">&quot;setAll&quot;</span><span class="sy0">:</span></div></li><li class="li2"><div class="de2">            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span>parseInt<span class="br0">&#40;</span>xTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>yTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;color&quot;</span><span class="sy0">,</span> Y.<span class="me1">Lang</span>.<span class="me1">trim</span><span class="br0">&#40;</span>colorTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">            <span class="kw1">break</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">        <span class="kw1">case</span> <span class="st0">&quot;getAll&quot;</span><span class="sy0">:</span></div></li><li class="li1"><div class="de1">            getAll<span class="br0">&#40;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li><li class="li2"><div class="de2">            <span class="kw1">break</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">        <span class="kw2">default</span><span class="sy0">:</span></div></li><li class="li1"><div class="de1">            <span class="kw1">break</span><span class="sy0">;</span></div></li><li class="li1"><div class="de1">    <span class="br0">&#125;</span></div></li><li class="li1"><div class="de1">&nbsp;</div></li><li class="li2"><div class="de2"><span class="br0">&#125;</span><span class="sy0">,</span> <span class="st0">&quot;#attrs&quot;</span><span class="sy0">,</span> <span class="st0">&quot;click&quot;</span><span class="sy0">,</span> <span class="st0">&quot;button.action&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></div></li></ol></pre></div><div class="nonumbers"><pre class="javascript" style="font-family:monospace;"><span class="co1">// Set references to form controls</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   759
<span class="kw2">var</span> xTxt <span class="sy0">=</span> Y.<span class="me1">one</span><span class="br0">&#40;</span><span class="st0">&quot;#x&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   760
<span class="kw2">var</span> yTxt <span class="sy0">=</span> Y.<span class="me1">one</span><span class="br0">&#40;</span><span class="st0">&quot;#y&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   761
<span class="kw2">var</span> colorTxt <span class="sy0">=</span> Y.<span class="me1">one</span><span class="br0">&#40;</span><span class="st0">&quot;#color&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   762
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   763
<span class="co1">// Use event delegation for the action button clicks</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   764
Y.<span class="me1">on</span><span class="br0">&#40;</span><span class="st0">&quot;delegate&quot;</span><span class="sy0">,</span> <span class="kw2">function</span><span class="br0">&#40;</span>e<span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   765
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   766
    <span class="co1">// Get Node target from the event object. </span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   767
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   768
    <span class="co1">// We already know it's a button which has an action because</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   769
    <span class="co1">// of our selector (button.action), so all we need to do is </span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   770
    <span class="co1">// route it based on the id.</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   771
    <span class="kw2">var</span> id <span class="sy0">=</span> e.<span class="me1">currentTarget</span>.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;id&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   772
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   773
    <span class="kw1">switch</span> <span class="br0">&#40;</span>id<span class="br0">&#41;</span> <span class="br0">&#123;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   774
        <span class="kw1">case</span> <span class="st0">&quot;setXY&quot;</span><span class="sy0">:</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   775
            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span>parseInt<span class="br0">&#40;</span>xTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>yTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   776
            <span class="kw1">break</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   777
        <span class="kw1">case</span> <span class="st0">&quot;setX&quot;</span><span class="sy0">:</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   778
            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;x&quot;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>xTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   779
            <span class="kw1">break</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   780
        <span class="kw1">case</span> <span class="st0">&quot;setY&quot;</span><span class="sy0">:</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   781
            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;y&quot;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>yTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   782
            <span class="kw1">break</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   783
        <span class="kw1">case</span> <span class="st0">&quot;setColor&quot;</span><span class="sy0">:</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   784
            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;color&quot;</span><span class="sy0">,</span> Y.<span class="me1">Lang</span>.<span class="me1">trim</span><span class="br0">&#40;</span>colorTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   785
            <span class="kw1">break</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   786
        <span class="kw1">case</span> <span class="st0">&quot;setAll&quot;</span><span class="sy0">:</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   787
            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;xy&quot;</span><span class="sy0">,</span> <span class="br0">&#91;</span>parseInt<span class="br0">&#40;</span>xTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">,</span> parseInt<span class="br0">&#40;</span>yTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#93;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   788
            box.<span class="me1">set</span><span class="br0">&#40;</span><span class="st0">&quot;color&quot;</span><span class="sy0">,</span> Y.<span class="me1">Lang</span>.<span class="me1">trim</span><span class="br0">&#40;</span>colorTxt.<span class="me1">get</span><span class="br0">&#40;</span><span class="st0">&quot;value&quot;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   789
            <span class="kw1">break</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   790
        <span class="kw1">case</span> <span class="st0">&quot;getAll&quot;</span><span class="sy0">:</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   791
            getAll<span class="br0">&#40;</span><span class="br0">&#41;</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   792
            <span class="kw1">break</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   793
        <span class="kw2">default</span><span class="sy0">:</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   794
            <span class="kw1">break</span><span class="sy0">;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   795
    <span class="br0">&#125;</span>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   796
&nbsp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   797
<span class="br0">&#125;</span><span class="sy0">,</span> <span class="st0">&quot;#attrs&quot;</span><span class="sy0">,</span> <span class="st0">&quot;click&quot;</span><span class="sy0">,</span> <span class="st0">&quot;button.action&quot;</span><span class="br0">&#41;</span><span class="sy0">;</span></pre></div><textarea id="syntax5-plain">// Set references to form controls
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   798
var xTxt = Y.one("#x");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   799
var yTxt = Y.one("#y");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   800
var colorTxt = Y.one("#color");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   801
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   802
// Use event delegation for the action button clicks
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   803
Y.on("delegate", function(e) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   804
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   805
    // Get Node target from the event object. 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   806
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   807
    // We already know it's a button which has an action because
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   808
    // of our selector (button.action), so all we need to do is 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   809
    // route it based on the id.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   810
    var id = e.currentTarget.get("id");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   811
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   812
    switch (id) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   813
        case "setXY":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   814
            box.set("xy", [parseInt(xTxt.get("value")), parseInt(yTxt.get("value"))]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   815
            break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   816
        case "setX":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   817
            box.set("x", parseInt(xTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   818
            break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   819
        case "setY":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   820
            box.set("y", parseInt(yTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   821
            break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   822
        case "setColor":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   823
            box.set("color", Y.Lang.trim(colorTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   824
            break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   825
        case "setAll":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   826
            box.set("xy", [parseInt(xTxt.get("value")), parseInt(yTxt.get("value"))]);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   827
            box.set("color", Y.Lang.trim(colorTxt.get("value")));
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   828
            break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   829
        case "getAll":
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   830
            getAll();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   831
            break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   832
        default:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   833
            break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   834
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   835
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   836
}, "#attrs", "click", "button.action");</textarea></div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   837
<p>Rather than attach individual listeners to each button, the above code uses YUI 3's <code>delegate</code> support, to listen for clicks from <code>buttons</code> with an <code>action</code> class which bubble up to the <code>attrs</code> element.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   838
<p>The delegate listener uses the <a href="../../api/DOMEventFacade.html">Event Facade</a> which normalizes cross-browser access to DOM event properties, such as <code>currentTarget</code>, to route to the appropriate button handler. Note the use of selector syntax when we specify the elements for the listener (e.g. <code>#attrs</code>, <code>button.actions</code>) and the use of the <a href="../../api/Node.html">Node</a> facade when dealing with references to HTML elements (e.g. <code>xTxt, yTxt, colorTxt</code>).</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   839
				</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   840
				<div class="yui-u sidebar">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   841
					
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   842
				
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   843
					<div id="examples" class="mod box4">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   844
                        <div class="hd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   845
						<h4>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   846
    Attribute Examples:</h4>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   847
                        </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   848
						<div class="bd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   849
							<ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   850
								<li><a href='../attribute/attribute-basic.html'>Basic Attribute Configuration</a></li><li><a href='../attribute/attribute-rw.html'>Read-Only and Write-Once Attributes</a></li><li><a href='../attribute/attribute-event.html'>Attribute Change Events</a></li><li><a href='../attribute/attribute-basic-speeddate.html'>Attribute Based Speed Dating</a></li><li><a href='../attribute/attribute-event-speeddate.html'>Attribute Event Based Speed Dating</a></li><li class='selected'><a href='../attribute/attribute-getset.html'>Attribute Getters, Setters and Validators</a></li>							</ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   851
						</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   852
					</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   853
					
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   854
					<div class="mod box4">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   855
                        <div class="hd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   856
						<h4>More Attribute Resources:</h4>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   857
                        </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   858
                        <div class="bd">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   859
						<ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   860
							<!-- <li><a href="http://developer.yahoo.com/yui/attribute/">User's Guide</a> (external)</li> -->
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   861
<li><a href="../../api/module_attribute.html">API Documentation</a></li></ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   862
                        </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   863
					</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   864
			  </div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   865
		</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   866
		
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   867
		</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   868
	</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   869
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   870
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   871
<div class="yui-b toc3" id="tocWrapper">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   872
<!-- TABLE OF CONTENTS -->
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   873
<div id="toc">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   874
	
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   875
<ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   876
<li class="sect first">YUI 3 Resources</li><li class="item"><a title="YUI 3 -- Yahoo! User Interface (YUI) Library" href="http://developer.yahoo.com/yui/3/">YUI 3 Web Site</a></li><li class="item"><a title="Examples of every YUI utility and control in action" href="../../examples/">YUI 3 Examples</a></li><li class="item"><a title="Instantly searchable API documentation for the entire YUI library." href="../../api/">YUI 3 API Docs</a></li><li class="item"><a title="YUI 3 Dependency Configurator -- configure your custom YUI implementation" href="http://developer.yahoo.com/yui/3/configurator">YUI 3 Dependency Configurator</a></li><li class="item"><a title="The YUI 3 Forum on YUILibrary.com" href="http://yuilibrary.com/forum/viewforum.php?f=15">YUI 3 Forums (external)</a></li><li class="item"><a title="Found a bug or a missing feature? Let us know on YUILibrary.com." href="http://developer.yahoo.com/yui/articles/reportingbugs/">Bug Reports/Feature Requests</a></li><li class="item"><a title="YUI is free and open, offered under a BSD license." href="http://developer.yahoo.com/yui/license.html">YUI License</a></li><li class="item"><a title="Download and fork the YUI project on GitHub" href="http://github.com/yui">YUI on Github</a></li><li class="item"><a title="The Yahoo! User Interface Blog" href="http://yuiblog.com">YUI Blog (external)</a></li><li class="sect">YUI 3 Core - Examples</li><li class="item"><a title="YUI Global Object - Functional Examples" href="../../examples/yui/index.html">YUI Global Object</a></li><li class="item"><a title="Event - Functional Examples" href="../../examples/event/index.html">Event</a></li><li class="item"><a title="Node - Functional Examples" href="../../examples/node/index.html">Node</a></li><li class="sect">YUI 3 Component Infrastructure - Examples</li><li class="selected "><a title="Attribute - Functional Examples" href="../../examples/attribute/index.html">Attribute</a></li><li class="item"><a title="Plugin - Functional Examples" href="../../examples/plugin/index.html">Plugin <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="Widget - Functional Examples" href="../../examples/widget/index.html">Widget <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="sect">YUI 3 Utilities - Examples</li><li class="item"><a title="Animation - Functional Examples" href="../../examples/anim/index.html">Animation</a></li><li class="item"><a title="AsyncQueue - Functional Examples" href="../../examples/async-queue/index.html">AsyncQueue</a></li><li class="item"><a title="Browser History - Functional Examples" href="../../examples/history/index.html">Browser History</a></li><li class="item"><a title="Cache - Functional Examples" href="../../examples/cache/index.html">Cache</a></li><li class="item"><a title="Cookie - Functional Examples" href="../../examples/cookie/index.html">Cookie</a></li><li class="item"><a title="DataSchema - Functional Examples" href="../../examples/dataschema/index.html">DataSchema <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="DataSource - Functional Examples" href="../../examples/datasource/index.html">DataSource <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="DataType - Functional Examples" href="../../examples/datatype/index.html">DataType <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="Drag &amp; Drop - Functional Examples" href="../../examples/dd/index.html">Drag &amp; Drop</a></li><li class="item"><a title="Get - Functional Examples" href="../../examples/get/index.html">Get</a></li><li class="item"><a title="ImageLoader - Functional Examples" href="../../examples/imageloader/index.html">ImageLoader</a></li><li class="item"><a title="IO - Functional Examples" href="../../examples/io/index.html">IO</a></li><li class="item"><a title="JSON (JavaScript Object Notation) - Functional Examples" href="../../examples/json/index.html">JSON</a></li><li class="item"><a title="Stylesheet - Functional Examples" href="../../examples/stylesheet/index.html">Stylesheet</a></li><li class="sect">YUI 3 Widgets - Examples</li><li class="item"><a title="Overlay - Functional Examples" href="../../examples/overlay/index.html">Overlay <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="Slider - Functional Examples" href="../../examples/slider/index.html">Slider <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="sect">YUI 3 Node Plugins - Examples</li><li class="item"><a title="FocusManager Node Plugin - Functional Examples" href="../../examples/node-focusmanager/index.html">FocusManager Node Plugin <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="MenuNav Node Plugin - Functional Examples" href="../../examples/node-menunav/index.html">MenuNav Node Plugin <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="sect">YUI 3 CSS - Examples</li><li class="item"><a title="YUI CSS Reset - Functional Examples" href="../../examples/cssreset/index.html">CSS Reset</a></li><li class="item"><a title="YUI Fonts - Functional Examples" href="../../examples/cssfonts/index.html">CSS Fonts</a></li><li class="item"><a title="YUI Base - Functional Examples" href="../../examples/cssbase/index.html">CSS Base</a></li><li class="sect">YUI 3 Developer Tools - Examples</li><li class="item"><a title="Console - Functional Examples" href="../../examples/console/index.html">Console <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="Console Filters Plugin- Functional Examples" href="../../examples/console-filters/index.html">Plugin.ConsoleFilters <img src='http://l.yimg.com/a/i/not/beta_1.gif'></a></li><li class="item"><a title="Profiler - Functional Examples" href="../../examples/profiler/index.html">Profiler</a></li><li class="item"><a title="Test - Functional Examples" href="../../examples/test/index.html">Test</a></li><li class="sect">Other Useful YUI 3 Resources</li><li class="item"><a title="Answers to Frequently Asked Questions about the YUI Library" href="http://developer.yahoo.com/yui/articles/faq/">YUI FAQ (external)</a></li><li class="item"><a title="Yahoo!'s philosophy of Graded Browser Support" href="http://developer.yahoo.com/yui/articles/gbs/">Graded Browser Support (external)</a></li><li class="item"><a title="Videos and podcasts from the YUI Team and from the Yahoo! frontend engineering community." href="http://developer.yahoo.com/yui/theater/">YUI Theater (external)</a></li></ul>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   877
</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   878
</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   879
	</div><!--closes bd-->
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   880
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   881
	<div id="ft">
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   882
        <p class="first">Copyright &copy; 2009 Yahoo! Inc. All rights reserved.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   883
        <p><a href="http://privacy.yahoo.com/privacy/us/devel/index.html">Privacy Policy</a> - 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   884
            <a href="http://docs.yahoo.com/info/terms/">Terms of Service</a> - 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   885
            <a href="http://docs.yahoo.com/info/copyright/copyright.html">Copyright Policy</a> - 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   886
            <a href="http://careers.yahoo.com/">Job Openings</a></p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   887
	</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   888
</div>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   889
<script language="javascript"> 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   890
var yuiConfig = {base:"../../build/", timeout: 10000};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   891
</script>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   892
<script src="../../assets/syntax.js"></script>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   893
<script src="../../assets/dpSyntaxHighlighter.js"></script>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   894
<script language="javascript"> 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   895
dp.SyntaxHighlighter.HighlightAll('code'); 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   896
</script>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   897
</body>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   898
</html>