Manual Canvas Resizing
Updated: Mar 1, 2018
This method is only enabled when Canvas Height is set to "Fluid" in the App Dashboard
The method
FB.Canvas.setSize() tells Facebook to resize your Canvas iframe. If you do not specific any parameters Facebook will attempt to determine the height of the Canvas app and set the iframe accordingly. If you would like to set the dimension explicitly pass in an object with height and width properties.
If the Canvas Width toggle in set to "Fixed (760px)" in the App Dashboard the max width is 760 pixels. There is no max height.
NOTE: When using this method, ensure that window.name is not overridden as that can cause issues.
Examples
Call this whenever you need a resize. This usually means, once after
pageload, and whenever your content size changes. The example below will attempt to determine the size of the Canvas app content and set the height automatically.
FB.Canvas.setSize();
When determining the Canvas Height automatically the height it can only be increased, not decreased. When possible please pass the explicit dimensions as properties of an object.
FB.Canvas.setSize({ width: 640, height: 480 });
Parameters
This call has a single required object with the name
params. The object must have the following properties set on it:
| Property | Type | Description | Argument | Default |
|---|---|---|---|---|
width | integer | Desired width. Max is app width. | Optional | frame width |
height | integer | Desired height. | Optional | frame height |