diff --git a/articles/flow/configuration/development-mode/dev-tools/component-locator.adoc b/articles/flow/configuration/development-mode/dev-tools/component-locator.adoc index 295be95969..4149c40c7e 100644 --- a/articles/flow/configuration/development-mode/dev-tools/component-locator.adoc +++ b/articles/flow/configuration/development-mode/dev-tools/component-locator.adoc @@ -1,18 +1,18 @@ --- title: Component Locator -description: Use Component Locator to identify components in views and find their source code in your IDE. +description: Use Component Locator to identify components in views and find their source code in an IDE. order: 1 --- = [since:com.vaadin:vaadin@V24]#Component Locator# -You can use the component locator to identify components and to find their code when running applications in <<../#,development mode>>. The component locator opens the corresponding source code in your IDE when you click a component (for example, a Button in a view). +You can use the component locator to identify components, and to find their code when running applications in <<../#,development mode>>. The component locator opens the corresponding source code in your IDE when you click a component (e.g., a Button in a view). == Enabling Component Locator -Start by running your Vaadin application project in development mode. Click on the Vaadin symbol [guilabel]*}>* at the bottom right-hand corner of your browser window -- as indicated in the screenshot here. +Start by running your Vaadin Flow application project in development mode. Click on the Vaadin symbol [guilabel]*}>* at the bottom right-hand corner of your browser window -- as indicated in the screenshot here. [.device] image::/images/dev-tools-location.png[The Vaadin symbol location in development mode.] @@ -25,7 +25,7 @@ image::/images/code-menu.png[The Code tab viewed in the Dev tools menu.] == Using Component Locator -Now that the Component Locator has been enabled, you're ready to use it. To highlight a component in red and identify it, hover your pointer over one in the view. The component names appear in a list at the bottom right-hand corner of your browser window. You can use the arrow keys to navigate that list. +Now that the Component Locator has been enabled, it's ready to be used. To highlight a component in red and identify it, hover your pointer over one in the view. The component names appear in a list at the bottom right-hand corner of your browser window. You can use the arrow keys to navigate that list. [.device] image::/images/component-locator.png[Component Locator highlighting and identifying the Button component.] @@ -39,3 +39,17 @@ image::/images/code-view.png[The Button component and corresponding source code. [class^=PageHeader-module--descriptionContainer] {display: none;} ++++ + + +[since:com.vaadin:vaadin@V24.4] +== Disable Component Tracking + +Component tracking isn't an expensive operation, but it may at times be useful to disable it. Be aware that with component tracking disabled, the Component Locator tool cannot identify any components. To disable tracking, set the `vaadin.devmode.componentTracker.enabled` configuration parameter to `false`. +See <<{articles}/configuration/properties#,Configuration Properties>> for more information about setting configuration parameters. + + +++++ + +++++ \ No newline at end of file diff --git a/articles/flow/configuration/properties.adoc b/articles/flow/configuration/properties.adoc index 6605bd0aff..f9541bc5b9 100644 --- a/articles/flow/configuration/properties.adoc +++ b/articles/flow/configuration/properties.adoc @@ -7,7 +7,7 @@ order: 10 = Configuration Properties -You can change the behavior of Vaadin applications by setting the configuration properties. You can use either system properties, or servlet initialization parameters to set them. See the <> for details. +You can change the behavior of Vaadin applications by setting the configuration properties. You can set them either through the system properties, or the servlet initialization parameters. See the <> for details. See also the <<{articles}/flow/integrations/spring/configuration#, Spring-specific instructions>> for Spring-based applications. @@ -96,7 +96,6 @@ When a system property and a servlet parameter have the same name, the system pr The following table contains the properties that are defined in the [classname]`com.vaadin.server.DeploymentConfiguration` and [classname]`com.vaadin.server.Constants` classes. They're listed in alphabetical order. If you use Spring Boot, you should add the `vaadin.` prefix to them (e.g., change `brotli` to `vaadin.brotli`). - [cols="1,1,4"] |=== |Property Name |Default Value |Description @@ -125,6 +124,10 @@ The following table contains the properties that are defined in the [classname]` |`false` |Enables session serialization. When session serialization is enabled, [classname]`UI` instances and registered [classname]`StreamResource` instances are serialized or deserialized when restarting the development server. When set to `true`, for example, access control information can be preserved during development so that you don't need to log in for each change. This applies only to development mode. +|`devmode.componentTracker.enabled` +|`true` +|Enables the <> tracker utility. Set to `false` to disable. With it disabled, the Component Locator tool cannot identify any components. This applies only to development mode. + |`devmode.usageStatistics.enabled` |`true` |Enables Vaadin to collect usage statistics that can guide further development. Statistics are collected based on features that are used in the application. No data is collected in production mode. Some usage statistics are collected through the web browser. See the https://github.com/vaadin/vaadin-usage-statistics[client-side collector repository] for instructions on how to opt out. This applies only to development mode.