This lesson is part of the Perspective Pages, Views, and Containers course. You can browse the rest of the lessons below.

LESSON LIST

Autoplay Off
Take topic challenge

Description

The Perspective Session Application (App) Bar contains useful information about the session.

Video recorded using: Ignition 8.0.13

Transcript

(open in window)

[00:00] While viewing a Perspective session you may have noticed this little button in the lower right-hand corner. If you click on it, you'll see a bar appear. This is the app bar, or application bar. This is a small piece of the interface that allows you to view some meta and diagnostic information about the session, as well as the gateway hosting the session. From this bar there are a couple of other buttons. Starting on the far left-hand side here, if I click on the Ignition logo, and then scroll down a little bit, we'll see some information about the various modules that are installed on the gateway. I'll close this here, and the center button will display the name of the gateway, that's hosting the project. If you click on it you'll see some options here, including some information about your gateway, by clicking right here where it says Connected. I can also switch over and see some information about the project such as the last time it was updated. I'll back out of this window here. You'll also see that there's a little SIGN IN button. Now you'll only see this if you have an identity provider configured for the project. By clicking this button I can sign in to the session. Now if you've watched the other videos here, you know that there's a couple of different ways to sign in, be it the component action, or by setting security-level access. This is just another option. Now, say you didn't want the app bar to appear in the session, or even the little button that calls the app bar. Fortunately, there's an easy way to do that. I'm going to switch over to my designer. While in the designer, if you're under the Perspective workspace, if you look under SESSION PROPS there's an appBar object, and under that is a togglePosition property. By default, togglePosition is set to right, which means the little button we click to call that bar will be placed in the lower right-hand corner. Now I can instead change this to either the left side or just hide it entirely. So if I select hidden and then save my project, I can switch back over to my session, and you'll notice that I don't have the little button anymore. So now I can't call the app bar for my session. Now, say I want to conditionally call the app bar, say for troubleshooting reasons. There are a couple of ways to do this. I'm going to head back to my designer. And for that togglePosition property we could always just place a binding on here that checks some criteria. Alternatively, we could give our users the ability to call the app bar if they needed it. So I could switch over to a view, and I do have this little ToggleSwitch I added to this view. So my goal here is I want my users to be able to click on the ToggleSwitch and then call the app bar. This is easy enough to do because there's actually a page property that allows you to call the app bar. What I'm going to do here is I'm going to place a binding on the selected property, and I'm going to select a property binding. So if I were to browse properties on the page object, if I were to expand this, we do have some properties here, and we have our appBarVisible property. So if I write a true value to this, it calls the app bar, and of course if I write a false value it hides the app bar. Even better, writing to this property on the page object will show the app bar only for this one session. So if I change the value on this property it won't make the app bar appear in other sessions. So I can click on OK here, and I want this binding to write to that property so I will make sure this is bidirectional, I'll hit OK, I'll save my project, and if we switch back, so again, I didn't add the built-in app bar toggle, but instead I can throw my custom one, and it will summon the app bar.

You are editing this transcript.

Make any corrections to improve this transcript. We'll review any changes before posting them.