layout_Stack.js.html 12 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. <html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"> <style>
  2. .KEYW {color: #933;}
  3. .COMM {color: #bbb; font-style: italic;}
  4. .NUMB {color: #393;}
  5. .STRN {color: #393;}
  6. .REGX {color: #339;}
  7. .line {border-right: 1px dotted #666; color: #666; font-style: normal;}
  8. </style></head><body><pre><span class='line'> 1</span> <span class="COMM">/**
  9. <span class='line'> 2</span> * Returns a new stack layout.
  10. <span class='line'> 3</span> *
  11. <span class='line'> 4</span> * @class A layout for stacking marks vertically or horizontally, using the
  12. <span class='line'> 5</span> * &lt;i>cousin&lt;/i> instance. This layout is designed to be used for one of the
  13. <span class='line'> 6</span> * four positional properties in the box model, and changes behavior depending
  14. <span class='line'> 7</span> * on the property being evaluated:&lt;ul>
  15. <span class='line'> 8</span> *
  16. <span class='line'> 9</span> * &lt;li>bottom: cousin.bottom + cousin.height
  17. <span class='line'> 10</span> * &lt;li>top: cousin.top + cousin.height
  18. <span class='line'> 11</span> * &lt;li>left: cousin.left + cousin.width
  19. <span class='line'> 12</span> * &lt;li>right: cousin.right + cousin.width
  20. <span class='line'> 13</span> *
  21. <span class='line'> 14</span> * &lt;/ul>If no cousin instance is available (for example, for first instance),
  22. <span class='line'> 15</span> * the specified offset is used. If no offset is specified, zero is used. For
  23. <span class='line'> 16</span> * example,
  24. <span class='line'> 17</span> *
  25. <span class='line'> 18</span> * &lt;pre>new pv.Panel()
  26. <span class='line'> 19</span> * .width(150).height(150)
  27. <span class='line'> 20</span> * .add(pv.Panel)
  28. <span class='line'> 21</span> * .data([[1, 1.2, 1.7, 1.5, 1.7],
  29. <span class='line'> 22</span> * [.5, 1, .8, 1.1, 1.3],
  30. <span class='line'> 23</span> * [.2, .5, .8, .9, 1]])
  31. <span class='line'> 24</span> * .add(pv.Area)
  32. <span class='line'> 25</span> * .data(function(d) d)
  33. <span class='line'> 26</span> * .bottom(pv.Layout.stack())
  34. <span class='line'> 27</span> * .height(function(d) d * 40)
  35. <span class='line'> 28</span> * .left(function() this.index * 35)
  36. <span class='line'> 29</span> * .root.render();&lt;/pre>
  37. <span class='line'> 30</span> *
  38. <span class='line'> 31</span> * specifies a vertically-stacked area chart.
  39. <span class='line'> 32</span> *
  40. <span class='line'> 33</span> * @returns {pv.Layout.stack} a stack property function.
  41. <span class='line'> 34</span> * @see pv.Mark#cousin
  42. <span class='line'> 35</span> */</span><span class="WHIT">
  43. <span class='line'> 36</span> </span><span class="NAME">pv.Layout.stack</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
  44. <span class='line'> 37</span> </span><span class="WHIT"> </span><span class="COMM">/** @private */</span><span class="WHIT">
  45. <span class='line'> 38</span> </span><span class="WHIT"> </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">offset</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NUMB">0</span><span class="PUNC">;</span><span class="WHIT"> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  46. <span class='line'> 39</span>
  47. <span class='line'> 40</span> </span><span class="WHIT"> </span><span class="COMM">/** @private */</span><span class="WHIT">
  48. <span class='line'> 41</span> </span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">layout</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
  49. <span class='line'> 42</span>
  50. <span class='line'> 43</span> </span><span class="WHIT"> </span><span class="COMM">/* Find the previous visible parent instance. */</span><span class="WHIT">
  51. <span class='line'> 44</span> </span><span class="WHIT"> </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">i</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">this.parent.index</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">p</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">c</span><span class="PUNC">;</span><span class="WHIT">
  52. <span class='line'> 45</span> </span><span class="WHIT"> </span><span class="KEYW">while</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">(</span><span class="NAME">i</span><span class="PUNC">--</span><span class="WHIT"> </span><span class="PUNC">></span><span class="WHIT"> </span><span class="NUMB">0</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">c</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
  53. <span class='line'> 46</span> </span><span class="WHIT"> </span><span class="NAME">p</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">this.parent.scene</span><span class="PUNC">[</span><span class="NAME">i</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
  54. <span class='line'> 47</span> </span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">p.visible</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="NAME">c</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">p.children</span><span class="PUNC">[</span><span class="NAME">this.childIndex</span><span class="PUNC">]</span><span class="PUNC">[</span><span class="NAME">this.index</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
  55. <span class='line'> 48</span> </span><span class="WHIT"> </span><span class="PUNC">}</span><span class="WHIT">
  56. <span class='line'> 49</span>
  57. <span class='line'> 50</span> </span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">c</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
  58. <span class='line'> 51</span> </span><span class="WHIT"> </span><span class="KEYW">switch</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">property</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
  59. <span class='line'> 52</span> </span><span class="WHIT"> </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">"bottom"</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">c.bottom</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT"> </span><span class="NAME">c.height</span><span class="PUNC">;</span><span class="WHIT">
  60. <span class='line'> 53</span> </span><span class="WHIT"> </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">"top"</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">c.top</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT"> </span><span class="NAME">c.height</span><span class="PUNC">;</span><span class="WHIT">
  61. <span class='line'> 54</span> </span><span class="WHIT"> </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">"left"</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">c.left</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT"> </span><span class="NAME">c.width</span><span class="PUNC">;</span><span class="WHIT">
  62. <span class='line'> 55</span> </span><span class="WHIT"> </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">"right"</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">c.right</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT"> </span><span class="NAME">c.width</span><span class="PUNC">;</span><span class="WHIT">
  63. <span class='line'> 56</span> </span><span class="WHIT"> </span><span class="PUNC">}</span><span class="WHIT">
  64. <span class='line'> 57</span> </span><span class="WHIT"> </span><span class="PUNC">}</span><span class="WHIT">
  65. <span class='line'> 58</span>
  66. <span class='line'> 59</span> </span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">offset.apply</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">arguments</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
  67. <span class='line'> 60</span> </span><span class="WHIT"> </span><span class="PUNC">}</span><span class="WHIT">
  68. <span class='line'> 61</span>
  69. <span class='line'> 62</span> </span><span class="WHIT"> </span><span class="COMM">/**
  70. <span class='line'> 63</span> * Sets the offset for this stack layout. The offset can either be specified
  71. <span class='line'> 64</span> * as a function or as a constant. If a function, the function is invoked in
  72. <span class='line'> 65</span> * the same context as a normal property function: &lt;tt>this&lt;/tt> refers to the
  73. <span class='line'> 66</span> * mark, and the arguments are the full data stack. By default the offset is
  74. <span class='line'> 67</span> * zero.
  75. <span class='line'> 68</span> *
  76. <span class='line'> 69</span> * @function
  77. <span class='line'> 70</span> * @name pv.Layout.stack.prototype.offset
  78. <span class='line'> 71</span> * @param {function} f offset function, or constant value.
  79. <span class='line'> 72</span> * @returns {pv.Layout.stack} this.
  80. <span class='line'> 73</span> */</span><span class="WHIT">
  81. <span class='line'> 74</span> </span><span class="WHIT"> </span><span class="NAME">layout.offset</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="PUNC">(</span><span class="NAME">f</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
  82. <span class='line'> 75</span> </span><span class="WHIT"> </span><span class="NAME">offset</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">f</span><span class="WHIT"> </span><span class="KEYW">instanceof</span><span class="WHIT"> </span><span class="NAME">Function</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">?</span><span class="WHIT"> </span><span class="NAME">f</span><span class="WHIT"> </span><span class="PUNC">:</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">f</span><span class="PUNC">;</span><span class="WHIT"> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  83. <span class='line'> 76</span> </span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">this</span><span class="PUNC">;</span><span class="WHIT">
  84. <span class='line'> 77</span> </span><span class="WHIT"> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  85. <span class='line'> 78</span>
  86. <span class='line'> 79</span> </span><span class="WHIT"> </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">layout</span><span class="PUNC">;</span><span class="WHIT">
  87. <span class='line'> 80</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  88. <span class='line'> 81</span> </span></pre></body></html>