Package com.vaadin.flow.component.contextmenu

Class ContextMenuLocator

java.lang.Object
com.vaadin.browserless.locator.Locator<ContextMenu,ContextMenuLocator>
com.vaadin.flow.component.contextmenu.ContextMenuLocator
All Implemented Interfaces:
Clickable<ContextMenu>
@Generated("com.vaadin.browserless.locator.processor.LocatorProcessor") public class ContextMenuLocator extends Locator<ContextMenu,ContextMenuLocator> implements Clickable<ContextMenu>
Generated locator for ContextMenu, derived from ContextMenuTester. Filter steps are inherited from Locator; action methods delegate to a fresh tester around the resolved component, so behavioral changes belong on the tester, not here.

  • Constructor Details

    • ContextMenuLocator

      public ContextMenuLocator()

    • ContextMenuLocator

      public ContextMenuLocator(ContextMenu component)

  • Method Details

    • getComponent

      public ContextMenu getComponent()
      Description copied from interface: Clickable
      Gets the component being tested.
      Specified by:
      getComponent in interface Clickable<ContextMenu>
      Returns:
      the component under test

    • ensureComponentIsUsable

      public void ensureComponentIsUsable()
      Description copied from interface: Clickable
      Ensures the component is in a usable state before interaction.
      Specified by:
      ensureComponentIsUsable in interface Clickable<ContextMenu>

    • open

      public void open()
      Opens the context menu, as if the action is done in the browser.

      It simulates, for example, a right click on a UI component with an assigned ContextMenu.

      It does not render any client-side overlay. In other words, it only simulates the server-side state changes that would occur when a user opens the menu in the browser.

      A closed context menu is not attached to the UI, so, exactly as in the browser, its items cannot be interacted with: open the menu before calling clickItem(...), isItemChecked(...) or getItemTooltipText(...), otherwise they throw an IllegalStateException. Only find(Class) works on a closed menu, since it queries the menu contents instead of the UI; the components it returns are detached until the menu is opened.

      A top level find(...) on the UI is a different matter: the menu content is attached to the UI only while the menu is open, so it is found after open() and not before. Javadoc copied from ContextMenuTester.open().

      Throws:
      IllegalStateException - if the menu is already opened.

    • close

      public void close()
      Closes the context menu. Javadoc copied from ContextMenuTester.close().

    • clickItem

      public void clickItem(String topLevelText, String... nestedItemsText)
      Simulates a click on the item that matches the given text. For a nested menu item, provide the text of each menu item in the hierarchy. The path to the menu item must reflect what is seen in the browser, meaning that hidden items are ignored. If there are multiple visible items at the same level with the same text, an IllegalStateException is thrown because the target is ambiguous. Disabled or invisible items cannot be clicked and will also cause an IllegalStateException. 
       

 menu.addItem("Preview", event -> {
 });
 var subMenu = menu.addItem("Share").getSubMenu();
 subMenu.addItem("Copy link", event -> {
 });
 subMenu.addItem("Email", event -> {
 });

 // clicks top level menu item with text Preview
 tester.clickItem("Preview");

 // clicks nested menu item with text Email
 tester.clickItem("Share", "Email");
      Note: the menu must be opened with open() before an item can be clicked, since a closed menu is not attached to the UI. Javadoc copied from ContextMenuTester.clickItem(java.lang.String,java.lang.String[]).
      Parameters:
      topLevelText - the text content of the top level menu item, not null.
      nestedItemsText - text content of the nested menu items
      Throws:
      IllegalArgumentException - if the provided text does not identify a menu item.
      IllegalStateException - if the menu is not opened, if there are multiple visible matching items at any level, or if the item at the given path is disabled or not visible.

    • clickItem

      public void clickItem(int topLevelPosition, int... nestedItemsPositions)
      Simulates a click on the item at the given position in the menu. For a nested menu item, provide the position of each sub menu that should be navigated to reach the requested item. Positions are zero-based and refer only to items that are visible at each menu level, i.e. hidden items are ignored (the same way as in the browser). Disabled or invisible items cannot be clicked and will cause an IllegalStateException. 
       

 menu.addItem("Preview", event -> {
 });
 var subMenu = menu.addItem("Share").getSubMenu();
 subMenu.addItem("Copy link", event -> {
 });
 subMenu.addItem("Email", event -> {
 });

 // clicks top level "Preview" menu item at position 0
 tester.clickItem(0);

 // clicks then nested menu item at position 1 "Email" through the
 // item "Share" at position 1
 tester.clickItem(1, 1);
      Note: the menu must be opened with open() before an item can be clicked, since a closed menu is not attached to the UI. Javadoc copied from ContextMenuTester.clickItem(int,int[]).
      Parameters:
      topLevelPosition - the zero-based position of the item in the menu, as it will be seen in the browser.
      nestedItemsPositions - the zero-based position of the nested items, relative to the parent menu
      Throws:
      IllegalArgumentException - if the provided position does not identify a menu item.
      IllegalStateException - if the menu is not opened, or if the item at the given position is disabled or not visible.

    • isItemChecked

      public boolean isItemChecked(String topLevelText, String... nestedItemsText)
      Checks if the checkable menu item matching given text is checked. For nested menu item provide the text of each menu item in the hierarchy. The path to the menu item must reflect what is seen in the browser, meaning that hidden items are ignored. 
       

 menu.addItem("Preview", event -> {
 }).setCheckable(true);
 var subMenu = menu.addItem("Share").getSubMenu();
 subMenu.addItem("Copy link", event -> {
 }).setCheckable(true);
 subMenu.addItem("Email", event -> {
 }).setCheckable(true);

 tester.isItemChecked("Preview");

 tester.isItemChecked("Share", "Email");
      Javadoc copied from ContextMenuTester.isItemChecked(java.lang.String,java.lang.String[]).
      Parameters:
      topLevelText - the text content of the top level menu item, not null.
      nestedItemsText - text content of the nested menu items
      Returns:
      true if the item at given path is checked, otherwise false.
      Throws:
      IllegalArgumentException - if the provided text does not identify a menu item or if the menu item is not checkable.
      IllegalStateException - if the menu is not opened, or if the item at given path is not usable.

    • isItemChecked

      public boolean isItemChecked(int topLevelPosition, int... nestedItemsPositions)
      Checks if the checkable menu item at given position is checked. For nested menu item provide the position of each sub menu that should be navigated to reach the requested item. The position reflects what is seen in the browser, so hidden items are ignored. 
       

 menu.addItem("Preview", event -> {
 }).setCheckable(true);
 var subMenu = menu.addItem("Share").getSubMenu();
 subMenu.addItem("Copy link", event -> {
 }).setCheckable(true);
 subMenu.addItem("Email", event -> {
 }).setCheckable(true);

 // checks top level "Preview" menu item at position 0
 tester.isItemChecked(0);

 // checks nested menu item at position 1 "Email" through the
 // item "Share" at position 1
 tester.isItemChecked(1, 1);
      Javadoc copied from ContextMenuTester.isItemChecked(int,int[]).
      Parameters:
      topLevelPosition - the zero-based position of the item in the menu, as it will be seen in the browser.
      nestedItemsPositions - the zero-based position of the nested items, relative to the parent menu
      Throws:
      IllegalArgumentException - if the provided position does not identify a menu item or if the menu item is not checkable.
      IllegalStateException - if the menu is not opened, or if the item at given position is not usable.

    • getItemTooltipText

      public String getItemTooltipText(String topLevelText, String... nestedItemsText)
      Gets the tooltip text of the menu item matching the given text. For a nested menu item, provide the text of each menu item in the hierarchy. The path to the menu item must reflect what is seen in the browser, meaning that hidden items are ignored. 
       

 menu.addItem("Preview", event -> {
 }).setTooltipText("Preview the document");
 var subMenu = menu.addItem("Share").getSubMenu();
 subMenu.addItem("Email", event -> {
 }).setTooltipText("Send as email");

 tester.getItemTooltipText("Preview");

 tester.getItemTooltipText("Share", "Email");
      Javadoc copied from ContextMenuTester.getItemTooltipText(java.lang.String,java.lang.String[]).
      Parameters:
      topLevelText - the text content of the top level menu item, not null.
      nestedItemsText - text content of the nested menu items
      Returns:
      the tooltip text of the menu item at given path, or null if the item has no tooltip set.
      Throws:
      IllegalArgumentException - if the provided text does not identify a menu item.
      IllegalStateException - if the menu is not opened, or if the item at given path is not usable.
      Since:
      1.1

    • getItemTooltipText

      public String getItemTooltipText(int topLevelPosition, int... nestedItemsPositions)
      Gets the tooltip text of the menu item at the given position in the menu. For a nested menu item, provide the position of each sub menu that should be navigated to reach the requested item. The position reflects what is seen in the browser, so hidden items are ignored. 
       

 menu.addItem("Preview", event -> {
 }).setTooltipText("Preview the document");
 var subMenu = menu.addItem("Share").getSubMenu();
 subMenu.addItem("Email", event -> {
 }).setTooltipText("Send as email");

 // gets the tooltip of the top level "Preview" item at position 0
 tester.getItemTooltipText(0);

 // gets the tooltip of the nested "Email" item at position 0 through
 // the item "Share" at position 1
 tester.getItemTooltipText(1, 0);
      Javadoc copied from ContextMenuTester.getItemTooltipText(int,int[]).
      Parameters:
      topLevelPosition - the zero-based position of the item in the menu, as it will be seen in the browser.
      nestedItemsPositions - the zero-based position of the nested items, relative to the parent menu
      Returns:
      the tooltip text of the menu item at given position, or null if the item has no tooltip set.
      Throws:
      IllegalArgumentException - if the provided position does not identify a menu item.
      IllegalStateException - if the menu is not opened, or if the item at given position is not usable.
      Since:
      1.1

    • getItemTexts

      public List<String> getItemTexts()
      Gets the texts of the menu items, as the browser shows them.

      Hidden items are ignored, so the returned texts are aligned with the positions used by clickItem(int, int...). A text can also be given to clickItem(String, String...), as long as it identifies a single enabled item: a text that several visible items share is ambiguous, and a disabled item cannot be clicked.

      An item created from a component has no text of its own, and is reported as an empty string. Use

      invalid reference 
      #find(Class)
      to reach such an item.

      The menu has to be open, since its items are not part of the UI before that. 

       

 menu.addItem("Preview", event -> {
 });
 menu.addItem("Hidden", event -> {
 }).setVisible(false);
 menu.addItem("Share");

 // ["Preview", "Share"]
 tester.getItemTexts();
      Javadoc copied from ContextMenuTester.getItemTexts().
      Returns:
      the texts of the visible top level menu items, in the order they are shown in
      Throws:
      IllegalStateException - if the menu is not open, or is not visible

    • getItemTexts

      public List<String> getItemTexts(String topLevelText, String... nestedItemsText)
      Gets the texts of the items of the sub menu of the item matching the given text, as the browser shows them.

      For a nested sub menu, provide the text of each menu item in the hierarchy, the same way as in clickItem(String, String...).

      Hidden items are ignored at every level, both when following the path and in the returned texts.

      The menu has to be open, since its items are not part of the UI before that. 

       

 var subMenu = menu.addItem("Share").getSubMenu();
 subMenu.addItem("Copy link", event -> {
 });
 subMenu.addItem("Email", event -> {
 });

 // ["Copy link", "Email"]
 tester.getItemTexts("Share");
      Javadoc copied from ContextMenuTester.getItemTexts(java.lang.String,java.lang.String[]).
      Parameters:
      topLevelText - the text content of the top level menu item, not null.
      nestedItemsText - text content of the nested menu items
      Returns:
      the texts of the visible items of the sub menu, in the order they are shown in
      Throws:
      IllegalArgumentException - if the provided text does not identify a menu item, or if the item at the given path has no sub menu.
      IllegalStateException - if the menu is not open or not visible, if there are multiple matching items at any level, or if the item at the given path is disabled or not visible.