home / documentation / reference / righttoleft

RightToLeft

Description:

Boolean value indicating whether right-to-left child menu displays are in effect.

Value:

Boolean (true or false), Integer (1=true, 0=false), or JavaScript expression that returns a boolean value.

Applies To:

Menu Items.

Browser Compatibility:

RightToLeft is supported in all browsers.

Comments:

When RightToLeft is set to true, default child menus are displayed off the left side of the parent menu item instead of the right, child menus using PositionChild are right aligned with their parent menu items instead of left aligned (i.e., the right edge of the first child menu item is aligned with the right edge of its parent menu item), and "more" images, if they appear in the parent menu item, are displayed on the left side of the menu item using the ImageSrcLeft and ImageSrcLeft graphic.

HierMenus sets the default value for RightToLeft based on the existence of right-to-left (dir="rtl") page displays in the browser itself. To determine this, HierMenus calls the internal function HM_f_RTLCheck(), which you are also free to call in your own JavaScript expressions. Since not all browsers support dir="rtl" page displays, using HM_f_RTLCheck() ensures that you will always be using (or not using) right-to-left processing in the same manner that HierMenus is. For further details relating specifically to dir="rtl" browser processing, refer to the release notes for HierMenus version 5.3.

Examples:

// Ok:
RightToLeft:true,
RightToLeft:0,
RightToLeft:(window.thisPage=="cf")?1:0, 
    // if the user defined variable "thisPage" is "cf", 
    // RightToLeft is true

// Incorrect:
RightToLeft:"false",  // quotes not allowed around booleans
RightToLeft:"0",
RightToLeft:'(window.thisPage=="cf")?1:0', // no quoted expressions

Default:

The result of calling HM_f_RTLCheck()

See Also:

ImageSrcLeft, ImageSrcLeftOver, TextAlign, Bulletin 9: HierMenus 5.3 Release Notes