content element

Supported platforms

  • yes BlackBerry OS: 5.0 - 7.0
  • yes BlackBerry PlayBook OS: 2.0+
  • yes BlackBerry 10 OS

Syntax

<content src="string" 
         rim:allowInvokeParams=["true" | "false"]
         type="string"
         charset="string" />

Description

The <content> element specifies the start page that the BlackBerry WebWorks application displays when it runs. The start page can contain the web address of a file that is located outside of the application archive. If you specify a page that is outside of the application archive, you must allow access to the address using the <access> element.

Parent elements

<widget>

Child elements

Can contain <rim:background> .

Occurrences

One

Attributes

You can use the following attributes in the <content> element:

Attribute

Description

Platform
src

The src attribute specifies the source HTML file in the application archive.

This attribute is required.

  • BB OS 5.0 - 7.0
  • PB 2.0+
  • BB10
rim:allowInvokeParams

The rim:allowInvokeParams attribute specifies that parameters can be passed to your application when it is invoked from another application.

By default, parameters cannot be passed to your application.

This attribute is optional.

  • BB OS 5.0 - 7.0
type

The type attribute specifies the MIME type of the file that is specified in the src attribute.

This attribute is optional.

  • BB OS 5.0 - 7.0
  • PB 2.0+
  • BB10
charset

The charset attribute specifies the character set that is used by the file that is specified in the src attribute.

This attribute is optional.

  • BB OS 5.0 - 7.0
  • PB 2.0+
  • BB10

Examples: Specifying a start page

For BlackBerry PlayBook OS and BlackBerry 10 OS applications:
<content src="startpage.html" />
For BlackBerry 7 or earlier :
<content src="startpage.html" rim:allowInvokeParams="true" />