последовательност прецедентов классов активности компонент состояний объект развёртывания синхронизации Regex Network Wireframe Archimate Gantt MindMap WBS EBNF JSON YAML
PlantUML Language specification Style

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Style (or CSS like style)

style was introduced in version 1.2019.9, and now it is the preferred way to style diagrams

Skinparam is being phased out (see comments in issue#1464) and users should migrate to style. Nevertheless, all existing legacy diagrams should still work with future versions of PlantUML.

There are some working examples on this page.

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Problem to solve

skinparam can change the rendering of diagrams (fonts, colors...):

But it has some important limitations:

style has the following features:

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Properties that can be styled

The following properties can be set in style:

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Current Working Model

The current model has moved to work similarly to CSS, using a model of scoping and cascading styles to either element types or user-assigned styles (via <<stereotype>> notation).

Style can be inlined using <style> and </style> separators.

It is also possible to store style definition in some external file and to reference it using <style file=MyOwnFile.css>.

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Basic styling for elements

Basic example of a Sequence Diagram style

🎉 Copied! 

@startuml
' style enclosure declaration
<style>

    ' scope to sequenceDiagram elements
    sequenceDiagram {

     ' scope to actor element types
     actor {
       FontColor Blue
     }

    }
}
</style>

' printed in blue
actor Bob
' also printed in blue
actor Sally
@enduml

Basic example of a Work Breakdown Structure style

Let's at a different example, that of a Work Breakdown Structure:

🎉 Copied! 

@startwbs
<style>
' this time, scoping to wbsDiagram
wbsDiagram {

  ' Here we introduce a global style, i.e. not targeted to any element
  ' thus all lines (meaning connector and borders,
  ' there are no other lines in WBS) are black by default
  Linecolor black

  ' But we can also target a diagram specific element, like arrow
   arrow {
    ' note that Connectors are actually "Arrows"; this may change in the future
    ' so this means all Connectors and Arrows are now going to be green
    LineColor green
  }

}
</style>

* World
** America
*** Canada
** Europe
*** England
*** Germany
*** Spain
@endwbs

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Adding user defined style targets (stereotype)

We can extend these examples to start targeting not just element types, but specific elements.

Using user defined styles in a Sequence Diagram

With shown stereotype

🎉 Copied! 

@startuml
' style enclosure declaration
<style>
    ' scope to sequenceDiagram elements
    sequenceDiagram {

      ' scope to actor element types
      actor {
        FontColor Blue
      }

     ' define a new style, using CSS class syntax
     .myStyle {
        FontColor Red
     }

}
</style>

' printed in blue
actor Bob
' this will now be printed in Red
actor Sally <<myStyle>>
@enduml

With not shown stereotype

🎉 Copied! 

@startuml
hide stereotype
' style enclosure declaration
<style>
    ' scope to sequenceDiagram elements
    sequenceDiagram {

      ' scope to actor element types
      actor {
        FontColor Blue
      }

     ' define a new style, using CSS class syntax
     .myStyle {
        FontColor Red
     }

}
</style>

' printed in blue
actor Bob
' this will now be printed in Red
actor Sally <<myStyle>>
@enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Using Dynamic Selectors

NOTE: This section is still very experimental and may change!

As we are following the CSS model now, then it should be possible to use selectors to simplify targeting groups of elements, like those "children" (or "downstream") of a given element in diagrams like Work Breakdown or MindMaps.

Using the depth selector in a WBS

🎉 Copied! 

@startwbs
<style>
wbsDiagram {
  ' all lines (meaning connector and borders, there are no other lines in WBS) are black by default
  Linecolor Black
  arrow {
    ' Note that connector are actually "arrows" even if they don't look like arrows
    ' This is to be consistent with other UML diagrams. Not 100% sure that it's a good idea
    ' So now connectors are green at this level
    LineColor Green
  }
  :depth(0) {
      ' will target the "root" (first level) node,
      ' AND root level elements like Arrows (styled by Line styles)
      ' Note how it will override the
      BackgroundColor White
      RoundCorner 10
      LineColor red
  }
  arrow {
    :depth(2) {
      ' Targetting only connector between Mexico-Chihuahua and USA-Texas
      LineColor blue
      LineStyle 4
      LineThickness .5
    }
  }
  node {
    :depth(2) {
    ' Targetting the Lines at a depth of 2
      LineStyle 2
      LineThickness 2.5
    }
  }

}
</style>
* World
** America
*** Canada
*** Mexico
**** Chihuahua
*** USA
**** Texas
***< New York
** Europe
*** England
*** Germany
*** Spain
@endwbs

Using the "descendant" pseudo selector

Of course, sometimes you want to target all "child" (or "downstream") elements of a given element. The * selector works as in CSS, to say: "this element, and all elements of any type that is it's child".

An example:

🎉 Copied! 

@startwbs
<style>
wbsDiagram {
  Linecolor black
  arrow {
    LineColor green
  }
  :depth(1) {
      BackgroundColor White
      RoundCorner 10
      LineColor red
  }

 .mexicoStyle * {
     BackgroundColor Red
     FontColor White
     RoundCorner 10
 }
}
</style>
* World
** America
*** Canada
*** Mexico <<mexicoStyle>>
**** Chihuahua
*** USA
**** Texas
***< New York
** Europe
*** England
*** Germany
*** Spain
@endwbs

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Using an external style file

NOTE: This is still a work in progress, and may not work as expected.

If a file named plantuml.skin is found in the same folder as the diagram, it will attempt to be loaded and used during diagram creation. This lays the groundwork--along with scoping styles to specific diagrams, and user defined styles--for creating truly complex and persistent styles, without including them in each of your diagrams.

Edit in DokuwikiEdit in AsciidocEdit in Markdown
Getting debug output

NOTE: This is still a work in progress, and may not show every element in every diagram.

You can use the -v (or -verbose) command line argument to get some debug output to help you determine what elements are in use, so you can target them.

java -jar plantuml.jar -v -tpng diagram.pu

results in: 

(0.378 - 256 Mo) 238 Mo - Using style node.depth(0).root.wbsdiagram.rootnode.element
(0.546 - 256 Mo) 237 Mo - Using style depth(2).node.root.wbsdiagram.leafnode.element
(0.547 - 256 Mo) 237 Mo - Using style depth(2).node.root.*.wbsdiagram.element
(0.560 - 256 Mo) 236 Mo - Using style node.root.depth(3).wbsdiagram.leafnode.element
(0.561 - 256 Mo) 236 Mo - Using style node.root.depth(3).*.wbsdiagram.mexicostyle.element
(0.562 - 256 Mo) 236 Mo - Using style node.root.depth(3).*.wbsdiagram.element
(0.565 - 256 Mo) 236 Mo - Using style depth(2).node.root.wbsdiagram.mexicostyle.element
(0.569 - 256 Mo) 235 Mo - Using style depth(2).node.root.wbsdiagram.element
(0.571 - 256 Mo) 235 Mo - Using style node.depth(1).root.wbsdiagram.element
(0.572 - 256 Mo) 235 Mo - Using style node.depth(1).root.*.wbsdiagram.element
(1.963 - 256 Mo) 250 Mo - Using style depth(0).arrow.root.wbsdiagram.element
(1.964 - 256 Mo) 250 Mo - Using style depth(1).arrow.root.wbsdiagram.element
(1.965 - 256 Mo) 250 Mo - Using style depth(2).arrow.root.wbsdiagram.element