Microsoft 365 Community Office Add-ins, 10 Mar 2021

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: PowerPoint ribbon updates

Description

In this 6-minute Developer-focused demo, Lillian Liu – Senior Program Manager at Microsoft details features available in Office Online the week of March 15th, and that will be available for Desktop and Mac in May+. The new features shown: Allowing native controls, Setting tab location (to any location you want), and Setting focus for a tab. All functions accomplished in manifest with new elements. This PnP Community demo is taken from the Office Add-ins community call - March 2021, recorded on March 10, 2021.

Demo Presenter: Lillian Liu (Microsoft) | Sr. Program Manager

Supporting documents:
• Documentation - Integrate built-in Office buttons into custom control groups and tabs | https://docs.microsoft.com/en-us/office/dev/add-ins/design/built-in-button-integration
• Documentation - Position a custom tab on the ribbon | https://docs.microsoft.com/en-us/office/dev/add-ins/design/custom-tab-placement

Stay connected:
• Twitter https://twitter.com/microsoft365dev
• YouTube https://aka.ms/M365DevYouTube
• Blogs https://aka.ms/M365DevBlog

A

My name is lion um today, I'm gonna be talking about some new and exciting uh powerpoint ribbon, updates that uh we're gonna be pushing out. So just a quick recap. These are gonna, be available really soon so probably within the next week on office online, and we are gonna, be doing a fast, follow on desktop and mac and around the may time frame, we're just finishing up um coding this quarter, so um that's kind of accounting for roll out time.

A

So the features I'm going to be talking about today going to be allowing native controls in your ribbon being able to set your tab location to any location. You want and then also being able to set focus to that particular tab. So I'll go into that in a little bit more detail shortly, um and then we also have some docs available right now, so they are marked with preview, but um it is gaining very soon so uh these are all going to be accomplished through the manifest.

A

So we're going to be essentially extending um app commands um or the the node within your manifest, and from here you can designate the location you can designate whether you want to be importing any um any custom controls, and I will show a quick demo of that at the end.

A

So for the first feature for native buttons, um what this means is that you can now directly take any chunk from within the native ribbon and actually port that into your your own ribbon and you can mix and mingle those with your existing add-in controls. So we support both taking a whole group. So we can take paragraphs or you can also take a single control like bold and then you can kind of mix and mingle.

A

Those two together so and the manifest will be introduced into new elements and there will be a lookup table where you will be able to find the mapping of each control and group to their relevant ids. We don't um allow you to so yeah. Let's go something with restrictions.

A

If you import a a whole group, um we don't allow you to take out a specific button or um alter that group in any way. So, if you import that that uh that comes entirely and if you are using any enable disable apis, these will not work on the native buttons. um So a lot of them are contextual. So, for example like bold, that would be disabled until you highlight text and any um any controls that have that will obey their native instructions and you won't be able to actually control those.

A

uh So the second one is placement. So, as you may know, right now for tabs, um if you insert uh an add-in, the tab will default right to the end um so kind of at the. So you can see script lab here. um What this does is you can now insert that tab anywhere. You want um in between native tabs, so I can say um insert after or insert before. um So if we have an insert before tap home it'll go here, so it'll go between file and home um for this.

A

If we have any collisions. So if multiple add-ins want to be inserted in the same location, um the it'll be resolved by installation order, so um the last installed add-in will take that location and it'll just push all the other add-ons down, and what happens also is that we will take the natural order of the tab and what that means is that if the user goes and um right clicks and goes to runner manager and say I move my home tab down to the end of the line.

A

If you specify hey, I want to insert before tab home, we will take the natural order, so we will. We will take the order of home being near the near the front um so kind of unaltered and the last one is focus. So what this means is just like when you open up a document for the first time, you'll see the ribbon default over to home.

A

You can now. Your adam can now do this. So if you actually insert your add-in before the home tab, if the user closes that document and opens it again, the tab will automatically open to your add-in tab um just like it would do natively and just quickly for fallback options.

A

So if it isn't, um if the user is on a version of office that isn't that doesn't support this feature, um we will ignore the elements, so we will just pass the parts of the ribbon that we understand for that version, and you can also opt out of this by specifying the requirement set, in which case your adam will not show up for that version of office um and then just a quick demo. So I have a manifest open here. As you can see, um I have my extension point.

A

I have an insert before tap home and then I just have a bunch of native controls here and I've sign loaded the ad in here. So you can see. So I have my contoso add-in um you'll notice that this tab is in between fall and home, and I have a bunch of negative controls here that I have mix and mingle together.

A

That's the end of the demo really excited and looking forward to everyone trying this. Thank you.

A