com.smartgwt.client.util

Class Browser

java.lang.Object

com.smartgwt.client.util.Browser

public class Browser
extends java.lang.Object

The Browser class contains various class attributes that indicate basic properties of the browser and whether certain features are enabled.

Constructor Summary

Constructors

Constructor and Description
Browser()

Method Summary

Modifier and Type	Method and Description
static boolean	getIsDesktop() Is the application running in a desktop browser? This is true if isTablet and isHandset are both false.
static boolean	getIsHandset() Is the application running on a handset-sized device, with a typical screen width of around 3-4 inches?
static boolean	getIsTablet() Is the application running on a tablet device (e.g.
static boolean	getIsTouch() Is the application running on a touch device (e.g.
static void	setIsDesktop(boolean isDesktop) Setter for isDesktop to allow this global variable to be changed at runtime.
static void	setIsHandset(boolean isHandset) Setter for isHandset to allow this global variable to be changed at runtime.
static void	setIsTablet(boolean isTablet) Setter for isTablet to allow this global variable to be changed at runtime.
static void	setIsTouch(boolean isTouch) Setter for isTouch to allow this global variable to be changed at runtime.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Browser

public Browser()

Method Detail

getIsDesktop

public static boolean getIsDesktop()

Is the application running in a desktop browser? This is true if isTablet and isHandset are both false.

Returns:

current value of isDesktop

getIsHandset

public static boolean getIsHandset()

Is the application running on a handset-sized device, with a typical screen width of around 3-4 inches?

This typically implies that the application will be working with only 300-400 pixels.

Returns:

current value of isHandset

getIsTablet

public static boolean getIsTablet()

Is the application running on a tablet device (e.g. iPad, Nexus 7)?

Smart GWT can correctly determine whether the device is a tablet in most cases. On any uncommon device for which this variable is incorrect, you can define the isc_isTablet global with the correct value, and Smart GWT will use isc_isTablet for Browser.isTablet instead of its own detection logic. Alternatively, you can use setIsTablet() to change this global variable before any components are created.

The value of this variable is only meaningful on touch devices.

Returns:

current value of isTablet

getIsTouch

public static boolean getIsTouch()

Is the application running on a touch device (e.g. iPhone, iPad, Android device, etc.)?

Smart GWT's auto-detected value for isTouch can be overridden via setIsTouch().

Returns:

current value of isTouch

setIsDesktop

public static void setIsDesktop(boolean isDesktop)

Setter for isDesktop to allow this global variable to be changed at runtime. This advanced method is provided to override Smart GWT's detection of devices, since the framework can only detect devices that existed at the time the platform was released. Any changes to isDesktop, isHandset, or isTablet must be made before any component is created; it is an application error to attempt to change isDesktop, isHandset, or isTablet after components have been created.

Note that setting Browser.isDesktop might affect the values of isHandset and isTablet.

Parameters:

isDesktop - new setting for Browser.isDesktop.

setIsHandset

public static void setIsHandset(boolean isHandset)

Setter for isHandset to allow this global variable to be changed at runtime. This advanced method is provided to override Smart GWT's detection of devices, since the framework can only detect devices that existed at the time the platform was released. Any changes to isDesktop, isHandset, or isTablet must be made before any component is created; it is an application error to attempt to change isDesktop, isHandset, or isTablet after components have been created.

Note that setting Browser.isHandset might affect the values of isDesktop and isTablet.

Parameters:

isHandset - new setting for Browser.isHandset.

setIsTablet

public static void setIsTablet(boolean isTablet)

Setter for isTablet to allow this global variable to be changed at runtime. This advanced method is provided to override Smart GWT's detection of devices, since the framework can only detect devices that existed at the time the platform was released. Any changes to isDesktop, isHandset, or isTablet must be made before any component is created; it is an application error to attempt to change isDesktop, isHandset, or isTablet after components have been created.

Note that setting Browser.isTablet might affect the values of isDesktop and isHandset.

Parameters:

isTablet - new setting for Browser.isTablet.

setIsTouch

public static void setIsTouch(boolean isTouch)

Setter for isTouch to allow this global variable to be changed at runtime. This advanced method is provided to override Smart GWT's auto-detection logic, since the framework can only detect touch devices that existed at the time the platform was released. Any change to isTouch must be made before any component is created; it is an application error to attempt to change isTouch after components have been created.

Note that setting Browser.isTouch might affect the values of isDesktop, isTablet, and/or isHandset.

Parameters:

isTouch - new setting for Browser.isTablet.