Button¶
The Button web part lets you configure a single or multiple buttons with hyper links and a personalised design
Designs¶
Buttons have a lot of variety for their display.
| Design 1 | Design 2 | Design 3 |
|---|---|---|
 |
 |
 |
Quick Configuration¶
Buttons can be configured with Display Text and a hyperlink.
- Button supports all Web Part Zones except "Full-width Sections"
- To add more buttons to the list click "+ Add new button" link and a new button will join the list
- Click a button to select it for editing.
- From here you can change the Display text and give it a hyperlink
- While buttons are selected to edit, you may have noticed a few little controls appear above them.
- These enable you to move the buttons position, or remove them
- Click the Bin icon to remove a button from the list.
- Click the up arrow to move a button up the list
- Click the down arrow to move a button down the list
While its possible to display buttons side by side, the control for moving them up and down the list remain just that. Please be aware, that "up" refers to their order in the list NOT their physical position on the page. For example: Moving the second button up the list will make it the first. Moving it down will make it the third.
- Click the pencil (edit) icon to reopen the panel if its closed or focused on other settings.
Full Configuration¶
Button¶
The following settings refer to an individual button and can be edited by clicking on a button while in edit mode.
| Option | Description | Required |
|---|---|---|
| Display Text | The text that is displayed on the button | No |
| Link URL | The link to a location for navigation | No |
Button Designs¶
Edit the webpart as you normally would to edit these settings.
| Option | Description | Required |
|---|---|---|
| Display Settings | ||
| Number of Buttons per row | Specify the number of buttons in a row from 1 to 8 | Yes |
| Gap Between Buttons | Specify how large the gap between the buttons is from X-Small to X-Large | Yes |
| Font Settings | ||
| Font Weight | Specify if the font is bold or normal | No |
| Italics | Specify if the font is Italic or normal | No |
| Font Size | Specify the font size from Small to X-Large | No |
| Font Colour | Set if the current site theme is used for Font Colour *if not see below | No |
| Custom Colour | Set a custom colour for the font *only appears if Font Colour is toggled to not use Theme | No |
| Text Shadow | Specify if the font should have a shadow | No |
| Shadow Colour | Set a colour for the text shadow *only appears if Text Shadow is toggled on. | No |
| Button Size | ||
| Height | Specify the height of the buttons, please note the value displayed is not the direct pixel height of a button but a representation of preferred height | No |
| Button Style | ||
| Button Style | Specify the edge style for the buttons, choices range between fully rounded, partially rounded, and square | No |
| Hover Effects | Specify if the buttons should have a Rollover/Hover animation | No |
| Background | Specify if the current site theme is used as the background. | No |
| Custom Colour | Set a colour for the button background to use *only appears if Background is toggled off | No |
| Button Border | Specify the thickness of the outside border of the buttons, from none at all, to large thickness | No |
| Shadow | Specify if the button should have a shadow or not | No |
| Shadow Colour | Set the colour the shadow uses *Only appears if Shadow is toggled on | No |
| Shadow Orientation | Specify which direction the shadow will cast in cardinal or inter-cardinal directions | No |
Config Repository¶
This web part supports use of the config repository, to allow users to save and load configurations of web parts with ease.
Loading a config file will populate the web part properties with properties from the incoming file.
SharePoint¶
Saving to SharePoint allows collaboration between users in a tenant.
The path the file is saved to is tenant-name/Site Assets/Mercury Assets/webpart-name.json.
Permissions¶
To save a file to SharePoint, edit permissions are required on the root Site Assets library.
To load a file from SharePoint, read permissions are required on the root Site Assets library.
OneDrive¶
Saving to OneDrive allows a user to save a file locally, this is the best option when a user does not have the required permissions to save to SharePoint.
The path the file is saved to is Mercury Assets/webpartname.json.