Comment on page
Applications-Nav Service
The Applications navigation section is found at the bottom of the left-hand sidebar of the Symphony client workspace. Use the
applications-nav
service to create a navigation item for your application:// To use the applications-nav service, you must subscribe to it from your application
var navService = SYMPHONY.services.subscribe("applications-nav");
The following methods are available on the
applications-nav
service:- add
- remove
- count
- rename
- focus
Add a new navigation item to the Applications section of the left-hand sidebar:
function add(id, title, serviceName)
Parameter | Type | Description |
id | String | A unique id for this navigation item (must be unique across all navigation items of a given application) |
Either title or {title, icon} | String or Object | Either the title of the left navigation item as a string or an object with the keys title and icon where the value of title is a string and the value of icon is the url of a square SVG (recommended), or the url of a square png/jpg image. Recommended size is 32x32. |
serviceName | String | The name of a local service implemented by your application that will be invoked when a user action is performed relating to the application navigation |
Note: You must implement the
select
method on your application service in order to handle clicks on the created left navigation item.// The application service that will be used to handle left navigation item clicks
var helloControllerService = SYMPHONY.services.register("hello:controller");
navService.add("hello-nav", "Hello World App", "hello:controller");
// Implement the select method on your application service
helloControllerService.implement({
select: function(id) {
if (id == "hello-nav") {
console.log("hello-nav was selected.");
}
}
});
Remove an existing application navigation item:
function remove(id)
Parameter | Type | Description |
id | String | The id of the navigation item that should be removed |
navService.remove('hello-nav');
Set the badge (notification) count on an application navigation item:
function count(id, count)
Parameter | Type | Description |
id | String | The id of the navigation item that should have its count updated |
count | Integer | The new badge count number. Specifying 0 will hide the badge count. |
navService.count("hello-nav", count);
Change the title of an existing application navigation item.
Note that this only changes the title of a specific navigation item -- not to all navigation items created by the application:
function rename(id, title)
Parameter | Type | Description |
id | String | The id of the navigation item that should be renamed |
Either title or {title, icon} | String or Object | Either the title of the left navigation item as a string or an object with the keys title and icon where the value of title is a string and the value of icon is the url of a square SVG (recommended), or the url of a square png/jpg image. Recommended size is 32x32. |
navService.rename('hello-nav', 'New Left Nav Title');
Focus an existing application navigation item:
function focus(id)
Parameter | Type | Description |
id | String | The id of the application navigation item to focus |
navService.focus("hello-nav");
Last modified 1mo ago