Skip to main content
Version: v25

ContextMenuPosition

Interface

Properties​

attachToXBy​

Optional

Tells what side of the context menu widget should be used to "attach" to a provided x coordinate. If the value is undefined, then you may treat it based on whether it is rtl or not (e.g. 'right' for rtl and 'left' otherwise). The value 'auto' behaves as undefined but additionally checks if there is enough space to place the menu and if it's not then the result value is inverted.

Type​

​"auto" | "left" | "right"

attachToYBy​

Optional

Tells what side of the context menu widget should be used to "attach" to a provided y coordinate:

  • 'auto' means similar to 'top' but the menu could be expanded above the coordinate if needed (if there is no enough space to place it below)
  • 'auto-strict' means 'top' if the whole menu fits the space below the coordinate and 'bottom' otherwise (see box)
  • 'top' means that the menu should be placed to the bottom of y coordinate (the menu should be attached by its bottom to y coordinate)
  • 'bottom' means that the menu should be placed above y coordinate (the menu should be attached by its top to y coordinate)

You may treat undefined as 'auto'.

Type​

​"auto" | "top" | "bottom" | "auto-strict"

box​

Optional

The optional structure that helps to more accurate calculate a position of the menu (see attachToYBy).

Type​

​Object

Type declaration​

clientX​

X (horizontal) coordinate (in pixels) at which the mouse event occurred, relative to the left edge of the applications viewport.

Type​

​number

clientY​

Y (vertical) coordinate (in pixels) at which the mouse event occurred, relative to the left edge of the applications viewport.

Type​

​number

marginX​

Optional

Additional horizontal margin.

Type​

​number

marginY​

Optional

Additional vertical margin.

Type​

​number

touches​

Optional

Touch positions

Type​

​readonly { clientX: number ; clientY: number }[]