« back

Global Navigation v2: XML Attributes

Required

id

  • A unique ID for your button. This could be “home”, “about_us” etc.

btnSWF

  • The SWF file of your button. You can have a different SWF for each button if you like…

Optional

btnLabel

  • Default = btnID. Content of the button label text.

btnSize

btnLabelAlign

  • Default is “CENTER”. The horizontal alignment of the button label text. The vertical alignment is handled in the btn.swf itself.

btnAddLabelSpace

btnStayActive

  • Default = “true”. If this is “true”, the button will remain in its active state when released, until another button in the same group is released. If set to “false”, the button will immediatly go back to its rollOut state after it has been released. Often this is used for a “Home” button.

btnPosX

  • Default is ”+0”. If it is ”+0” than this means this button has the same X position as its parent button. If you want it to be 30 pixels more to the left, use ”+30”. If the button should be placed at absolute x position of 30 pixels, use “30”. Note: The first button acts as master. The sibling buttons on the same level inherit that position. If you don’t specify btnPosY/btnPosX, the buttons will be aligned according to the btnSpacingX / btnSpacingY. You can use the “+” sign to add space (or “-” to subtract space).

btnPosY

  • Default is ”+0”. See “btnPosX” for details.

btnSpacingX

  • Default is “0”
  • If you set btnSpacingX, then the buttons of that level will be aligned horizontally, the buttons spaced by the value you set.

btnSpacingY

  • Default is “0”
  • If you use btnSpacingY, then the buttons of that level will be aligned vertically, spaced by the value you set. You can only have btnSpacingX OR btnSpacingY defined per level.

btnMakeRoomY

  • Default is “false”
  • btnMakeRoomY=”true” means this button will move down if space is needed. It will move automatically by the amount of buttons inserted. There is no horizontal version (btnMakeRoomX), it may come in a future release.
  • Note: If you use this xml attribute, please set fadeInOnMouseOver to “false”. The combination is not (yet) working as expected!

btnMakeRoomAddSpace

btnAutoActivate

  • Default is “false”. If the group this button resides in is activated, this button will be activated automatically.

btnReselect

  • Default is “false”. Normally a button cannot be selected again after it has been activated. If you need to reselect it, you can do so by setting this attribute to “true”. Sometimes it is necessary, for example when you want to deselect all the buttons in the submenu.

btnIgnoreRelease

  • Default is “false”. If a button has children buttons which are shown ar rollOver, you may not want to have any action performed if you click the main button. So now you can set btnIgnoreRelease=“true” to avoid it.

btnHide

  • Default is “false”. Use this if you don't need a button, but the functuality of it. For example, you don't need a visible “Home” button, instead the user can click on the logo of your website. But the navigation has to be deactivated in that case.

btnDisabled

  • Default is “false”. If set to “true”, the button will be visible, but with alpha=0.3 and mouseEnabled=false. Use this if the button should be visible, but not active yet. For example when the Website you are working on goes online before all the content is ready. So the visitors get the whole picture of the site but also see where they cannot click yet.

btnDisabledAlpha

  • If you have disabled a button by using btnDisabled=“true”, you can set the alpha value, for example btnDisabledAlpha=“0.5”. There is a special case: if you set btnDisabledAlpha=“1”, a gotoAndPlay(“disable”) will be executed. So besides “rollOver”, “rollOut” etc. in your button swf you can now set up one more state: “disable”. Here you can have whatever disabled state you like. Imagine for example a menubar-like navigation that contains a “delimiter” button, which is just a line but should not have an function at all.

btnJoker

  • Default is ””. btnJoker can be used for anything. You can store a value which can be used in the btn.swf. For example to have different colors for certain navigation levels and so on.
global-navigation2-xml.txt · Last modified: 2011/12/21 20:25 by kaegi
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki