Taskbar

Taskbar is an app designed to provide users with quick and easy access to apps and custom workflows on the platform. With Taskbar, users can access shortcuts to their favorite apps and streamline their workflow. Currently, Taskbar is limited to app shortcuts, and each app is responsible for registering its own shortcut.

How to install

1. Install as developer dependency

   npm install -D @webprovisions-registry/alliance-app-taskbar --registry https://registry.webprovisions.io

2. Add app to your Alliance configuration file.

   // alliance.config.ts
   import { defineConfig } from '@telia-ace/alliance-framework/config';
   
   export default defineConfig({
       server: {
           apps: ['@webprovisions-registry/alliance-app-taskbar'],
       },
   });

Capabilities

addAction

Adds a button to the Taskbar that launches the targeted app when clicked.

Example

// app.ts
import { runCapability } from '@telia-ace/alliance-framework';
import { aiRobot } from '@telia-ace/alliance-ui/voca/icons';

runCapability('taskbar', 'addAction', {
    item: {
        icon: aiRobot,
        app: 'my-app',
    },
});

Args

Property	Type	Required	Default	Description
item	Item	Yes	Item to add to the taskbar.

Item

Property	Type	Required	Default	Description
app	string	Yes	App to launch.
icon	VocaIcon	Yes	Voca Icon to display in the button.

select-workspace

Displays a popup element at given coordinates for viewing selected workspace and selecting one.

Example

// app.ts
runCapability('taskbar', 'select-workspace', { x: 100, y: 200 });

Args

Property	Type	Required	Default	Description
x	Number	Yes		Pass coordinates of where the workspace switch should be displayed from. Could be coordinates for mouse-click of the display button.
y	Number	Yes		Pass coordinates of where the workspace switch should be displayed from. Could be coordinates for mouse-click of the display button.

Result

Nothing is returned.

Managed Objects

No available managed objects.