PlantUML组件图布局控制：硬件架构图横向扩展问题求助

I get it—when your hardware architecture diagram grows in complexity, PlantUML’s tendency to stack frames left-to-right can make the whole thing stretch horizontally into an unreadable mess. Let’s break down practical fixes to force a clean top-to-bottom layout that scales with your diagram.

Core Issues to Address #

PlantUML’s auto-layout engine prioritizes minimizing connection length, which often leads to horizontal stacking when you add multiple frames without explicit guidance. Even if you set top to bottom direction, unstructured frame placement can still override this behavior.

Solution 1: Force Vertical Breaks with || #

The simplest quick fix is to use the || command to tell PlantUML to start a new vertical "row" (effectively wrapping frames downwards). This works great for straightforward linear layouts:

@startuml
skinparam defaultTextAlignment center
top to bottom direction

' First frame group
frame Pippo as pippo {
  frame Pluto as pluto {
    component Paperino
  }
}

' Force a vertical line break
||

' Second frame group
frame Topolino as topolino {
  component Minnie
}

' Another break for the next set
||

frame Paperina as paperina {
  component Qui
  component Quo
  component Qua
}
@enduml

Solution 2: Use a Vertically-Layouted Container #

For more structured diagrams, wrap all your frames in a parent package with layout vertical explicitly set. This tells PlantUML to stack all child elements top-to-bottom by default:

@startuml
skinparam defaultTextAlignment center
top to bottom direction

' Parent container enforcing vertical layout
package "Hardware Architecture" <<frame>> {
  layout vertical
  
  frame Pippo as pippo {
    frame Pluto as pluto {
      component Paperino
    }
  }
  
  frame Topolino as topolino {
    component Minnie
  }
  
  frame Paperina as paperina {
    component Qui
    component Quo
    component Qua
  }
}
@enduml

Solution 3: Guide Layout with Explicit Connections #

If your diagram has logical connections between frames, use directional connectors (like --down--) to nudge PlantUML into vertical stacking. The layout engine will respect the connection direction when positioning elements:

@startuml
skinparam defaultTextAlignment center
top to bottom direction

frame Pippo as pippo {
  frame Pluto as pluto {
    component Paperino
  }
}

frame Topolino as topolino {
  component Minnie
}

' Explicit downward connection to force vertical placement
pippo --down--> topolino

frame Paperina as paperina {
  component Qui
  component Quo
  component Qua
}

topolino --down--> paperina
@enduml

Solution 4: Precise Manual Positioning (For Fine-Tuning) #

For full control over element placement, use the pos(x,y) attribute to define exact relative coordinates (adjust values based on your diagram’s size):

@startuml
skinparam defaultTextAlignment center
top to bottom direction

frame Pippo as pippo {
  frame Pluto as pluto {
    component Paperino
  }
} pos(0, 0)

frame Topolino as topolino {
  component Minnie
} pos(0, 120)

frame Paperina as paperina {
  component Qui
  component Quo
  component Qua
} pos(0, 240)
@enduml

Pro Tip: Adjust Frame Sizing #

If frames are still stretching horizontally, tweak the skinparam to limit frame width or adjust padding for tighter, more compact layouts:

skinparam frame {
  width 200
  padding 10
}

These tweaks should help you build a vertical, readable hardware architecture diagram that scales smoothly as you add more components and frames.

内容的提问来源于stack exchange，提问作者Federico Destefanis