Skip to content

Commit c540597

Browse files
authored
Merge pull request #1856 from IgniteUI/gedinakova/resize-target-border
feat(*): Added resize target highlighting details
2 parents 58d9247 + b7b09f8 commit c540597

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

doc/en/components/layouts/dock-manager-customization.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,26 @@ Try it in the example below:
9999

100100
`sample="/layouts/dock-manager/contained-in-boundaries", height="600", alt="{Platform} Dock Manager Contained in Boundaries Example"`
101101

102+
## Highlight Resizing Panes
103+
104+
When users resize panes by dragging a splitter, it is not always obvious which panes are affected, especially in more complex layouts. To make this interaction clearer, the Dock Manager can draw a border around the panes that are currently being resized. This visual cue helps users immediately understand which parts of the layout will grow or shrink as they move the splitter.
105+
106+
You can enable and style this behavior by configuring the following CSS custom properties on the Dock Manager host element (or a parent element):
107+
108+
- `--igc-resize-target-border-color` – controls the color of the resize target border.
109+
- `--igc-resize-target-border-width` – controls the thickness of the border (for example, `2px`).
110+
- `--igc-resize-target-border-style` – controls the border style (for example, `solid`, `dashed`).
111+
112+
```css
113+
igc-dockmanager {
114+
--igc-resize-target-border-color: #0078d4;
115+
--igc-resize-target-border-width: 2px;
116+
--igc-resize-target-border-style: solid;
117+
}
118+
```
119+
120+
Once these variables are set, any pane that is impacted by a splitter drag will be wrapped with the configured border for the duration of the resize operation, giving users clear, immediate feedback about which panes are being adjusted.
121+
102122
## Split Panes Fixed Size Mode
103123

104124
By default, the size of a pane is relative to the sizes of its sibling panes and defaults to 100. If you have two sibling panes, where the first one has its size set to 400 and the second one - to 200, the first will be twice the size of the second one and these two panes would fill up all the available space.

0 commit comments

Comments
 (0)