The direction or edge (if closeBy = "edge") to search for possible closes.
For example, a frame that touches the right window edge can only be closed "to the right" in the horizontal direction or by it's left edge. Another way to think about it is the left edge is "collapsed" towards the "right".
Returns the information necessary to close a frame or frames (if force: true).
Can close by direction or by frame edge.
Closing A in the left direction or by it's right edge would close A and expand B.
Closing A in the right direction or by it's left edge is not possible, since it's left edge is a window edge.
A list of possible directions/edges can be given to attempt closing by those directions/edges in that order.
Frame closing does not always succeed:
force: false
(default)If two frames share a visual edge exactly, they can always be closed to either side.
force: true
If the visual edge contains multiple frames,
force: true
must be specified to be able to close them. Force is not guaranteed to succeed either though.There's two main scenarios to consider when we have multiple frames:
So, for example, here A & B can be force closed to the left since they share their left edge (vertically).
For this to succeed, the difference between the smallest frame and the next smallest frame must be greater than the minimum size.
For example, here, we have frames A, B, and C to the left of the visual edge. A and B are the smallest. A can be closed and the rest modified, but only if the difference between A and B is greater than the minimum size.