kony.theme Namespace

The kony.theme namespace implements the Theme API. It contains the following API elements.

Functions

The kony.theme namespace provides the following functions.

This API enables you to create a theme.

Syntax

kony.theme.createTheme(url, themeIdentifier, onsuccesscallback, onerrorcallback);

Input Parameters

Parameter Description
url [String] - Mandatory Specifies a string (URL) from which the theme is to be downloaded. The theme is represented as a JSON object.

NOTE: If the JSON object contains invalid skin attributes, the platforms use the default attributes (platform specific and may vary from platform to platform).
themeIdentifier [String] - Mandatory Specifies a flag that indicates if the current theme must be replaced with the same identifier or use the theme only in the current session.
onsuccesscallback [Function]-Mandatory Specifies the callback function that needs to be executed in case of success. This callback function is executed after the theme is created.
onerrorcallback [Function] - Mandatory Specifies the callback function that needs to be executed in case of error. This callback function has the following signature:

onerrorcallback (errorcode,errormessage)

    • errorcode - the error code thrown if there was a problem while creating the theme
    • errormessage - the error message that corresponds to the error code.

Example


function onsuccesscallback() {
    alert("successfully set the theme to app");
}

function onerrorcallback() {
    alert("Theme is not set to the app");
}

kony.theme.createTheme("", "Mytheme", onsuccesscreatecallback, onerrorcreatecallback);

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on all platforms.

For Desktop Web, ensure that the URL mentioned in the createTheme API should point only to a CSS file. The platform does not support a URL with a.Theme file and convert it into a CSS file at run time.

This API enables you to create or replace a JSON string theme in the current session.

Syntax

kony.theme.createThemeFromJSONString(jsonString, themeIdentifier, onsuccesscallback, onerrorcallback);

Input Parameters

Parameter Description
jsonString [String] - Mandatory

A well-defined theme JSON string with which a theme is created. The theme is represented as a JSON object.
You can use the jsonString parameter to set the required skin attributes for various properties that are applicable for Quantum Visualizer Widgets. For instance, you can set values for properties that are applicable for several Quantum Visualizer Widgets. These properties include background color, font weight, font size, border color, shadow, text shadow, and so on.

NOTE: For more information on what properties are applicable for each widget and what values you can specify for each property, refer to the default.themes file in the build-> dist -> Project folder-> assets path of Quantum Visualizer.

NOTE: If the JSON object contains invalid skin attributes, the platforms use the default attributes (platform specific and may vary from platform to platform).
themeIdentifier [String] - Mandatory Specifies an identifier with which current theme must be created or replace if the theme is already exists and this theme will be available only in the current session.

NOTE: The theme will not be created and an error callback is called, if null or undefined or non-string themeIdentifier is provided.
onsuccesscallback [Function]- Optional Specifies the callback function that needs to be executed in case of success. This callback function is executed after the theme is created.

NOTE: The theme will be created but the successcallback is not called, if null or undefined successcallback is provided.
onerrorcallback [Function] - Optional Specifies the callback function that needs to be executed in case of error. This callback function has the following signature:

onerrorcallback (errorcode,errormessage)

    • errorcode - the error code thrown if there was a problem while creating the theme
    • errormessage - the error message that corresponds to the error code.

As an example, here is a set of values that you can specify for the following applicable properties of a Button widget.

Property Value
"wtype" "Button"
"bg_type" "one"
"background_color" "ff000000"
"font_weight" "bold"
"font_size" 120
"font_color" "314e8900"
"font_name" "Arial-BoldMT"
"border_color" "9f9f9f00"
"border_width" 1
"border_style" "rc"
"shadow" {"x":0,"y":0,"br":0,"color":"00000000","inner":false}
"text_shadow" {"x":0,"y":0,"br":0,"color":"00000000"}
 

Example


function testCreateThemeFromJSONString() {
    function onsuccesscallback() {
        kony.print("Successfully created theme.");
    }

    function onerrorcallback(errorcode, errormessage) {
        kony.print("Unable to create theme.");
    }

    var jsonString = '{"metadata":{"currTheme":"MyTheme1", "themeState":"0"},
     "sknLbl1": {"background_color": "11111164", "bg_type": "one", 
     "border_color": "42424216", "border_style": "plain", 
     "border_type": 0, "border_width": 0, 
     "font_color": "33000016", "font_name": "iphoneSystem", 
     "font_size": 200, "font_style": "normal", 
     "font_weight": "normal", "isDefaultSkin": false, "wType": "Label"}}';
    kony.theme.createThemeFromJSONString(jsonString, "MyTheme1", onsuccesscallback, onerrorcallback);
}

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on iOS and Android platforms.

This API allows you to delete a specified theme in the application programmatically.

IMPORTANT: On all Platforms, pre-bundled themes in the application cannot be deleted, but only the themes created through createTheme API, which are in memory, can be deleted.

Syntax

kony.theme.deleteTheme(themeidentifier, onsuccesscallback, onerrorcallback);

Input Parameters

Parameter Description
themeidentifier [String] - Mandatory Specifies a string that denotes the theme ID. The specified theme will be deleted from the application.
onsuccesscallback [Function] - Mandatory Specifies the callback function that needs to be executed in case of success. This callback function is executed after the theme is deleted.
onerrorcallback [Function] - Mandatory Specifies the callback function that needs to be executed in case of error. This callback function has the following signature:

onerrorcallback (errorcode,errormessage)

    • errorcode - the error code thrown if there was a problem while creating the theme
    • errormessage - the error message that corresponds to the error code.

Example


kony.theme.deleteTheme ("green");

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on all platforms.

This API returns all the themes available in the application.

Syntax

kony.theme.getAllThemes();

Input Parameters

None

Example


var themes = kony.theme.getAllThemes();
alert("No Of themes are " + themes.length);

Return Values

Return Value Description
JavaScript: Array Returns an array with a list of all theme Identifiers available in the application.

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on all platforms.

This API returns the current theme that is applied to the application.

Syntax

kony.theme.getCurrentTheme();

Input Parameters

None

Example

var crntTheme = kony.theme.getCurrentTheme();
alert("current theme is:" + crntTheme+" And the type is " + typeof(crntTheme));

Return Values

Return Value Description
themeID[String] Returns the identifier of the current theme that is applied to the application

 

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on all platforms.

This API returns the meta data of the current theme in the application.

Syntax

kony.theme.getCurrentThemeData();

Input Parameters

None

Example


function onsuccesscallback() {
    kony.theme.setCurrentTheme("MyTheme1", onsuccesscallbacktheme1, onerrorcallbacktheme1);
    kony.print(kony.theme.getCurrentThemeData());
}

function onerrorcallback(errorcode, errormessage) {
    kony.print("Unable to create theme.");
}

function fun_createTheme_and_set() {
    var jsonString = '{"metadata":{"currTheme":"MyTheme1", "themeState":"0"},
      "sknLbl1": {"background_color": "11111164", "bg_type": "one", 
      "border_color": "42424216", "border_style": "plain", 
      "border_type": 0, "border_width": 0, 
      "font_color": "33000016", "font_name": "iphoneSystem", 
      "font_size": 200, "font_style": "normal", 
      "font_weight": "normal", "isDefaultSkin": false, "wType": "Label"}}';
    kony.theme.createThemeFromJSONString(jsonString, "MyTheme1", onsuccesscallback, onerrorcallback);
}

Return Values

Return Value Description
metadata [Object] Returns an object that contains the metadata of the current theme in the application. In each theme, you can store the metadata (additional key, values) relevant for the theme by using the standard "metadata" key and the same can be read programmatically by using kony.theme.getCurrentThemeData API.

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on all platforms.

For Desktop Web, this API will always return null. As theme files are converted into CSS, the platform cannot have custom structures/variables in CSS files as browsers will fail to parse them.

This API allows you to check the existence of specific theme in the application.

Syntax

kony.theme.isThemePresent(themeidentifier);

Input Parameters

Parameter Description
themeidentifier [String] - Mandatory Specifies a string that represents a theme.

Example


var isThemePresent = kony.theme.isThemePresent("green");
alert("IS theme present ? True/False: " + isThemePresent);

Return Values

Return Value Description
status [Boolean] Returns the status of the execution of this API.
  • true - if the specified theme is present in the application.
  • false - if the specified theme does not exist in the application.

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on all platforms

This API allows you to apply a specified theme to the application at runtime.

Syntax

kony.theme.setCurrentTheme (themeidentifier, onsuccesscallback, onerrorcallback);

Input Parameters

Parameter Description
themeidentifier [String] - Mandatory Specifies a string that denotes the theme ID. The specified theme is applied to the application.
onsuccesscallback [Function] - Mandatory Specifies the callback function that needs to be executed in case of success. This callback function is executed after applying the specified theme.
onerrorcallback [Function] - Mandatory Specifies the callback function that needs to be executed in case of error. This callback function has the following parameters:
    • errorcode - the error code thrown if there was a problem while applying the specified theme
    • errormessage - the error message that corresponds to the error code.
This callback function is executed if there is an error while applying the specified theme.

Example


function onsuccesscallback() {
    alert("successfully set the theme to app");
}

function onerrorcallback(1900, "Skin Error") {
    alert("Skin does not exist");
}
kony.theme.setCurrentTheme("red", onsuccesscallback, onerrorcallback);

Exceptions

  • 1900- SkinError. This error occurs when there is an error related to skin.
  • Error - This error is thrown when there is a generic error.

Platform Availability

Available on all platforms.

This API allows you to modify the skin properties of a Skin Object at run time. All the widgets that use the specified skins are rendered with the modified values of the skin properties.

You can also modify the properties for multiple skin objects.

Syntax

kony.theme.setSkinsProperties({“skinName”: propertiesObject},...);

Input Parameters

Parameter Description
skinName [String]

A string that specifies the name of the skin for which the properties are to be changed. The skin must already be present in the current theme, and must be defined.

NOTE: If the specified skin is not present in the current theme, the skin properties will not be updated.
propertiesObject [JSON Object]

A JSON Object with key-value pair attributes. The keys are the names of pre-defined properties of the Skin. You can set the key-value pair attributes for the following Skin properties:
 

background [JSON Object]

The Background parameter contains the key-value pair attributes of the properties related to the background of the Skin. The background parameter is a JSON object that contains the following keys:

KeyValue
backgroundType [Constant]

Specifies the type of background (either singe color, two-step gradient, multi-step gradient, or image) to be applied. This parameter can have the following constant values:

  • kony.skin.BACKGROUND_TYPE_SINGLE_COLOR : Constant for single background color.
  • kony.skin.BACKGROUND_TYPE_TWO_STEP_GRADIENT: Constant for two-step gradient.
  • kony.skin.BACKGROUND_TYPE_MULTI_STEP_GRADIENT: Constant for multi-step gradient.
  • kony.skin.BACKGROUND_TYPE_IMAGE: Constant for the background image.

NOTE: If you do not specify a value for this parameter, the background property of the specified skin is not updated.

backgroundColor [Constant or Hex]

Specifies the color (single color) for the background. The value of this parameter can be a hexadecimal number (in String format) that represents a color or a color constant that is defined at the theme level.

NOTE:
  • Colors can be specified using a 6 digit or an 8-digit hex value with alpha position. For example, ffff65 or ffffff00.
  • When the 4-byte color format (RGBA) string is used, an alpha (A) value of 65 specifies that the color is transparent. If the value is 00, the color is opaque. The Alpha value is in percentage and must be given in the hexadecimal value for the color (100% in hexadecimal value is 65).
    For example, red complete opaque is FF000000. Red complete transparent is FF000065. The values 0x and # are not allowed in the string.
  • A color constant is a String that is defined at the theme level. Ensure that you append the $ symbol at the beginning of the color constant.
backgroundColorTwoStepGradient [JSON Object]

A JSON Object that specifies the two-step gradient color for the background. The backgroundColorTwoStepGradient object contains the following keys:

topColor [Constant or Hex]: Specifies the top color of the two-step gradient. The value of this parameter can be a hexadecimal number (in String format) that represents a color or a color constant that is defined at the theme level.

bottomColor [Constant or Hex]: Specifies the bottom color of the two-step gradient. The value of this parameter can be a hexadecimal number (in String format) that represents a color or a color constant that is defined at the theme level.

NOTE:
  • Colors can be specified using a 6 digit or an 8-digit hex value with alpha position. For example, ffff65 or ffffff00.
  • When the 4-byte color format (RGBA) string is used, an alpha (A) value of 65 specifies that the color is transparent. If the value is 00, the color is opaque. The Alpha value is in percentage and must be given in the hexadecimal value for the color (100% in hexadecimal value is 65).
    For example, red complete opaque is FF000000. Red complete transparent is FF000065. The values 0x and # are not allowed in the string.
  • A color constant is a String that is defined at the theme level. Ensure that you append the $ symbol at the beginning of the color constant.

style [Constant]: Specifies the configuration style of the two-step gradient. This parameter can have the following constant values:

  • kony.skin.TWO_STEP_GRADIENT_STYLE_VERTICAL_GRADIENT: Constant for the vertical gradient style.
  • kony.skin.TWO_STEP_GRADIENT_STYLE_VERTICAL_SPLIT: Constant for the vertical split style.
  • kony.skin.TWO_STEP_GRADIENT_STYLE_HORIZONTAL_GRADIENT: Constant for the horizontal gradient style. This constant is only available on the Desktop Web channel.
  • kony.skin.TWO_STEP_GRADIENT_STYLE_HORIZONTAL_SPLIT: Constant for the horizontal split style. This constant is only available on the Desktop Web channel.
NOTE:
  • The default value of the style key is kony.skin.TWO_STEP_GRADIENT_STYLE_VERTICAL_GRADIENT.
  • If you do not provide values (or provide invalid values) for the topColor and bottomColor attributes, the backgroundColorTwoStepGradient property of the specified skin is not updated.
backgroundColorMultiStepGradient [JSON Object]

A JSON Object that specifies the multi-step gradient color for the background. The backgroundColorMultiStepGradient object contains the following keys:

gradientType [Constant]: Specifies the configuration type of the gradient. This parameter can have the following constant values:

  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_TOP: Constant for the gradient type toTop.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_RIGHT: Constant for the gradient type toRight.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_BOTTOM: Constant for the gradient type toBottom.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_LEFT: Constant for the gradient type toLeft.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_CUSTOM: Constant for the gradient type custom.
    For the custom gradient type, you must specify the angle by using the angle property.

angle [Number]: Specifies the angle for the gradient in degrees, counted counter-clockwise. This property is only applicable for the custom gradient type.

colors [Array]: Specifies the colors for the multi-step gradient.  This parameter contains an array of hexadecimal numbers that represent the colors or constants defined at the theme level.

colorStops [Array]: Specifies the color stops for the multi-step gradient. Color Stops are the locations of the reference colors on the gradient, from 0 (the start of the gradient) to 100 (the final value of the gradient). This parameter contains an array of numbers that represent the color stops.

NOTE:
  • The default value of the gradientType key is kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_TOP.
  • Colors can be specified using a 6 digit or an 8-digit hex value with alpha position. For example, ffff65 or ffffff00.
  • When the 4-byte color format (RGBA) string is used, an alpha (A) value of 65 specifies that the color is transparent. If the value is 00, the color is opaque. The Alpha value is in percentage and must be given in the hexadecimal value for the color (100% in hexadecimal value is 65).
    For example, red complete opaque is FF000000. Red complete transparent is FF000065. The values 0x and # are not allowed in the string.
  • A color constant is a String that is defined at the theme level. Ensure that you append the $ symbol at the beginning of the color constant.
  • If you do not provide values (or provide invalid values) for the color and colorStops attributes, the backgroundColorMultiStepGradient property of the specified skin is not updated.
backgroundImage [String]Sets the specified image as the background.
 

border [JSON Object]

The Border parameter contains the key-value pair attributes of the properties related to the border of the Skin. The border parameter is a JSON object that contains the following keys:

KeyValue
borderType [Constant]

Specifies the type of border (either singe color or multi-step gradient) to be applied. This parameter can have the following constant values:

  • kony.skin.BORDER_TYPE_SINGLE_COLOR : Constant for single border color.
  • kony.skin.BORDER_TYPE_MULTI_STEP_GRADIENT: Constant for multi-step gradient.

    • NOTE: The kony.skin.BORDER_TYPE_MULTI_STEP_GRADIENT constant is only available on the Android and iOS channels.

borderColor [Constant or Hex]

Specifies the color (single color) for the border. The value of this parameter can be a hexadecimal number (in String format) that represents a color or a color constant that is defined at the theme level.

NOTE:
  • Colors can be specified using a 6 digit or an 8-digit hex value with alpha position. For example, ffff65 or ffffff00.
  • When the 4-byte color format (RGBA) string is used, an alpha (A) value of 65 specifies that the color is transparent. If the value is 00, the color is opaque. The Alpha value is in percentage and must be given in the hexadecimal value for the color (100% in hexadecimal value is 65).
    For example, red complete opaque is FF000000. Red complete transparent is FF000065. The values 0x and # are not allowed in the string.
  • A color constant is a String that is defined at the theme level. Ensure that you append the $ symbol at the beginning of the color constant.
borderColorGradient [JSON Object]

A JSON Object that specifies the multi-step gradient color for the border. The borderColorGradient object contains the following keys:

gradientType [Constant]: Specifies the configuration type of the gradient. This parameter can have the following constant values:

  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_TOP: Constant for the gradient type toTop.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_RIGHT: Constant for the gradient type toRight.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_BOTTOM: Constant for the gradient type toBottom.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_LEFT: Constant for the gradient type toLeft.
  • kony.skin.MULTI_STEP_GRADIENT_TYPE_CUSTOM: Constant for the gradient type custom.
    For the custom gradient type, you must specify the angle by using the angle property.

angle [Number]: Specifies the angle for the gradient. This property is only applicable for the custom gradient type.

colors [Array]: Specifies the colors for the multi-step gradient. This parameter contains an array of hexadecimal numbers that represent the colors or constants defined at the theme level.

colorStops [Array]: Specifies the color stops for the multi-step gradient. This parameter contains an array of numbers that represent the color stops.

NOTE:
  • This property is only available on the Android and iOS platforms.
  • The default value of the gradientType key is kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_TOP.
  • If you do not provide values (or provide invalid values) for the color and colorStops attributes, the borderColorGradient property of the specified skin is not updated.
borderWidth [JSON Object or Number]

Specifies the width of the border.

NOTE: The Desktop Web platform supports both Number and JSON Object (with the top, bottom, right, and left keys) values for the borderWidth parameter. The Android and iOS platforms support only Number values for the borderWidth parameter.

borderStyle [Constant]

Specifies the border style of the border for the widget. This parameter can have the following constant values:

  • kony.skin.BORDER_STYLE_PLAIN: Constant for the plain border style.
  • kony.skin.BORDER_STYLE_ROUNDED_CORNER: Constant for the rounded corner style.
  • kony.skin.BORDER_STYLE_COMPLETE_ROUNDED_CORNER: Constant for the complete rounded corner style.
  • kony.skin.BORDER_STYLE_CUSTOM: Constant for the custom border style.
NOTE:
  • For Android and iOS apps, the cornerRadius property is only applicable when the borderStyle is kony.skin.BORDER_STYLE_CUSTOM. For Desktop Web apps, the cornerRadius property is only applicable when the borderStyle is kony.skin.BORDER_STYLE_ROUNDED_CORNER.
  • The borderStyle parameter is only available on the Android and iOS platforms.
cornerRadius [JSON Object or Number]

Specifies the radius of the border.

NOTE:
  • For Android and iOS apps, the cornerRadius property is only applicable when the borderStyle is kony.skin.BORDER_STYLE_CUSTOM. For Desktop Web apps, the cornerRadius property is only applicable when the borderStyle is kony.skin.BORDER_STYLE_ROUNDED_CORNER.
  • The Android and Desktop Web platforms support both Number and JSON Object (with the top, bottom, right, and left keys) values for the cornerRadius parameter. The iOS platform supports only Number values for the cornerRadius parameter.
 

fonts [JSON Object]

The Fonts parameter contains the key-value pair attributes of the properties related to the fonts of the Skin. The fonts parameter is a JSON object that contains the following keys:

KeyValue
fontColor [Constant or Hex]

Specifies the color for the font. The value of this parameter can be a hexadecimal number (in String format) that represents a color or a color constant that is defined at the theme level.

NOTE:
  • Colors can be specified using a 6 digit or an 8-digit hex value with alpha position. For example, ffff65 or ffffff00.
  • When the 4-byte color format (RGBA) string is used, an alpha (A) value of 65 specifies that the color is transparent. If the value is 00, the color is opaque. The Alpha value is in percentage and must be given in the hexadecimal value for the color (100% in hexadecimal value is 65).
    For example, red complete opaque is FF000000. Red complete transparent is FF000065. The values 0x and # are not allowed in the string.
  • A color constant is a String that is defined at the theme level. Ensure that you append the $ symbol at the beginning of the color constant.
fontSize [Number]Specifies the font size in percentage (%) units.
fontFamily [String]Specifies the font family for the font. You must specify the font family based on the platform being used.
fontStyle [Constant]

Specifies the font style. This parameter can have the following constant values:

  • kony.skin.FONT_STYLE_NONE: Constant for the normal font style.
  • kony.skin.FONT_STYLE_ITALIC: Constant for the italic font style.
  • kony.skin.FONT_STYLE_UNDERLINE: Constant for the underline font style.

NOTE: The fontStyle parameter is only available on the Android and Desktop Web platforms.

fontWeight [Constant]

Specifies the weight of the font. This parameter can have the following constant values:

  • kony.skin.FONT_WEIGHT_NORMAL: Constant for the normal font weight.
  • kony.skin.FONT_WEIGHT_BOLD: Constant for the bold font weight.

NOTE: The fontWeight parameter is only available on the Android and Desktop Web platforms.

 

shadow [JSON Object]

The Shadow parameter contains the key-value pair attributes of the properties related to the shadow of the Skin. The shadow parameter is a JSON object that contains the following keys:

KeyValue
shadowRadius [Number]

Specifies the blur value for the shadow in pixels.

shadowColor [Constant or Hex]

Specifies the color for the shadow. The value of this parameter can be a hexadecimal number (in String format) that represents a color or a color constant that is defined at the theme level.

NOTE:
  • If you do not provide a value (or provide an invalid value) for the shadowColor attribute, the shadow property of the specified skin is not updated.
  • Colors can be specified using a 6 digit or an 8-digit hex value with alpha position. For example, ffff65 or ffffff00.
  • When the 4-byte color format (RGBA) string is used, an alpha (A) value of 65 specifies that the color is transparent. If the value is 00, the color is opaque. The Alpha value is in percentage and must be given in the hexadecimal value for the color (100% in hexadecimal value is 65).
    For example, red complete opaque is FF000000. Red complete transparent is FF000065. The values 0x and # are not allowed in the string.
  • A color constant is a String that is defined at the theme level. Ensure that you append the $ symbol at the beginning of the color constant.
shadowOffset [JSON Object]

A JSON Object that specifies the offset value for the shadow. The JSON Object contains the X-coordinate and Y-coordinates for the offset.

The values for the X and Y coordinates must be provided in the following format:
{x: Number value in px, y: Number value in px}

NOTE: On the Android platform, for the child widgets of a Form, the shadow appears only when the clipBounds property is disabled for the parent Form.

textShadow [JSON Object]

The Text Shadow parameter contains the key-value pair attributes of the properties related to the text shadow of the Skin. The textshadow parameter is a JSON object that contains the following keys:

KeyValue
textShadowRadius [Number]

Specifies the blur value for the text shadow in pixels.

textShadowColor [Constant or Hex]

Specifies the color for the text shadow. The value of this parameter can be a hexadecimal number (in String format) that represents a color or a color constant that is defined at the theme level.

NOTE:
  • If you do not provide a value (or provide an invalid value) for the textShadowColor attribute, the textShadow property of the specified skin is not updated.
  • Colors can be specified using a 6 digit or an 8-digit hex value with alpha position. For example, ffff65 or ffffff00.
  • When the 4-byte color format (RGBA) string is used, an alpha (A) value of 65 specifies that the color is transparent. If the value is 00, the color is opaque. The Alpha value is in percentage and must be given in the hexadecimal value for the color (100% in hexadecimal value is 65).
    For example, red complete opaque is FF000000. Red complete transparent is FF000065. The values 0x and # are not allowed in the string.
  • A color constant is a String that is defined at the theme level. Ensure that you append the $ symbol at the beginning of the color constant.
textShadowOffset [JSON Object]

A JSON Object that specifies the offset value for the text shadow. The JSON Object contains the X-coordinate and Y-coordinates for the offset.

The values for the X and Y coordinates must be provided in the following format:
{x: Number value in px, y: Number value in px}

 

Example 1


var skinPropertiesObj = {
    background: {
        backgroundType: kony.skin.BACKGROUND_TYPE_MULTI_STEP_GRADIENT,
        backgroundColorMultiStepGradient : {
            gradientType: kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_TOP,
            colors: ["ea5075", "f1fa70", "eefd04"],
            colorStops: [0, 90, 100]
        },
    },
    border: {
        borderType: kony.skin.BORDER_TYPE_SINGLE_COLOR,
        borderColor: "ea5075",
        borderStyle: kony.skin.BORDER_STYLE_PLAIN,
        borderWidth: 50
    },
    fonts: {
        fontColor: "ea5075",
        fontFamily: "Serif",
        fontSize: '100',
        fontStyle: kony.skin.FONT_STYLE_NONE,
        fontWeight: kony.skin.FONT_WEIGHT_NORMAL
    },
    shadow: {
        shadowRadius: 2,
        shadowColor: "ea5075",
        shadowOffset: {
            x: 4,
            y: 25
        }
    }
    textShadow: {
        textShadowRadius: 5,
        textShadowColor: "ea5075",
        textShadowOffset: {
            x: 20,
            y: 4
        }
    }
kony.theme.setSkinsProperties({“blueSkinWithBorder”:skinPropertiesObj});

Example 2


var skinPropertiesObj1 = {
    background: {
        backgroundType: kony.skin.BACKGROUND_TYPE_MULTI_STEP_GRADIENT,
        backgroundColorMultiStepGradient : {
            gradientType: kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_TOP,
            colors: ["ea5075", "f1fa70", "eefd04"],
            colorStops: [0, 90, 100]
        },
    },
    border: {
        borderType: kony.skin.BORDER_TYPE_SINGLE_COLOR,
        borderColor: "ea5075",
        borderStyle: kony.skin.BORDER_STYLE_PLAIN,
        borderWidth: 3
    },
    fonts: {
        fontColor: "ea5075",
        fontFamily: "Serif",
        fontSize: '100',
        fontStyle: kony.skin.FONT_STYLE_NONE,
        fontWeight: kony.skin.FONT_WEIGHT_NORMAL
    },
    shadow: {
        shadowRadius: 2,
        shadowColor: "ea5075",
        shadowOffset: {
            x: 4,
            y: 25
        }
    }
    textShadow: {
        textShadowRadius: 5,
        textShadowColor: "ea5075",
        textShadowOffset: {
            x: 20,
            y: 4
        }
    }

var skinPropertiesObj2 = {
    background: {
        backgroundType: kony.skin.BACKGROUND_TYPE_MULTI_STEP_GRADIENT,
        backgroundColorMultiStepGradient : {
            gradientType: kony.skin.MULTI_STEP_GRADIENT_TYPE_TO_TOP,
            colors: ["fd0404", "f1fa70", "ea5075"],
            colorStops: [0, 30, 90]
        },
    },
    border: {
        borderType: kony.skin.BORDER_TYPE_SINGLE_COLOR,
        borderColor: "f1fa70",
        borderStyle: kony.skin.BORDER_STYLE_PLAIN,
        borderWidth: 5
    },
    fonts: {
        fontColor: "fd0404",
        fontFamily: "Helvetica",
        fontSize: '80',
        fontStyle: kony.skin.FONT_STYLE_NONE,
        fontWeight: kony.skin.FONT_WEIGHT_BOLD
    },
    shadow: {
        shadowRadius: 5,
        shadowColor: "fd0404",
        shadowOffset: {
            x: 14,
            y: 2
        }
    }
    textShadow: {
        textShadowRadius: 2,
        textShadowColor: "fd0404",
        textShadowOffset: {
            x: 2,
            y: 24
        }
    }
kony.theme.setSkinsProperties({“blueSkinWithBorder”:skinPropertiesObj1, "redSkinWithBorder":skinPropertiesObj2});

Return Values

None

Remarks

  • Ensure that you provide appropriate values for all the properties and keys. If you provide invalid values, the properties will not be updated.
  • Using this API affects the performance of the app.
  • When you invoke this API in an Android or iOS app, the Form is refreshed for the changes to reflect on the canvas.

Platform Availability

  • Android
  • iOS
  • Desktop Web (Not available on Desktop Web Legacy SDK)