ui/activity

Declare and launch XML-layout Activity subclasses: set the app entry activity or push additional screens.

Table of contents

Classes

• Activity

Interfaces

• ActivityLifecycle
• StatusBarConfig

Types

• ActivityClass

Constants

• activityLifecycle

Functions

• setMainActivity
• startActivity

Types

ActivityClass

ActivityClass<T>(): T

Type parameters

Name	Constraint
T	extends Activity

Type declaration

• new ActivityClass(): T

Returns

T

Constants

activityLifecycle

• activityLifecycle: ActivityLifecycle

Global lifecycle event emitter for the current Activity stack (see interface doc for on(...) events).

Functions

setMainActivity

setMainActivity<T extends Activity>(activityClass: ActivityClass<T>): void

Registers the main activity: the entry screen created automatically when the app starts.

Example

"nodejs";
const { Activity, setMainActivity } = require("ui/activity");

class MainActivity extends Activity {
  get layoutXml() {
    return `
            <vertical>
                <text text="Hello World" />
            </vertical>
        `;
  }
}

setMainActivity(MainActivity);

Type parameters

Name	Constraint	Description
T	extends Activity	Concrete activity subclass.

Parameters

Name	Type	Description
activityClass	ActivityClass<T>	Constructor for your Activity subclass.

Returns

void

startActivity

startActivity<T extends Activity>(activityClass: ActivityClass<T>, options?: IntentOptions): void

Starts another Activity. Pass IntentOptions (e.g. extras) to configure the launch, similar to Android Intent flags and payload.

Example

"nodejs";
const { Activity, startActivity } = require("ui/activity");

class SecondActivity extends Activity {
  get layoutXml() {
    return `
            <vertical>
                <text text="Second Activity" />
            </vertical>
        `;
  }
}

startActivity(SecondActivity);

startActivity(SecondActivity, {
  extras: {
    message: "Hello from MainActivity",
  },
});

Type parameters

Name	Constraint	Description
T	extends Activity	Activity subclass type.

Parameters

Name	Type	Description
activityClass	ActivityClass<T>	Activity constructor to launch.
options?	IntentOptions	Optional intent-style launch options (extras, flags, etc.).

Returns

void