Package 

Class GridTester

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description

    • Field Summary

      Fields 
      Modifier and Type Field Description

    • Constructor Summary

      Constructors 
      Constructor Description
      GridTester(T component) Wrap grid for testing.

    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description

    • Method Summary

      Modifier and Type Method Description
      int size() Get the amount of items in the grid.
      Y getRow(int row) Get the item at the given row index.
      void clickRow(int row) Click on grid row.
      void clickRow(int row, MouseButton button) Click on grid row with given button.
      void clickRow(int row, MetaKeys metaKeys) Click on grid row with given meta keys pressed.
      void clickRow(int row, MouseButton button, MetaKeys metaKeys) Click on grid row with given button and meta keys pressed.
      void doubleClickRow(int row) Double click on grid row.
      void doubleClickRow(int row, MouseButton button) Double click on grid row with given button.
      void doubleClickRow(int row, MetaKeys metaKeys) Double click on grid row with given meta keys pressed.
      void doubleClickRow(int row, MouseButton button, MetaKeys metaKeys) Double click on grid row with given button and meta keys pressed.
      void select(int row) Select the item on given row.
      void selectAll() Select all items in grid.
      String getCellText(int row, int column) Get the text that is shown on the client for the cell in the given position.
      Component getCellComponent(int row, int column) Get component for item in cell.
      Component getCellComponent(int row, String columnName) Get component for item in column.
      String getHeaderCell(int column) Get content in header for given column.
      int getColumnPosition(String property) Get the column position by column property.
      Grid.Column<Y> getColumn(String property) Gets the grid column by column property.
      String getFooterCell(int column) Get content in footer for given column.
      Collection<Y> getSelected() Get selected items.
      boolean isColumnSortable(int column) Checks if the column at the given index is sortable.
      boolean isColumnSortable(String property) Checks if the column for the given property is sortable.
      SortDirection getSortDirection(int column) Gets the current sort direction for column at the given index.
      SortDirection getSortDirection(String property) Gets the current sort direction for column corresponding to the at the given property.
      void sortByColumn(int column, SortDirection direction) Sorts the grid by the given column and sort direction, as if the column header is pressed in the browser until the requested direction is reached.
      void sortByColumn(int column) Sorts the grid according to the given column sort status, as if the column header is pressed in the browser.
      void sortByColumn(String property) Sorts the grid according to sort status ot the column identified by the given property, as if the column header is pressed in the browser.
      void sortByColumn(String property, SortDirection direction) Sorts the grid by the given column and sort direction, as if the column header is pressed in the browser until the requested direction is reached.

      • Methods inherited from class com.vaadin.testbench.unit.ComponentTester

        find, getComponent, isUsable, setModal

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • GridTester

        GridTester(T component)
        Wrap grid for testing.
        Parameters:
        component - target grid

    • Method Detail

      • size

         int size()

        Get the amount of items in the grid.

      • getRow

         Y getRow(int row)

        Get the item at the given row index.

        The index is 0 based.
        Parameters:
        row - row index of to get

      • clickRow

         void clickRow(int row)

        Click on grid row.

        The index is 0 based.
        Parameters:
        row - row to click

      • clickRow

         void clickRow(int row, MouseButton button)

        Click on grid row with given button.

        The index is 0 based.
        Parameters:
        row - row to click
        button - MouseButton that was clicked

      • clickRow

         void clickRow(int row, MetaKeys metaKeys)

        Click on grid row with given meta keys pressed.

        The index is 0 based.
        Parameters:
        row - row to click
        metaKeys - meta key statuses for click

      • clickRow

         void clickRow(int row, MouseButton button, MetaKeys metaKeys)

        Click on grid row with given button and meta keys pressed.

        The index is 0 based.
        Parameters:
        row - row to click
        button - MouseButton that was clicked
        metaKeys - meta key statuses for click

      • doubleClickRow

         void doubleClickRow(int row)

        Double click on grid row.

        The index is 0 based.
        Parameters:
        row - row to click

      • doubleClickRow

         void doubleClickRow(int row, MouseButton button)

        Double click on grid row with given button.

        The index is 0 based.
        Parameters:
        row - row to click
        button - MouseButton that was clicked

      • doubleClickRow

         void doubleClickRow(int row, MetaKeys metaKeys)

        Double click on grid row with given meta keys pressed.

        The index is 0 based.
        Parameters:
        row - row to click
        metaKeys - meta key statuses for click

      • doubleClickRow

         void doubleClickRow(int row, MouseButton button, MetaKeys metaKeys)

        Double click on grid row with given button and meta keys pressed.

        The index is 0 based.
        Parameters:
        row - row to click
        button - MouseButton that was clicked
        metaKeys - meta key statuses for click

      • select

         void select(int row)

        Select the item on given row.

        The index is 0 based. Single select will clear any old selections. Multi select will add to selection.
        Parameters:
        row - row to select

      • selectAll

         void selectAll()

        Select all items in grid.

        Only works for multi select.

      • getCellText

         String getCellText(int row, int column)

        Get the text that is shown on the client for the cell in the given position.

        The indexes for row and column are 0 based. For the default renderer ColumnPathRenderer the result is the sent text for defined object path. For a ComponentRenderer the result is the rendered component as prettyString. TODO: to be added as we find other renderers that need handling.
        Parameters:
        row - row of cell
        column - column of cell

      • getCellComponent

         Component getCellComponent(int row, int column)

        Get component for item in cell.

        Parameters:
        row - item row
        column - column to get

      • getCellComponent

         Component getCellComponent(int row, String columnName)

        Get component for item in column.

        Parameters:
        row - item row
        columnName - key/property of column

      • getHeaderCell

        @Deprecated() String getHeaderCell(int column)

        Get content in header for given column.

        Parameters:
        column - column to get header for

      • getColumnPosition

         int getColumnPosition(String property)

        Get the column position by column property.

        Parameters:
        property - the property name of the column, not null

      • getColumn

         Grid.Column<Y> getColumn(String property)

        Gets the grid column by column property.

        Parameters:
        property - the property name of the column, not null

      • getFooterCell

        @Deprecated() String getFooterCell(int column)

        Get content in footer for given column.

        Parameters:
        column - column to get footer for

      • isColumnSortable

         boolean isColumnSortable(int column)

        Checks if the column at the given index is sortable.

        The index is 0 based.
        Parameters:
        column - column index to check for sort feature

      • isColumnSortable

         boolean isColumnSortable(String property)

        Checks if the column for the given property is sortable.

        Parameters:
        property - the property name of the column, not null

      • getSortDirection

         SortDirection getSortDirection(int column)

        Gets the current sort direction for column at the given index. Throws an exception if the column does not exists or is not sortable.

        Parameters:
        column - column index to get sort direction

      • getSortDirection

         SortDirection getSortDirection(String property)

        Gets the current sort direction for column corresponding to the at the given property. Throws an exception if the column does not exist or is not sortable.

        Parameters:
        property - the property name of the column, not null

      • sortByColumn

         void sortByColumn(int column, SortDirection direction)

        Sorts the grid by the given column and sort direction, as if the column header is pressed in the browser until the requested direction is reached. Throws an exception if the column is not sortable or not visible.

        Parameters:
        column - column index
        direction - sort direction

      • sortByColumn

         void sortByColumn(int column)

        Sorts the grid according to the given column sort status, as if the column header is pressed in the browser. Throws an exception if the column is not sortable or not visible.

        Parameters:
        column - column index

      • sortByColumn

         void sortByColumn(String property)

        Sorts the grid according to sort status ot the column identified by the given property, as if the column header is pressed in the browser. Throws an exception if the column is not sortable or not visible.

        Parameters:
        property - the property name of the column, not null

      • sortByColumn

         void sortByColumn(String property, SortDirection direction)

        Sorts the grid by the given column and sort direction, as if the column header is pressed in the browser until the requested direction is reached. Throws an exception if the column is not sortable or not visible.

        Parameters:
        property - the property name of the column, not null
        direction - sort direction