{
  "$schema": "https://json.schemastore.org/web-types",
  "name": "@vaadin/popover",
  "version": "25.0.0-rc1",
  "description-markup": "markdown",
  "framework": "lit",
  "framework-config": {
    "enable-when": {
      "node-packages": [
        "lit"
      ]
    }
  },
  "contributions": {
    "html": {
      "elements": [
        {
          "name": "vaadin-popover",
          "description": "`<vaadin-popover>` is a Web Component for creating overlays\nthat are positioned next to specified DOM element (target).\n\nUnlike `<vaadin-tooltip>`, the popover supports rich content\nthat can be provided by using `renderer` function.\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name        | Description\n-----------------|-------------------------------------------\n`backdrop`       | Backdrop of the overlay\n`overlay`        | The overlay container\n`content`        | The overlay content\n`arrow`          | Optional arrow pointing to the target when using `theme=\"arrow\"`\n\nThe following state attributes are available for styling:\n\nAttribute        | Description\n-----------------|----------------------------------------\n`position`       | Reflects the `position` property value.\n\n### Custom CSS Properties\n\nThe following custom CSS properties are available for styling:\n\nCustom CSS property              | Description\n---------------------------------|-------------\n`--vaadin-popover-offset-top`    | Used as an offset when the popover is aligned vertically below the target\n`--vaadin-popover-offset-bottom` | Used as an offset when the popover is aligned vertically above the target\n`--vaadin-popover-offset-start`  | Used as an offset when the popover is aligned horizontally after the target\n`--vaadin-popover-offset-end`    | Used as an offset when the popover is aligned horizontally before the target\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
          "extension": true,
          "attributes": [
            {
              "name": "?autofocus",
              "description": "When true, the popover content automatically receives focus after\nit is opened. Modal popovers use this behavior by default.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": "?opened",
              "description": "True if the popover is visible and available for interaction.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": "?modal",
              "description": "When true, the popover prevents interacting with background elements\nby setting `pointer-events` style on the document body to `none`.\nThis also enables trapping focus inside the popover.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": "?noCloseOnOutsideClick",
              "description": "Set to true to disable closing popover on outside click.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": "?noCloseOnEsc",
              "description": "Set to true to disable closing popover on Escape press.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": "?withBackdrop",
              "description": "When true, the popover has a backdrop (modality curtain) on top of the\nunderlying page content, covering the whole viewport.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".position",
              "description": "Position of the overlay with respect to the target.\nSupported values: `top-start`, `top`, `top-end`,\n`bottom-start`, `bottom`, `bottom-end`, `start-top`,\n`start`, `start-bottom`, `end-top`, `end`, `end-bottom`.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".for",
              "description": "The id of the element to be used as `target` value.\nThe element should be in the DOM by the time when\nthe attribute is set, otherwise a warning is shown.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".target",
              "description": "Reference to the DOM element used both to trigger the overlay\nby user interaction and to visually position it on the screen.\n\nDefaults to an element referenced with `for` attribute, in\nwhich case it must be located in the same shadow scope.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".accessibleName",
              "description": "String used to label the popover to screen reader users.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".accessibleNameRef",
              "description": "Id of the element used as label of the popover to screen reader users.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".height",
              "description": "Set the height of the popover.\nIf a unitless number is provided, pixels are assumed.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".width",
              "description": "Set the width of the popover.\nIf a unitless number is provided, pixels are assumed.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".focusDelay",
              "description": "The delay in milliseconds before the popover is opened\non focus when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".hideDelay",
              "description": "The delay in milliseconds before the popover is closed\non losing hover, when the corresponding trigger is used.\nOn blur, the popover is closed immediately.\n\nWhen not specified, the global default (500ms) is used.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".hoverDelay",
              "description": "The delay in milliseconds before the popover is opened\non hover when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".role",
              "description": "The `role` attribute value to be set on the popover.\nWhen not specified, defaults to 'dialog'.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".overlayRole",
              "description": "The `role` attribute value to be set on the popover.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".renderer",
              "description": "Custom function for rendering the content of the popover.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `popover` The reference to the `vaadin-popover` element.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": ".trigger",
              "description": "Popover trigger mode, used to configure how the popover is opened or closed.\nCould be set to multiple by providing an array, e.g. `trigger = ['hover', 'focus']`.\n\nSupported values:\n- `click` (default) - opens and closes on target click.\n- `hover` - opens on target mouseenter, closes on target mouseleave. Moving mouse\nto the popover content keeps the popover opened.\n- `focus` - opens on target focus, closes on target blur. Moving focus to the\npopover content keeps the popover opened.\n\nIn addition to the behavior specified by `trigger`, the popover can be closed by:\n- pressing Escape key (unless `noCloseOnEsc` property is true)\n- outside click (unless `noCloseOnOutsideClick` property is true)\n\nWhen setting `trigger` property to `null`, `undefined` or empty array, the popover\ncan be only opened programmatically by changing `opened` property. Note, closing\non Escape press or outside click is still allowed unless explicitly disabled.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": "@closed",
              "description": "Fired when the popover is closed.",
              "value": {
                "kind": "expression"
              }
            },
            {
              "name": "@opened-changed",
              "description": "Fired when the `opened` property changes.",
              "value": {
                "kind": "expression"
              }
            }
          ]
        }
      ]
    }
  }
}