<rim:permit>

Syntax:

<rim:permissions>
    <rim:permit>permission_string</rim:permit>
</rim:permissions>

Description:

The <rim:permit> element specifies permission access to various features in a HTML5 app.

Occurrences:

One or more.

Parent elements:

<rim:permissions>

Child elements:

None.

Content:

A string value representing a valid permission value. For a list of permissions and their descriptions, see Authorization Manager.

Attributes:

None.

Permissions:

The permissions (or capabilities) you can use are defined using the Authorization Manager (authman). For information about the available permissions, see Authorization Manager in the System Services Reference.

Example:

The following example shows how to give an app access to geolocation.

<widget xmlns:rim="http://www.blackberry.com/ns/widgets">
...
...
    <rim:permissions>
        <rim:permit>read_geolocation</rim:permit>
    </rim:permissions>
...
...
<widget>