setPosition
Positions an element at an x,y screen coordinate, and optionally sets a new width and height for the element.
Your app sometimes needs to move, and possibly resize, the UI elements on a screen. All UI elements (button()
, textInput()
, textLabel()
, dropdown()
, checkbox()
, radioButton()
, image()
), can be moved and resized. It is usually easier to place UI elements in their initial positions, with initial sizes, using Design mode in App Lab. In Design mode you can also specify font size, font color and background color for UI elements.
Examples
Example: Harder Gingerbread Capture
Vary both the location and size of the image.
// Vary both the location and size of the image.
image("id", "gingerbread-man-running.jpg");
onEvent("id", "mouseover", function(event){
var newSize=randomNumber(50,100);
setPosition("id", randomNumber(0,320), randomNumber(0,450), newSize, newSize);
});
Example: Find the Gingerbread Man
Play find the gingerbread man by placing images at specific locations.
// Play find the gingerbread man by placing images at specific locations.
image("id", "gingerbread-man-running.jpg");
var randomXPosition=randomNumber(0,2)*100;
setPosition("id", randomXPosition+10, 170);
image("id1", "codeorg.jpg");
setPosition("id1", 10, 175);
image("id2", "codeorg.jpg");
setPosition("id2", 110, 175);
image("id3", "codeorg.jpg");
setPosition("id3", 210, 175);
onEvent("id1", "click", function(event){
hideElement("id1");
});
onEvent("id2", "click", function(event){
hideElement("id2");
});
onEvent("id3", "click", function(event){
hideElement("id3");
});
// You can't catch the gingerbread man.
image("id", "gingerbread-man-running.jpg");
onEvent("id", "mouseover", function(event){
setPosition("id", randomNumber(0,320), randomNumber(0,450));
});
Syntax
setPosition(id, x, y, width, height)
Parameters
Name | Type | Required? | Description |
---|---|---|---|
id | string | The ID of the UI element to which this event handler applies. Must begin with a letter, contain no spaces, and may contain letters, digits, - and _. | |
x | number | The x coordinate on the screen to move the UI element to. | |
y | number | The y coordinate on the screen to move the UI element to. | |
width | number | The width to set the UI element to, in pixels. | |
height | number | The height to set the UI element to, in pixels. |
Tips
- The upper left corner of the UI element is placed at the (x,y) coordinate location.
- The screen default size is 320 pixels wide and 450 pixels high, but you can move a UI element off the screen by exceeding those dimensions.

Found a bug in the documentation? Let us know at support@code.org.