Portal Context: Difference between revisions

From HLKitWiki
Jump to navigationJump to search
New page: {{context|Kit Reference|Context Transitions}} See Also: Portal Target References From within a "portal" context, you can utilize the following set of valid context transitions: :{| ...
 
No edit summary
Line 1: Line 1:
{{context|Kit Reference|Context Transitions}}
{{contextmulti|Kit Reference}}


See Also: [[Portal Target References]]
Jump to: [[#references|Target References]]
 
The "portal" context identifies a portal within the current hierarchy. Portals can either be used within templates or within layouts, so the parent context of the portal within the hierarchy can vary.
 
==Context Transitions{{anchor|transitions}}==


From within a "portal" context, you can utilize the following set of valid context transitions:
From within a "portal" context, you can utilize the following set of valid context transitions:
Line 7: Line 11:
:{| class="infotable"
:{| class="infotable"
|class="leftnormal"|parent
|class="leftnormal"|parent
|Transitions to the [[Layout Context Transitions|layout context]] or [[Template Context Transitions|template context]] corresponding to the visual element that contains the portal.<br>
|Transitions to the [[Layout Context|layout context]] or [[Template Context|template context]] corresponding to the visual element that contains the portal.<br>
Example: this.parent<br>
Example: this.parent<br>
{{note}}The "parent" transition can only be utilized a '''single''' time, so it is not possible to go upwards two or more levels within the hierarchy.
{{note}}The "parent" transition can only be utilized a '''single''' time, so it is not possible to go upwards two or more levels within the hierarchy.
|-
|}
==Target References{{anchor|references}}==
The "portal" script context governs the operations that can be applied to portals within templates and layouts. The complete list of target references for portals is presented in the table below.
:{| class="infotable"
|class="leftnormal"|width
|(Left, Right, Number) Accesses the width of the portal. Unless explicitly specified within the XML, the width of a portal is automatically initialized appropriately to the nature of the portal. Setting the width of a table portal triggers immediate re-sizing of all items within the table.<br>
Example: result = this.width<br>
Example: this.width = 42
|-
|height
|(Left, Right, Number) Accesses the height of the portal. Unless explicitly specified within the XML, the height of a portal is automatically initialized appropriately to the nature of the portal. Setting the height of a table portal triggers immediate re-sizing of all items within the table.<br>
Example: result = this.height<br>
Example: this.height = 42
|-
|left
|(Left, Right, Number) Accesses the position of the left edge of the portal within the containing visual element.<br>
Example: result = this.left<br>
Example: this.left = 42
|-
|top
|(Left, Right, Number) Accesses the position of the top edge of the portal within the containing visual element.<br>
Example: result = this.top<br>
Example: this.top = 42
|-
|right
|(Right, Number) Returns the position of the right edge of the portal within the containing visual element.<br>
Example: result = this.right
|-
|bottom
|(Right, Number) Returns the position of the bottom edge of the portal within the containing visual element.<br>
Example: result = this.bottom
|-
|visible
|(Left, Right, Number) Controls the visibility of the portal within the containing visual element. A non-zero value indicates the portal is visible and a zero value indicates hidden.<br>
Example: result = this.visible<br>
Example: this.visible = 1
|-
|scrollbar
|(Right, Number) Returns the width of a scroller, in pixels.<br>
Example: result = this.scrollbar
|-
|autotop
|(Left, Right, Number) Accesses the position of the top edge of the auto-place region within the containing visual element.<br>
Example: result = this.autotop<br>
Example: this.autotop = 42
|-
|autobottom
|(Left, Right, Number) Accesses the position of the bottom edge of the auto-place region within the containing visual element.<br>
Example: result = this.autobottom<br>
Example: this.autobottom = 420
|-
|autoleft
|(Left, Right, Number) Accesses the position of the left edge of the auto-place region within the containing visual element.<br>
Example: result = this.autoleft<br>
Example: this.autoleft = 42
|-
|autoright
|(Left, Right, Number) Accesses the position of the right edge of the auto-place region within the containing visual element.<br>
Example: result = this.autoright<br>
Example: this.autoright = 420
|-
|autowidth
|(Left, Right, Number) Accesses the width of the auto-place region within the containing visual element.<br>
Example: result = this.autowidth<br>
Example: this.autowidth = 420
|-
|autoheight
|(Left, Right, Number) Accesses the height of the auto-place region within the containing visual element.<br>
Example: result = this.autoheight<br>
Example: this.autoheight = 420
|-
|autogap
|(Left, Right, Number) Accesses the default gap size used when automatically placing elements within the containing visual element. The "autogap" defaults to zero.<br>
Example: result = this.autogap<br>
Example: this.autogap = 42
|-
|autoplace[''gap'']
|(Right, Number) Automatically places the portal within the containing layout, subject to the standard rules for [[Using Automatic Placement|automatic placement]]. The ''gap'' parameter specifies the gap to be used between this portal and the previously placed element. The parameter can be omitted, in which case the established "autogap" is utilized. Automatic placement for portals can only be used within layouts. A value of zero is always returned.<br>
Example: perform this.autoplace[42]<br>
Example: perform this.autoplace
|-
|-
|}
|}

Revision as of 23:38, 7 December 2008

Context: HL Kit &#133; Kit Reference  &#133; Multiple Sources

Jump to: Target References

The "portal" context identifies a portal within the current hierarchy. Portals can either be used within templates or within layouts, so the parent context of the portal within the hierarchy can vary.

Context Transitions

From within a "portal" context, you can utilize the following set of valid context transitions:

parent Transitions to the layout context or template context corresponding to the visual element that contains the portal.

Example: this.parent
NOTE! The "parent" transition can only be utilized a single time, so it is not possible to go upwards two or more levels within the hierarchy.

Target References

The "portal" script context governs the operations that can be applied to portals within templates and layouts. The complete list of target references for portals is presented in the table below.

width (Left, Right, Number) Accesses the width of the portal. Unless explicitly specified within the XML, the width of a portal is automatically initialized appropriately to the nature of the portal. Setting the width of a table portal triggers immediate re-sizing of all items within the table.

Example: result = this.width
Example: this.width = 42

height (Left, Right, Number) Accesses the height of the portal. Unless explicitly specified within the XML, the height of a portal is automatically initialized appropriately to the nature of the portal. Setting the height of a table portal triggers immediate re-sizing of all items within the table.

Example: result = this.height
Example: this.height = 42

left (Left, Right, Number) Accesses the position of the left edge of the portal within the containing visual element.

Example: result = this.left
Example: this.left = 42

top (Left, Right, Number) Accesses the position of the top edge of the portal within the containing visual element.

Example: result = this.top
Example: this.top = 42

right (Right, Number) Returns the position of the right edge of the portal within the containing visual element.

Example: result = this.right

bottom (Right, Number) Returns the position of the bottom edge of the portal within the containing visual element.

Example: result = this.bottom

visible (Left, Right, Number) Controls the visibility of the portal within the containing visual element. A non-zero value indicates the portal is visible and a zero value indicates hidden.

Example: result = this.visible
Example: this.visible = 1

scrollbar (Right, Number) Returns the width of a scroller, in pixels.

Example: result = this.scrollbar

autotop (Left, Right, Number) Accesses the position of the top edge of the auto-place region within the containing visual element.

Example: result = this.autotop
Example: this.autotop = 42

autobottom (Left, Right, Number) Accesses the position of the bottom edge of the auto-place region within the containing visual element.

Example: result = this.autobottom
Example: this.autobottom = 420

autoleft (Left, Right, Number) Accesses the position of the left edge of the auto-place region within the containing visual element.

Example: result = this.autoleft
Example: this.autoleft = 42

autoright (Left, Right, Number) Accesses the position of the right edge of the auto-place region within the containing visual element.

Example: result = this.autoright
Example: this.autoright = 420

autowidth (Left, Right, Number) Accesses the width of the auto-place region within the containing visual element.

Example: result = this.autowidth
Example: this.autowidth = 420

autoheight (Left, Right, Number) Accesses the height of the auto-place region within the containing visual element.

Example: result = this.autoheight
Example: this.autoheight = 420

autogap (Left, Right, Number) Accesses the default gap size used when automatically placing elements within the containing visual element. The "autogap" defaults to zero.

Example: result = this.autogap
Example: this.autogap = 42

autoplace[gap] (Right, Number) Automatically places the portal within the containing layout, subject to the standard rules for automatic placement. The gap parameter specifies the gap to be used between this portal and the previously placed element. The parameter can be omitted, in which case the established "autogap" is utilized. Automatic placement for portals can only be used within layouts. A value of zero is always returned.

Example: perform this.autoplace[42]
Example: perform this.autoplace