@@ -33,6 +33,36 @@ export type PopoverEventMap = HTMLElementEventMap & PopoverCustomEventMap;
3333 * Unlike `<vaadin-tooltip>`, the popover supports rich content
3434 * that can be provided by using `renderer` function.
3535 *
36+ * ### Styling
37+ *
38+ * `<vaadin-popover>` uses `<vaadin-popover-overlay>` internal
39+ * themable component as the actual visible overlay.
40+ *
41+ * See [`<vaadin-overlay>`](#/elements/vaadin-overlay) documentation
42+ * for `<vaadin-popover-overlay>` parts.
43+ *
44+ * The following state attributes are available for styling:
45+ *
46+ * Attribute | Description
47+ * -----------------|----------------------------------------
48+ * `position` | Reflects the `position` property value.
49+ *
50+ * Note: the `theme` attribute value set on `<vaadin-popover>` is
51+ * propagated to the internal `<vaadin-popover-overlay>` component.
52+ *
53+ * ### Custom CSS Properties
54+ *
55+ * The following custom CSS properties are available on the `<vaadin-popover>` element:
56+ *
57+ * Custom CSS property | Description
58+ * ---------------------------------|-------------
59+ * `--vaadin-popover-offset-top` | Used as an offset when the popover is aligned vertically below the target
60+ * `--vaadin-popover-offset-bottom` | Used as an offset when the popover is aligned vertically above the target
61+ * `--vaadin-popover-offset-start` | Used as an offset when the popover is aligned horizontally after the target
62+ * `--vaadin-popover-offset-end` | Used as an offset when the popover is aligned horizontally before the target
63+ *
64+ * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
65+ *
3666 * @fires {CustomEvent } opened-changed - Fired when the `opened` property changes.
3767 */
3868declare class Popover extends PopoverPositionMixin (
0 commit comments