Widget UI

Set Vertical Margin
Set the vertical offset of the chat button from the edge of the browser window.
Parameters
Method
Parameters
Type
Description
setVerticalMargin
distance
Integer
Distance from the edge of the browser window, in pixels (number)
Sample code
Set the widget margin for vertical to 35 pixels for bottom.
<script>
     window.acquire = window.acquire || [];
     acquire.push(function(app){
         var setUIConfogFn = function(){
                    if(app) {
                        app.ui.setVerticalMargin(35);
                    }
                }
         app.on('ui_reloaded', (socket, cr, sr) => {
                    setUIConfogFn();
                });
​
        setUIConfogFn();
     });
</script>
Set Horizontal Margin
Set the horizontal offset of the chat button from the edge of the browser window.
Parameters
 Method
Parameters
Type
Description
setHorizontalMargin
distance
Integer
 Distance from the edge of the browser window, in pixels (number)
Sample code
Set the widget margin for horizontal to 35 pixels for left/right
<script>
    window.acquire = window.acquire || [];
     acquire.push(function(app){
         var setUIConfogFn = function(){
                    if(app) {
                        app.ui.setHorizontalMargin(35);
                    }
                }
         app.on('ui_reloaded', (socket, cr, sr) => {
                    setUIConfogFn();
                });
​
        setUIConfogFn();
     });
</script>
Set Custom z-index
Set the widget custom z-index value
Parameters
Method
Parameters
Type
Description
customZindex
value
number
Sets the stack order of the element. Negative numbers are allowed
Sample Code
Set z-index value for widget element 999.
<script>
    window.acquire = window.acquire || [];
     acquire.push(function(app){
         var setUIConfogFn = function(){
                    if(app) {
                        app.ui.customZindex(999);
                    }
                }
         app.on('ui_reloaded', (socket, cr, sr) => {
                    setUIConfogFn();
                });
​
        setUIConfogFn();
     });
</script>
Prevent Mobile Scroll
Prevent scroll on mobile devices when widget maximized. default value is true.
Sample Code
<script>
    window.acquire = window.acquire || [];
     acquire.push(function(app){
         var setUIConfogFn = function(){
                    if(app) {
                        app.ui.setMobileTopBodyScrollBlock(false);
                    }
                }
         app.on('ui_reloaded', (socket, cr, sr) => {
                    setUIConfogFn();
                });
​
        setUIConfogFn();
     });
</script>
Check Widget Status
Widget status is maximize if true.
Sample code
To check widget visible or hidden
<script>
     window.acquire = window.acquire || [];
     acquire.push(function(app){
         var status = app.ui.isMax() ? 'visible' : 'hidden';
     });
</script>
Maximise Widget
Show the chat widget.
Note:  It is recommended to show the chat widget only when initial hidden or if any unread message in thread.
Parameters
 Method
 Parameters
 Type
 Description
 status
 value
 String
 Chat widget status in string 'max'
Sample code
To widget show
<script>
     window.acquire = window.acquire || [];
     acquire.push(function(app){
         app.ui.status('max');
     });
</script>
​
//on html element onclick
<a href="javascript:;" onclick="acquireIO.ui.status('max');">Open Widget</a>
Minimise Widget
Hide the chat widget and show launcher.
Parameters
Method
 Parameters
 Type
 Description
 status
 value
 String
 Chat widget status in string 'min'
Sample code
To widget show
<script>
     window.acquire = window.acquire || [];
     acquire.push(function(app){
         app.ui.status('min');
     });
</script>
​
//on html element onclick
<a href="javascript:;" onclick="acquireIO.ui.status('min');">Open Widget</a>
​
JS API - Previous
Advanced
Reference
Last updated 1 year ago
Method	Parameters	Type	Description
`setVerticalMargin`	`distance`	`Integer`	Distance from the edge of the browser window, in pixels (number)
Method	Parameters	Type	Description
`customZindex`	value	`number`	Sets the stack order of the element. Negative numbers are allowed