Skip to content

Commit 30ea854

Browse files
[3.2] docs(toolbar): Responsive Overflow Popup fixes (#882)
* [3.2] docs(toolbar): Responsive Overflow Popup fixes * Update components/toolbar/built-in-tools.md Co-authored-by: Dimo Dimov <[email protected]> * Update components/toolbar/built-in-tools.md Co-authored-by: Dimo Dimov <[email protected]> * Update components/toolbar/built-in-tools.md Co-authored-by: Dimo Dimov <[email protected]> * Update components/toolbar/overview.md Co-authored-by: Dimo Dimov <[email protected]> * Update components/toolbar/separators.md Co-authored-by: Dimo Dimov <[email protected]> * docs(toolbar):latest comment fix Co-authored-by: Dimo Dimov <[email protected]>
1 parent 1cfe489 commit 30ea854

File tree

3 files changed

+6
-11
lines changed

3 files changed

+6
-11
lines changed

components/toolbar/built-in-tools.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ The nested `ToolBarButton` tag exposes parameters that allow you to customize th
4141
| `ImageURL` | `string` | Adds an image to the button. You can provide an image url to this parameter. |
4242
| `SpriteClass` | `string` | Add a sprite class image to the button. Set this attribute to `k-icon MySpriteClass` where `MySpriteClass` defines the CSS rules for the sprite. |
4343
| `Overflow` | `ToolBarItemOverflow` enum <br /> (`Auto`) | Specifies whether the item will be hidden when the ToolBar is resized. |
44-
| `OverflowText` | `string` | If not specified, it will get the normal text of the item. (not valid for Separators) |
44+
| `OverflowText` | `string` | Defines the button text that will be shown only in the overflow popup. If not specified, it will get the default text of the item. |
4545
| `Title` | `string` | Maps to the `title` HTML attribute for the `<button>`. |
4646
| `Visible` | `bool` <br /> `true` | Specifies if the button will be visible in the toolbar. |
4747

@@ -102,7 +102,7 @@ The nested `ToolBarToggleButton` tag exposes parameters that allow you to custom
102102
| `Selected` | `bool` | Specifies whether the button is in selected state. You can use it with one and two-way data binding with the `SelectedChanged` event. For more information on how to handle the `SelectedChanged` event see the [Events]({%slug toolbar-events%}) article. |
103103
| `SpriteClass` | `string` | Add a sprite class image to the button. Set this attribute to `k-icon MySpriteClass` where `MySpriteClass` defines the CSS rules for the sprite. |
104104
| `Overflow` | `ToolBarItemOverflow` enum <br /> (`Auto`) | Specifies whether the item will be hidden when the ToolBar is resized. |
105-
| `OverflowText` | `string` | If not specified, it will get the normal text of the item. (not valid for Separators) |
105+
| `OverflowText` | `string` | Defines the button text that will be shown only in the overflow popup. If not specified, it will get the default text of the item. |
106106
| `Title` | `string` | Maps to the `title` HTML attribute for the `<button>`. |
107107
| `Visible` | `bool` <br /> `true` | Specifies if the button will be visible in the toolbar. |
108108

@@ -162,7 +162,7 @@ The nested `ToolBarButtonGroup` tag exposes parameters that allow you to customi
162162
| `Enabled` | `bool` <br /> `true` | Specifies if the group is clickable. |
163163
| `SelectionMode` | `ButtonGroupSelectionMode` enum <br /> `Single` | Specifies whether you can select one or multiple buttons from the group at the same time (applicable for `ToolBarToggleButton` instances inside it). |
164164
| `Overflow` | `ToolBarItemOverflow` enum <br /> (`Auto`) | Specifies whether the item will be hidden when the ToolBar is resized. |
165-
| `OverflowText` | `string` | If not specified, it will get the normal text of the item. (not valid for Separators) |
165+
| `OverflowText` | `string` | Defines the button text that will be shown only in the overflow popup. If not specified, it will get the default text of the item. |
166166
| `Visible` | `bool` <br /> `true` | Specifies if the group will be visible in the toolbar. |
167167
| `Width` | `string` | Allows you to control the width of the group. |
168168

components/toolbar/overview.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -87,14 +87,14 @@ The Blazor ToolBar provides parameters to configure the component:
8787

8888
| Parameter | Type | Description |
8989
| ----------- | ----------- | ----------- |
90-
| `Adaptive ` | `bool` | Toggles the overflow popup of the toolbar. Consistent with the chosen name for the pager. |
90+
| `Adaptive ` | `bool` | Toggles the overflow popup of the toolbar. Displays an additional anchor on the right of the toolbar, where it places all items which overflow from the toolbar. |
9191
| `Class` | `string` | The CSS class to be rendered on the main wrapping element of the ToolBar component, which is `<div class="k-toolbar">`. Use for [styling customizations]({%slug themes-override%}). |
9292

9393
## Example
9494

9595
The Blazor Toolbar has an option for adaptiveness. This option allows you to hide the items overflowing in a popup.
9696

97-
>We do **not** recommend using `ToolBarTemplateItem` with the responsive overflow popup as there is a high chance of breaking the popup.
97+
>When using `ToolBarTemplateItem` with the responsive overflow popup, the template inherits automatically `Overflow` - `ToolBarItemOverflow.Never` behavior.
9898
9999
>caption Responsive Overflow Popup
100100
@@ -137,10 +137,6 @@ The Blazor Toolbar has an option for adaptiveness. This option allows you to hid
137137
.toolbar-wrapper{
138138
width: @(Width.ToString() + "%");
139139
}
140-
141-
.toolbar-slider {
142-
padding: 0px 16px;
143-
}
144140
</style>
145141
````
146142

components/toolbar/separators.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ position: 5
1212

1313
You can visually separate the items in the Telerik ToolBar for Blazor. Depending on the needs of your application you can use of the following, or a combination of them:
1414

15-
* `ToolBarSeparator` - to separate two items with a solid line, add the `<ToolBarSeparator>` tag between them.
15+
* `ToolBarSeparator` - to separate two items with a solid line, add the `<ToolBarSeparator>` tag between them. The separator exposes an `Overflow` parameter to specify whether the separator will be hidden when the adaptive ToolBar is resized. Its type is `ToolBarItemOverflow` enum and the default value is `Auto`.
1616

1717
* `ToolBarSpacer` - defines empty space in the toolbar which separates the items. The space between the items is automatically calculated to fit the width of the ToolBar. For example, one spacer in the middle of the items will push the second part of items to the right-hand side of the toolbar.
1818

@@ -38,7 +38,6 @@ You can visually separate the items in the Telerik ToolBar for Blazor. Depending
3838
<ToolBarButton Icon="undo">Undo</ToolBarButton>
3939
</TelerikToolBar>
4040
41-
4241
@code {
4342
public bool Selected { get; set; } = true;
4443
}

0 commit comments

Comments
 (0)