docs: align wording for custom CSS properties in JSDoc (#10603)

web-padawan · web-flow · commit 9a83d919bff3 · 2025-12-09T15:09:48.000+02:00
diff --git a/packages/form-layout/src/vaadin-form-layout.d.ts b/packages/form-layout/src/vaadin-form-layout.d.ts
@@ -187,8 +187,7 @@ export * from './vaadin-form-layout-mixin.js';
  *
  * ### CSS Properties Reference
  *
- * The following custom CSS properties are available on the `<vaadin-form-layout>`
- * element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property | Description | Default
  * ---|---|---
diff --git a/packages/form-layout/src/vaadin-form-layout.js b/packages/form-layout/src/vaadin-form-layout.js
@@ -189,8 +189,7 @@ import { FormLayoutMixin } from './vaadin-form-layout-mixin.js';
  *
  * ### CSS Properties Reference
  *
- * The following custom CSS properties are available on the `<vaadin-form-layout>`
- * element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property | Description | Default
  * ---|---|---
diff --git a/packages/grid/src/vaadin-grid-tree-toggle.d.ts b/packages/grid/src/vaadin-grid-tree-toggle.d.ts
@@ -49,8 +49,7 @@ export * from './vaadin-grid-tree-toggle-mixin.js';
  * `expanded` | When present, the toggle is expanded
  * `leaf`     | When present, the toggle is not expandable, i. e., the current item is a leaf
  *
- * The following custom CSS properties are available on
- * the `<vaadin-grid-tree-toggle>` element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property | Description | Default
  * ---|---|---
diff --git a/packages/grid/src/vaadin-grid-tree-toggle.js b/packages/grid/src/vaadin-grid-tree-toggle.js
@@ -51,8 +51,7 @@ import { GridTreeToggleMixin } from './vaadin-grid-tree-toggle-mixin.js';
  * `expanded` | When present, the toggle is expanded
  * `leaf`     | When present, the toggle is not expandable, i. e., the current item is a leaf
  *
- * The following custom CSS properties are available on
- * the `<vaadin-grid-tree-toggle>` element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property | Description | Default
  * ---|---|---
diff --git a/packages/popover/src/vaadin-popover.d.ts b/packages/popover/src/vaadin-popover.d.ts
@@ -53,7 +53,7 @@ export type PopoverEventMap = HTMLElementEventMap & PopoverCustomEventMap;
  *
  * ### Custom CSS Properties
  *
- * The following custom CSS properties are available on the `<vaadin-popover>` element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property              | Description
  * ---------------------------------|-------------
diff --git a/packages/popover/src/vaadin-popover.js b/packages/popover/src/vaadin-popover.js
@@ -188,7 +188,7 @@ const isLastOverlay = (overlay) => {
  *
  * ### Custom CSS Properties
  *
- * The following custom CSS properties are available on the `<vaadin-popover>` element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property              | Description
  * ---------------------------------|-------------
diff --git a/packages/tooltip/src/vaadin-tooltip.d.ts b/packages/tooltip/src/vaadin-tooltip.d.ts
@@ -59,7 +59,7 @@ export interface TooltipEventMap extends HTMLElementEventMap, TooltipCustomEvent
  *
  * ### Custom CSS Properties
  *
- * The following custom CSS properties are available on the `<vaadin-tooltip>` element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property              | Description
  * ---------------------------------|-------------
diff --git a/packages/tooltip/src/vaadin-tooltip.js b/packages/tooltip/src/vaadin-tooltip.js
@@ -51,7 +51,7 @@ import { TooltipMixin } from './vaadin-tooltip-mixin.js';
  *
  * ### Custom CSS Properties
  *
- * The following custom CSS properties are available on the `<vaadin-tooltip>` element:
+ * The following custom CSS properties are available for styling:
  *
  * Custom CSS property              | Description
  * ---------------------------------|-------------

Original file line number	Diff line number	Diff line change
`@@ -187,8 +187,7 @@ export * from './vaadin-form-layout-mixin.js';`
`187`	`187`	`*`
`188`	`188`	`* ### CSS Properties Reference`
`189`	`189`	`*`
`190`		- * The following custom CSS properties are available on the `<vaadin-form-layout>`
`191`		`- * element:`
	`190`	`+ * The following custom CSS properties are available for styling:`
`192`	`191`	`*`
`193`	`192`	`* Custom CSS property \| Description \| Default`
`194`	`193`	`* ---\|---\|---`
Original file line number	Diff line number	Diff line change
`@@ -189,8 +189,7 @@ import { FormLayoutMixin } from './vaadin-form-layout-mixin.js';`
`189`	`189`	`*`
`190`	`190`	`* ### CSS Properties Reference`
`191`	`191`	`*`
`192`		- * The following custom CSS properties are available on the `<vaadin-form-layout>`
`193`		`- * element:`
	`192`	`+ * The following custom CSS properties are available for styling:`
`194`	`193`	`*`
`195`	`194`	`* Custom CSS property \| Description \| Default`
`196`	`195`	`* ---\|---\|---`
Original file line number	Diff line number	Diff line change
`@@ -49,8 +49,7 @@ export * from './vaadin-grid-tree-toggle-mixin.js';`
`49`	`49`	* `expanded` \| When present, the toggle is expanded
`50`	`50`	* `leaf` \| When present, the toggle is not expandable, i. e., the current item is a leaf
`51`	`51`	`*`
`52`		`- * The following custom CSS properties are available on`
`53`		- * the `<vaadin-grid-tree-toggle>` element:
	`52`	`+ * The following custom CSS properties are available for styling:`
`54`	`53`	`*`
`55`	`54`	`* Custom CSS property \| Description \| Default`
`56`	`55`	`* ---\|---\|---`
Original file line number	Diff line number	Diff line change
`@@ -51,8 +51,7 @@ import { GridTreeToggleMixin } from './vaadin-grid-tree-toggle-mixin.js';`
`51`	`51`	* `expanded` \| When present, the toggle is expanded
`52`	`52`	* `leaf` \| When present, the toggle is not expandable, i. e., the current item is a leaf
`53`	`53`	`*`
`54`		`- * The following custom CSS properties are available on`
`55`		- * the `<vaadin-grid-tree-toggle>` element:
	`54`	`+ * The following custom CSS properties are available for styling:`
`56`	`55`	`*`
`57`	`56`	`* Custom CSS property \| Description \| Default`
`58`	`57`	`* ---\|---\|---`
Original file line number	Diff line number	Diff line change
`@@ -53,7 +53,7 @@ export type PopoverEventMap = HTMLElementEventMap & PopoverCustomEventMap;`
`53`	`53`	`*`
`54`	`54`	`* ### Custom CSS Properties`
`55`	`55`	`*`
`56`		- * The following custom CSS properties are available on the `<vaadin-popover>` element:
	`56`	`+ * The following custom CSS properties are available for styling:`
`57`	`57`	`*`
`58`	`58`	`* Custom CSS property \| Description`
`59`	`59`	`* ---------------------------------\|-------------`
Original file line number	Diff line number	Diff line change
`@@ -188,7 +188,7 @@ const isLastOverlay = (overlay) => {`
`188`	`188`	`*`
`189`	`189`	`* ### Custom CSS Properties`
`190`	`190`	`*`
`191`		- * The following custom CSS properties are available on the `<vaadin-popover>` element:
	`191`	`+ * The following custom CSS properties are available for styling:`
`192`	`192`	`*`
`193`	`193`	`* Custom CSS property \| Description`
`194`	`194`	`* ---------------------------------\|-------------`
Original file line number	Diff line number	Diff line change
`@@ -59,7 +59,7 @@ export interface TooltipEventMap extends HTMLElementEventMap, TooltipCustomEvent`
`59`	`59`	`*`
`60`	`60`	`* ### Custom CSS Properties`
`61`	`61`	`*`
`62`		- * The following custom CSS properties are available on the `<vaadin-tooltip>` element:
	`62`	`+ * The following custom CSS properties are available for styling:`
`63`	`63`	`*`
`64`	`64`	`* Custom CSS property \| Description`
`65`	`65`	`* ---------------------------------\|-------------`
Original file line number	Diff line number	Diff line change
`@@ -51,7 +51,7 @@ import { TooltipMixin } from './vaadin-tooltip-mixin.js';`
`51`	`51`	`*`
`52`	`52`	`* ### Custom CSS Properties`
`53`	`53`	`*`
`54`		- * The following custom CSS properties are available on the `<vaadin-tooltip>` element:
	`54`	`+ * The following custom CSS properties are available for styling:`
`55`	`55`	`*`
`56`	`56`	`* Custom CSS property \| Description`
`57`	`57`	`* ---------------------------------\|-------------`