Здесь можно ознакомиться с полезными дополнениями, которые можно использовать в любой из поддерживаемых диаграмм: 🎉 Copied!  | @startuml
abstract abstract
abstract class "abstract class"
annotation annotation
circle circle
() circle_short_form
class class
diamond diamond
<> diamond_short_form
entity entity
enum enum
interface interface
@enduml
|
*[Ref. for ``protocol`` and ``struct``: [GH-1028](https://github.com/plantuml/plantuml/pull/1028)]* WARNING This translation need to be updated. WARNING Взаимосвязи между классами (согласно нотации UML) задаются с помощью следующих символов: | Тип | Символ | Отображение | | Наследование | <|-- |  | | Композиция | *-- |  | | Агрегация | o-- |  | | Зависимость | <.. | | | Ассоциация | <-- | | | Реализация (Имплементация) | <|.. | |
Если рассматривать более универсально, - есть два типа линий:
-- - рисует сплошную линию.. - рисует штриховую линию
- к любой стороне (или сразу к обоим сторонам) линии, соединяющей два элемента, можно добавить разные наконечники:
< - рисует заостренный наконечник стрелочки<| или ^ - рисует наконечник стрелочки в виде треугольника* - рисует неконечник стрелочки в виде сплошного ромбаo - рисует неконечник стрелочки в виде полого ромба# - рисует неконечник стрелочки в виде полого квадратикаx - рисует неконечник стрелочки в виде крестика} - рисует неконечник стрелочки в виде обратного треугольника+ - рисует неконечник стрелочки в виде кружочка с крестиком внутри
Зная эти правила можно нарисовать следующие изображения: 🎉 Copied! | @startuml
Class01 <|-- Class02
Class03 *-- Class04
Class05 o-- Class06
Class07 .. Class08
Class09 -- Class10
@enduml
|
🎉 Copied! | @startuml
Class11 <|.. Class12
Class13 --> Class14
Class15 ..> Class16
Class17 ..|> Class18
Class19 <--* Class20
@enduml
|
🎉 Copied! | @startuml
Class21 #-- Class22
Class23 x-- Class24
Class25 }-- Class26
Class27 +-- Class28
Class29 ^-- Class30
@enduml
|
Для каждой связи можно добавить метку. Делается это с помощью добавления символа : после которого указывается текст метки. Для добавления меток ближе к началу или концу стрелочки можно использовать двойные кавычки "" и помещать метки, обрамленные такими кавычками, перед или после стрелочки как на примере ниже: 🎉 Copied! | @startuml
Class01 "к одному" *-- "от многих" Class02 : композиция
Class03 o-- Class04 : агрегация
Class05 --> "1" Class06
@enduml
|
Вы можете добавить дополнительные стрелки < или > в начале или в конце метки, чтобы указать на использование одного объекта другим. 🎉 Copied! | @startuml
class Машина
Водитель - Машина: ведет >
Машина *- Колесо: имеет 4 >
Машина -- Персонаж: < владеет
@enduml
|
Для объявления полей и методов вы можете использовать символ :. Для этого каждый раз указываете класс, затем символ :и затем имя поля или метода, который Вы хотите добавить в этот класс. Система определяет что именно Вы добавили по типу скобок, которые Вы укажете после имени. Для поля данных это должны быть квадратные скобки [], а для метода круглые скобки (). 🎉 Copied! | @startuml
Object <|-- ArrayList
Object : equals()
ArrayList : Object[] elementData
ArrayList : size()
@enduml
|
Чтобы не указывать каждый раз имя класса, для которого Вы хотите добавить поле данных или метод, можно все такие поля и методы указать сразу перечислив их внутри фигурных скобок {}. Синтаксис порядка описания типа/имени довольно гибок. 🎉 Copied! | @startuml
class Dummy {
String data
void methods()
}
class Flight {
flightNumber : Integer
departureTime : Date
}
@enduml
|
Вы можете специально указать что именно Вы добавляете (поле данных или метод) используя ключевые слова {field} - поле данных или {method} - метод. Они переопределяют собой типы, определяемые парсером по умолчанию. 🎉 Copied! | @startuml
class Dummy {
{field} A field (despite parentheses)
{method} Some method
}
@enduml
|
Определяя методы и поля данных, вы можете использовать символы указания видимости, приведённые в таблице ниже: | Символ | Иконка для поля данных | Иконка для метода | Видимость | - |  |  | private | # |  |  | protected | ~ |  |  | package private | + |  |  | public |
🎉 Copied! | @startuml
class Dummy {
-field1
#field2
~method1()
+method2()
}
@enduml
|
Заменить значки их текстовыми представлениями можно используя команду skinparam classAttributeIconSize 0: 🎉 Copied! | @startuml
skinparam classAttributeIconSize 0
class Dummy {
-field1
#field2
~method1()
+method2()
}
@enduml
|
Вы можете определить статические или абстрактные методы и поля данных используя модификаторы {static} и {abstract} соответственно. Эти модификаторы могут располагаться как в начале, так и в конце строки. Вы так же можете использовать {classifier} как замену для {static}. 🎉 Copied! | @startuml
class Dummy {
{static} String id
{abstract} void methods()
}
@enduml
|
По умолчанию, методы и поля автоматически группируются PlantUML. Вы можете использовать разделители, чтобы определить собственный порядок полей и методов. Можно использовать следующие разделители: --..==__. Вы также можете использовать заголовки внутри разделителей: 🎉 Copied! | @startuml
class Foo1 {
Вы можете использовать
несколько строчек
..
и, если хотите,
можете группировать их
==
как Вам удобно.
__
Можно делать столько групп,
сколько Вам нужно
--
End of class
}
class User {
.. Simple Getter ..
+ getName()
+ getAddress()
.. Some setter ..
+ setName()
__ private data __
int age
-- encrypted --
String password
}
@enduml
|
Шаблоны задаются ключевым словом class с парой символов << и >>. Также вы можете создать и спозиционировать относительно любого класса заметку, используя ключевые слова note left of , note right of , note top of и note bottom of. Вы также можете создать и спозиционировать заметку относительно последнего определённого класса, используя ключевые слова note left, note right, note top и note bottom. Ключевым словом note легко создать заметку без привязки и затем привязать её используя символ ... 🎉 Copied! | @startuml
class Object << general >>
Object <|--- ArrayList
note top of Object : In java, every class\nextends this one.
note "Это не привязанная\nни к чему заметка" as N1
note "Эта заметка привязана\nсразу к нескольким классам" as N2
Object .. N2
N2 .. ArrayList
class Foo
note left: Эта заметка будет\nпривязана к последнему\nопределенному классу
@enduml
|
Допускается использование некоторых HTML-тегов (также смотри синтаксис записи Creole), таких как: <b><u><i><s>, <del>, <strike><font color="#AAAAAA"> or <font color="colorName"><color:#AAAAAA> or <color:colorName><size:nn> to change font size<img src="file"> or <img:file>: the file must be accessible by the filesystem
Также, заметку можно задавать в несколько строчек. В таком случае, конец заметки определяется по ключевым словам end note. 🎉 Copied! | @startuml
note top of Object
In java, <size:18>every</size> <u>class</u>
<b>extends</b>
<i>this</i> one.
end note
note as N1
Эта заметка <u>также</u>
<b><color:royalBlue>состоит из</color>
<s>нескольких</s> строчек.
And this is hosted by <img:sourceforge.jpg>
end note
@enduml
|
Можно создать и привязать заметку к полю данных или методу. ⚠ Ограничения- Нельзя использовать
top или bottom(реализованы только left и right) - Нельзя использовать с разделителем пространства имён
::
Заметка к полю занных или методу 🎉 Copied! | @startuml
class A {
{static} int counter
+void {abstract} start(int timeout)
}
note right of A::counter
Это поле данных прокомментировано
end note
note right of A::start
Этот метод теперь объясняется в UML заметке
end note
@enduml
|
Заметка для разных методов с одинаковым именем 🎉 Copied! | @startuml
class A {
{static} int counter
+void {abstract} start(int timeoutms)
+void {abstract} start(Duration timeout)
}
note left of A::counter
Это поле данных прокомментировано
end note
note right of A::"start(int timeoutms)"
Это метод с типом параметра int
end note
note right of A::"start(Duration timeout)"
Это метод с типом параметра Duration
end note
@enduml
|
[Ref. QA-3474 and QA-5835] Чтобы добавить заметку на связь, сразу после определения такой связи в следующей строке разместите команду note on link. Вы также можете использовать note left on link, note right on link, note top on link или note bottom on link для того, чтобы добавить заметку и спозиционировать её относительно последней определенной связи. 🎉 Copied! | @startuml
class Dummy
Dummy --> Foo : Одна связь
note on link #red: Помни, оно - красное!
Dummy --> Foo2 : Другая связь
note right on link #lightblue
Это моя заметка, чтобы
не забыть где правильная связь.
И еще, она - почти синяя
end note
@enduml
|
Вы можете определить класс как абстрактный, используя ключевые слова abstract или abstract class. Такие классы будут нарисованы курсивом. А еще Вы можете использовать ключевые слова interface, annotation и enum. 🎉 Copied! | @startuml
abstract class AbstractList
abstract AbstractCollection
interface List
interface Collection
List <|-- AbstractList
Collection <|-- AbstractCollection
Collection <|- List
AbstractCollection <|- AbstractList
AbstractList <|-- ArrayList
class ArrayList {
Object[] elementData
size()
}
enum TimeUnit {
DAYS
HOURS
MINUTES
}
annotation SuppressWarnings
annotation Annotation {
annotation with members
String foo()
String bar()
}
@enduml
|
[Ref. 'Annotation with members' Issue#458] Если Вы хотите использовать не буквенные (/, \, *, # и прочее) или специальные unicode символы в названии класса (а также других элементов), Вам необходимо выполнить следующие условия: - Поставить кавычки
"" вокруг имени элемента которое содержит не буквенные, специальные unicode символы или символы пробела. - Использовать ключевое слово
as для того, чтобы дополнительно определить короткое ссылочное имя и по нему потом ссылться на этот элемент при определении взаимосвязей
🎉 Copied! | @startuml
class "Это мой класс с\nпробелами в имени" as class1
class class2 as "Так это тоже работает"
class2 *-- "foo/dummy": тут тоже нужны кавычки,\nтак как есть символ ''/''
class1 *-- ИмяНаРусском: названия на русском языке\nне требуют использования кавычек\n если в них нет пробелов
@enduml
|
Вы можете параметризовать отображение классов с помощью команды hide/show . Основная команда: hide empty members. Эта команда скроет атрибуты или методы, если они пусты. Вместо empty members можно использовать: empty fields или empty attributes для пустых полей,empty methods для пустых методов,fields или attributes, которая скроет поля, даже если они описаны,methods которая скроет методы, даже если они описаны,members которая скроет поля иметоды, даже если они описаны,circle для обведенного символа перед именем класса,stereotype для стереотипа.
Вы также можете указать, сразу после ключевого слова hide или show : class для всех классов,interface для всех интерфейсов,enum для всех перечислений,<<foo1>> для классов, стереотип которых foo1,- существующее имя класса.
Вы можете использовать несколько команд show/hide для определения правил и исключений 🎉 Copied! | @startuml
class Dummy1 {
+myMethods()
}
class Dummy2 {
+hiddenMethod()
}
class Dummy3 <<Serializable>> {
String name
}
hide members
hide <<Serializable>> circle
show Dummy1 methods
show <<Serializable>> fields
@enduml
|
Вы также можете использовать команду show/hide, чтобы скрывать классы. Это может быть полезно, если Вы подключили большой файл, и хотите скрыть некоторые классы из этого файла после его включения. Сам класс и связи, которые к нему вели будут скрыты, но место, которое он занимал на экране по прежнему будет им занято. 🎉 Copied! | @startuml
class Foo1
class Foo2
class Foo3
Foo2 *-- Foo1
Foo3 *-- Foo1
Foo3 *-- Foo2
hide Foo1
hide Foo2
@enduml
|
Вы можете использовать команду remove, чтобы удалять классы. Это может быть полезно, если Вы подключили большой файл, и хотите полностью удалить некоторые классы из этого файла после его включения. В отличии от каманды hide, которая только скрывает класс при отображении его на экране (и при этом этот скрытый класс продолжает занимать на экране место), при использовании команды remove класс и его связи будут полнотью удалены перед формированием изображения, как будто они даже не опредлялись. 🎉 Copied! | @startuml
class Foo1
class Foo2
class Foo3
Foo2 *-- Foo1
Foo3 *-- Foo1
Foo3 *-- Foo2
remove Foo1
remove Foo2
@enduml
|
По умолчанию отображаются все классы: 🎉 Copied! | @startuml
class C1
class C2
class C3
C1 -- C2
@enduml
|
Но вы можете: - скрывать классы без связей при помощи команды
hide @unlinked:
🎉 Copied! | @startuml
class C1
class C2
class C3
C1 -- C2
hide @unlinked
@enduml
|
- полностью удалять классы без связей при помощи команды
remove @unlinked:
🎉 Copied! | @startuml
class C1
class C2
class C3
C1 -- C2
remove @unlinked
@enduml
|
[Adapted from QA-11052] Вы можете использовать угловые скобки < и > чтобы указать на использование дженериков в классе. 🎉 Copied! | @startuml
class Foo<? extends Element> {
int size()
}
Foo *- Element
@enduml
|
Также Вы можете отключить отрисовку этих элементов, используя команду skinparam genericDisplay old. Обычно, метка с буквой (C, I, E or A) испольуется для классов, интерфейсов, перечислений и абстрактных классов. Но Вы можете создать свою собственную метку для класса при создании шаблона задав для неё собственную букву и цвет (используя html-код для цвета или название цвета). Русские буквы также можно использовать. 🎉 Copied! | @startuml
class System << (S,#FF7700) Singleton >>
class Date << (D,orchid) >>
class Форма << (Ф,lightblue) >>
class Заголовок << (З,green) >>
@enduml
|
Вы можете создать пакет, используя ключевое слово package, также можно дополнительно указать для него цвет фона (используя html-код для цвета или название цвета). Обратите внимание, что пакеты могут быть вложенными. 🎉 Copied! | @startuml
package "Classic Collections" #DDDDDD {
Object <|-- ArrayList
}
package net.sourceforge.plantuml {
Object <|-- Demo1
Demo1 *- Demo2
}
@enduml
|
Доступны различные стили для пакетов. Можно глобально задать стиль по умолчанию с помощью команды: skinparam packageStyle встроенныйСтильПакета, или указать стиль для каждого пакета по отдельности при помощи определения для него шаблона package имяПакета <<встроенныйСтильПакета>>. На примере ниже можно посмотреть доступные варианты стилей для пакетов: 🎉 Copied! | @startuml
scale 750 width
package foo1 <<Node>> {
class Class1
}
package foo2 <<Rectangle>> {
class Class2
}
package foo3 <<Folder>> {
class Class3
}
package foo4 <<Frame>> {
class Class4
}
package foo5 <<Cloud>> {
class Class5
}
package foo6 <<Database>> {
class Class6
}
@enduml
|
Между пакетами также можно указывать взаимосвязи: 🎉 Copied! | @startuml
skinparam packageStyle rectangle
package foo1.foo2 {
}
package foo1.foo2.foo3 {
class Object
}
foo1.foo2 +-- foo1.foo2.foo3
@enduml
|
Даже если класс располагается внутри пакета, его имя остается уникальным идентификатором для этого класса. Это значит, что у Вас не может быть двух классов в разных пакетах, но с одинаковым именем. В этом случае, вам следует использовать пространства имен вместо пакетов. Вы можете ссылаться на классы из других пространств имён по их полному определению. Классы без пространства имён определяются по наличию точки пред их именами. Обратите внимание, что вы не обязаны явно создавать пространство имен: правильно определенный класс, в имени которого через точку указано пространство имен и затем его имя автоматически попадает в правильное пространство имен. 🎉 Copied! | @startuml
class Метрики
namespace Сеть.ожидание #DDDDDD {
.Метрики <|-- Пользователь
Встреча o-- Пользователь
.Метрики <|- Встреча
}
namespace Сеть.действующий {
Сеть.ожидание.Пользователь <|- Пользователь
.Метрики <|-- Пользователь
Сеть.ожидание.Встреча o-- Пользователь
}
Метрики <|-- Сеть.завершенный.Пользователь
@enduml
|
Вы можете задать другой разделитель (не точку) используя команду: set namespaceSeparator символыРазделителя.
🎉 Copied! | @startuml
set namespaceSeparator ::
class X1::X2::foo {
some info
}
@enduml
|
также Вы можете отключить автоматическое создание пакетов используя команду: set namespaceSeparator none.
🎉 Copied! | @startuml
set namespaceSeparator none
class X1.X2.foo {
some info
}
@enduml
|
WARNING This translation need to be updated. WARNING Вы можете задвать интерфейсы в виде "lollipop" для классов, используя следующий синтаксис: bar ()- foobar ()-- foofoo -() bar
🎉 Copied! | @startuml
class foo
bar ()- foo
@enduml
|
По умолчанию, связи между элементами задаются при помощи двух тире -- для сплошных линий или при помощи двух точек .. для пунктирных линий и ориентированны вертикально. Можно указать, что связь необходимо изобразить горизонтально, для этого необходимо использовать одиночное тире - для сплошной линии или одну точку . для штриховой линии. 🎉 Copied! | @startuml
Room o- Student
Room *-- Chair
@enduml
|
Изменить направление стрелки можно, переместив символ окончания стрелки на другую сторону: 🎉 Copied! | @startuml
Student .o Room
Chair ..* Room
@enduml
|
Можно управлять направлением связи добавляя ключевые слова left, right, up или down внутрь стрелки: 🎉 Copied! | @startuml
Пользователь -left-> Лево
Пользователь -right-> Право
Пользователь -up-> Верх
Пользователь -down-> Низ
@enduml
|
Можно использовать более короткий синтаксис используя только первый символ указанных выше ключевых слов, например -d- или -do- вместо полного слова -down-. Правда злоупотреблять такой короткой записью не стоит, так как GraphViz обычно дает более хороший результат, когда такая короткая запись НЕ используется. И наконец, можно поменять все направления местами используя ключевое слово left to right direction. Для этого можно сравнить предыдущую диаграмму с диаграммой, представленной ниже: 🎉 Copied! | @startuml
left to right direction
Пользователь -left-> Лево
Пользователь -right-> Право
Пользователь -up-> Верх
Пользователь -down-> Низ
@enduml
|
Вы можете задать ассоциацию класса после того, как была задана связь между двумя классами, как в примере: 🎉 Copied! | @startuml
class Student {
Name
}
Student "0..*" - "1..*" Course
(Student, Course) .. Enrollment
class Enrollment {
drop()
cancel()
}
@enduml
|
Вы можете задать это в другом направлении: 🎉 Copied! | @startuml
class Student {
Name
}
Student "0..*" -- "1..*" Course
(Student, Course) . Enrollment
class Enrollment {
drop()
cancel()
}
@enduml
|
🎉 Copied! | @startuml
class Station {
+name: string
}
class StationCrossing {
+cost: TimeInterval
}
<> diamond
StationCrossing . diamond
diamond - "from 0..*" Station
diamond - "to 0..* " Station
@enduml
|
[Ref. Incubation: Associations] Вы можете использовать команду skinparam для глобального изменения шрифтов и цветов различных элементов диаграммы. Вы можете использовать данную команду : 🎉 Copied! | @startuml
' задаем параметры для всех классов по умолчанию
skinparam class {
' задаем светлозеленый цвет для фона классов по умолчанию
BackgroundColor LightGreen
' задаем синий цвет для связей классов по умолчанию
ArrowColor Blue
' задаем красный цвет для контуров классов по умолчанию
BorderColor Red
}
' задаем цвет кружочков внутри элементов по умолцанию
skinparam stereotypeCBackgroundColor Magenta
Class01 "к одному" *-- "от многих" Class02 : композиция
Class03 o-- Class04 : агрегация
@enduml
|
Расширяя пример выше, можно задавать специальные параметры для определенных шаблонов (и применять эти щаблоны затем к тем или иным классам). 🎉 Copied! | @startuml
' задаем параметры для всех классов по умолчанию
skinparam class {
' задаем светлозеленый цвет для фона классов по умолчанию
BackgroundColor LightGreen
' задаем синий цвет для связей классов по умолчанию
ArrowColor Blue
' задаем красный цвет для контуров классов по умолчанию
BorderColor Red
' задаем зеленый цвет для фона классов, для которых шаблоном является Foo
BackgroundColor<<Foo>> Green
' задаем оранжевый цвет для контуров классов, для которых шаблоном является Foo
BorderColor<<Foo>> Orange
}
' задаем розовый цвет кружочков внутри элементов по умолцанию
skinparam stereotypeCBackgroundColor Magenta
' задаем серый цвет кружочков внутри элементов, для которых шаблоном является Foo
skinparam stereotypeCBackgroundColor<< Foo >> Gray
Class01 <<Foo>>
Class03 <<Foo>>
Class01 "к одному" *-- "от многих" Class02 : композиция
Class03 o-- Class04 : агрегация
@enduml
|
Можно объявить индивидуальный цвет для классов или примечаний, используя символ #. Можно использовать как стандартные названия цветов, так и их RGB-коды в различных вариантах записи. Так же, возможно задания градиента для фона, задав вместо одного цвета пару цветов и разделив их одним из символов градиента (разные символы отвечают за разные направления градиента): Для примера: 🎉 Copied! | @startuml
skinparam backgroundcolor AntiqueWhite/Gold
skinparam classBackgroundColor Wheat|CornflowerBlue
class Foo #red-lightgreen
note left of Foo #lightblue\9932CC
это моя заметка
об этом классе
end note
package Пример #GreenYellow/LightGoldenRodYellow {
class Заглушка
}
@enduml
|
Иногда диаграмма, формируемая по умолчанию выходит не совсем удачной... Вы можете объединять несколько классов вместе используя ключевое слово together, тогда рендер постарается расположить объединенные таким образом классы рядом друг с другом так, как если бы они находились в одном пакете. Для этих же целей можно связать классы между собой связями и скрыть эти связи установив им соответствующее свойство hidden. Тогда рендер также постарается расположить такие связанные классы вместе (причем длинной такой скрытой связи можно регулировать расстояние между классами, а направлением связи можно регулировать взаимное расположение). 🎉 Copied! | @startuml
class Bar1
class Bar2
together {
class Together1
class Together2
class Together3
}
Together2 -[hidden]--> Bar1
Bar1 -[hidden]> Bar2
@enduml
|
Иногда могут получиться очень большие файлы изображений. Чтобы разделить создаваемое изображение на несколько файлов (страниц), Вы можете использовать команду page (hpages)x(vpages), где: hpages - это число горизонтальных страниц,vpages - это число вертикальных страниц..
С этой командой также можно использовать команды skinparam параметр значение для настроек цвета разделённых страниц, и размеров их границы (смотри пример). 🎉 Copied! | @startuml
' Разделение на 4 страницы
page 2x2
skinparam pageMargin 10
skinparam pageExternalColor gray
skinparam pageBorderColor black
class Метрики
namespace Сеть.ожидание #DDDDDD {
.Метрики <|-- Пользователь
Встреча o-- Пользователь
.Метрики <|- Встреча
}
namespace Сеть.действующий {
Сеть.ожидание.Пользователь <|- Пользователь
.Метрики <|-- Пользователь
Сеть.ожидание.Встреча o-- Пользователь
}
Метрики <|-- Сеть.завершенный.Пользователь
@enduml
|
Вы можете использовать ключевые слова extends и implements для содания связей наследования и реализации (имплементации). 🎉 Copied! | @startuml
class ArrayList implements List
class ArrayList extends AbstractList
@enduml
|
Есть два разных синтаксиса для изменения цвета и стиля связей и стрелок. Возможности этого синтаксиса квадратных скобочек несколько больше, чем возможности встраиваемого синтаксиса (подробнее о нем будет ниже), так как здесь можно полностю скрывать связи, а также задавать их толщину. Стиль линий Можно задавать следующие стили для связей: bold - жирный, dashed - штриховой, dotted - пунктирный, hidden - скрытый, plain - непрерывный: - пример для каждого стиля без заметок на связях:
🎉 Copied! | @startuml
title Синтаксис квадратных скобочек без заметок
class foo
class bar
bar1 : [bold]
bar2 : [dashed]
bar3 : [dotted]
bar4 : [hidden]
bar5 : [plain]
foo --> bar
foo -[bold]-> bar1
foo -[dashed]-> bar2
foo -[dotted]-> bar3
foo -[hidden]-> bar4
foo -[plain]-> bar5
@enduml
|
- пример для каждого стиля с заметками на связях:
🎉 Copied! | @startuml
title Синтаксис квадратных скобочек с заметками
class foo
class bar
bar1 : [bold]
bar2 : [dashed]
bar3 : [dotted]
bar4 : [hidden]
bar5 : [plain]
foo --> bar : по умолчанию
foo -[bold]-> bar1 : [жирный]
foo -[dashed]-> bar2 : [штриховой]
foo -[dotted]-> bar3 : [пунктирный]
foo -[hidden]-> bar4 : [скрытый]
foo -[plain]-> bar5 : [непрерывный]
@enduml
|
[Adapted from QA-4181]Цвет линий Можно задавать цвет для связей: 🎉 Copied! | @startuml
title Задание цвета при помощи синтаксиса квадратных скобочек
class foo
class bar
bar1 : [#red]
bar2 : [#green]
bar3 : [#blue]
foo --> bar : обычный
foo -[#red]-> bar1 : [красный]
foo -[#green]-> bar2 : [зеленый]
foo -[#blue]-> bar3 : [синий]
@enduml
|
Толщина линий Можно задать толщину связей: 🎉 Copied! | @startuml
title Задание толщины при помощи синтаксиса квадратных скобочек
class foo
class bar
bar1 : [thickness=1]
bar2 : [thickness=2]
bar3 : [thickness=4]
bar4 : [thickness=8]
bar5 : [thickness=16]
foo --> bar : обычный
foo -[thickness=1]-> bar1 : [1]
foo -[thickness=2]-> bar2 : [2]
foo -[thickness=4]-> bar3 : [4]
foo -[thickness=8]-> bar4 : [8]
foo -[thickness=16]-> bar5 : [16]
@enduml
|
[Ref. QA-4949]Смешивание различных парметров 🎉 Copied! | @startuml
title Смешивание параметров при использовании синтаксиса квадратных скобочек
class foo
class bar
bar1 : [#red,thickness=1]
bar2 : [#red,dashed,thickness=2]
bar3 : [#green,dashed,thickness=4]
bar4 : [#blue,dotted,thickness=8]
bar5 : [#lightblue,plain,thickness=16]
foo --> bar : обычный
foo -[#red,thickness=1]-> bar1 : [#red,1]
foo -[#red,dashed,thickness=2]-> bar2 : [#red,dashed,2]
foo -[#green,dashed,thickness=4]-> bar3 : [#green,dashed,4]
foo -[#blue,dotted,thickness=8]-> bar4 : [blue,dotted,8]
foo -[#lightblue,plain,thickness=16]-> bar5 : [lightblue,plain,16]
@enduml
|
Возможности этого синтаксиса немного меньше, чем синтаксиса квадратных скобочек, который был рассмотрен выше. В частности, здесь нельзя задавать толщину линий, а также нельзя полностью скрывать линии. Вы можете изменить цвет или стиль индивидуально для каждой связи или стрелочки используя следующий встраиваемый синтаксис: #color;line.[bold|dashed|dotted];text:color где: # - начало режима конфигурирования,color - цвет стрелки,; - разделитель между конфигурационными параметрами,line.type - тип линии. type может принимать значения: bold - жирная, dashed - штриховая, dotted - пунктирная,text:color - цвет текста заметки на линии.
🎉 Copied! | @startuml
class foo
foo --> bar : обычная
foo --> bar1 #line:red;line.bold;text:red : красная, жирный
foo --> bar2 #green;line.dashed;text:green : зеленая, штриховой
foo --> bar3 #blue;line.dotted;text:blue : синяя, пунктирный
@enduml
|
Пример установки одних и тех же параметров при помощи двух различных синтаксисов можно посмотреть на примере ниже: 🎉 Copied! | @startuml
class foo1
class foo2
foo1 -[#red,bold]> bar1
foo1 -[#blue,dashed]-> bar2 : синтаксис квадратных скобочек
foo2 -> bar3 #red;line.bold
foo2 --> bar4 #blue;line.dashed : встраиваемый синтаксис
@enduml
|
[See similar feature on deployment] Вы можете изменить цвет или стиль индивидуально для каждой стрелочки используя следующие 2 варианта встраиваемого синтаксиса: 1. #color ##[style]color где: #color - цвет фона элемента,##[style]color - стиль отображения и цвет линий элемента.
🎉 Copied! | @startuml
abstract abstract
annotation annotation #pink ##[bold]red
class class #palegreen ##[dashed]green
interface interface #aliceblue ##[dotted]blue
@enduml
|
[Ref. QA-1487] 2. #[color|back:color];header:color;line:color;line.[bold|dashed|dotted];text:color где: # - начало режима конфигурирования,color или back:color - основной цвет фона,; - разделитель между конфигурационными параметрами,header:color - дополнительный цвет фона для заголовка,line:color - цвет для контуров элемента,line.[type] - тип линий, из которых состоит контур элемента (type может принимать значения: bold - жирный, dashed - штриховой, dotted - пунктирный),text:color - цвет текста.
Как уже упоминалось выше, можно задавать градиенты для фона, если указывать вместо одного цвета два разных цвета, разделяя их знаками \, |, / или - (они отвечают за разное направление градиента). Например: header:blue/red или back:DD0000-00FFFF. 🎉 Copied! | @startuml
abstract abstract
annotation annotation #pink;line:red;line.bold;text:red
class class #palegreen;header:red;line:green;line.dashed;text:green
interface interface #aliceblue;line:blue;line.dotted;text:blue
@enduml
|
Еще один пример: 🎉 Copied! | @startuml
class bar #line:green;back:lightblue
class bar2 #lightblue;line:green
class Foo1 #back:red;line:00FFFF
class FooDashed #line.dashed:blue
class FooDotted #line.dotted:blue
class FooBold #line.bold
class Demo1 #back:lightgreen|yellow;header:blue/red
@enduml
|
[Ref. QA-3770] 🎉 Copied! | @startuml
class Foo {
+ field1
+ field2
}
class Bar {
+ field3
+ field4
}
Foo::field1 --> Bar::field3 : foo
Foo::field2 --> Bar::field4 : bar
@enduml
|
[Ref. QA-3636] 🎉 Copied! | @startuml
left to right direction
class User {
id : INTEGER
..
other_id : INTEGER
}
class Email {
id : INTEGER
..
user_id : INTEGER
address : INTEGER
}
User::id *-- Email::user_id
@enduml
|
[Ref. QA-5261] Вы можете включить объединение окончания стрелок, сходящихся к одному элементу, используя команду skinparam groupInheritance X, где X - это минимальное количество стрелок, при котором будет включаться данный режим. Установка параметра в значение 1 (без группировки) 🎉 Copied! | @startuml
skinparam groupInheritance 1
A1 <|-- B1
A2 <|-- B2
A2 <|-- C2
A3 <|-- B3
A3 <|-- C3
A3 <|-- D3
A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml
|
Установка параметра в значение 2 (группировка если 2 и более) 🎉 Copied! | @startuml
skinparam groupInheritance 2
A1 <|-- B1
A2 <|-- B2
A2 <|-- C2
A3 <|-- B3
A3 <|-- C3
A3 <|-- D3
A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml
|
Установка параметра в значение 3 (группировка если 3 и более) 🎉 Copied! | @startuml
skinparam groupInheritance 3
A1 <|-- B1
A2 <|-- B2
A2 <|-- C2
A3 <|-- B3
A3 <|-- C3
A3 <|-- D3
A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml
|
Установка параметра в значение 4 (группировка если 4 и более) 🎉 Copied! | @startuml
skinparam groupInheritance 4
A1 <|-- B1
A2 <|-- B2
A2 <|-- C2
A3 <|-- B3
A3 <|-- C3
A3 <|-- D3
A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml
|
[Ссылка на QA-3193, и дефект QA-13532]Simple example 🎉 Copied! | @startuml
class Class
object Object
json JSON {
"fruit":"Apple",
"size":"Large",
"color": ["Red", "Green"]
}
@enduml
|
[Ref. QA-15481] For another example, see on JSON page. | |
Взаимосвязи между классами
Edit in Dokuwiki
Edit in Asciidoc
Edit in Markdown
