com.vaadin.flow.router.
Annotation Type Route
-
@Retention(value=RUNTIME) @Target(value=TYPE) @Inherited @Documented public @interface Route
Defines the route template suffix for components that function as navigation targets in routing.
The route template of the navigation target is composed of the values of all
RoutePrefix
annotated on thelayout()
andParentLayout
class values, starting from the root parent and joined together using slash delimiter to form a path form string.There is also
RouteAlias
annotation which may be declared in addition to this annotation and may be used multiple times.Since:
1.0
See Also:
-
-
Field Summary
Fields Modifier and Type Fields and Description static String
NAMING_CONVENTION
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element and Description boolean
absolute
Ignore route prefixes from parent layouts and only use the path defined in this annotation.
Class<? extends RouterLayout>
layout
Sets the parent component for the route target component.
boolean
registerAtStartup
Marks if this Route should be registered during the initial route registration on servlet startup.
String
value
Sets the route template suffix value of the annotated class.
-
-
-
Field Detail
-
NAMING_CONVENTION
public static final String NAMING_CONVENTION
-
-
Element Detail
-
value
public abstract String value
Sets the route template suffix value of the annotated class.
If no value is provided, the path will be derived from the class name of the component. The derived name will be in lower case and trailing "View" will be removed. Also, MainView or Main names will be mapped to root (value will be "").
This value accepts also parameter template segments which can be defined using following format:
:parameterName[?|*][(regex)]
.Note for framework developers: do not use the value directly, but use the helper method
RouteUtil.resolve(Class, Route)
, so that naming convention based values are dealt correctly.Returns:
the explicit path value of this route
Default:
"___NAMING_CONVENTION___"
-
-
-
layout
public abstract Class<? extends RouterLayout> layout
Sets the parent component for the route target component.
When navigating between components that use the same layout, the same component instance is reused. Default layout target is the
UI
, but the layout should not be a customUI
asUI
is a special class used to know where the route stack ends and no parent layouts should be involved.All layout stacks will be appended to the
UI
as it represents the Body element.Returns:
the layout component class used by the route target component.
See Also:
Default:
com.vaadin.flow.component.UI.class
-
-