Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8290863

Update the documentation of Virtualized controls to include the best practice of not using Nodes directly in the item list

    XMLWordPrintable

Details

    • b17
    • generic
    • generic

    Backports

      Description

        This has come up while analyzing JDK-8277437.

        It is potentially problematic if an Application creates a list of Nodes that it passes into the ListView as the item list. This approach can cause problems with virtualized controls such as ComboBox, ListView, TableView, and TreeTableView, and is not a recommended pattern.


        The documentation for ComboBox is verbose on this.
        --------------------------------------------------
        A recommended way of using a custom cell factory is documented for ComboBox at:
        https://openjfx.io/javadoc/18/javafx.controls/javafx/scene/control/ComboBox.html

        Specifically, see the section titled "A warning about inserting Nodes into the ComboBox items list", which is accompanied by a code snippet showing a
        best practice:

        "Putting nodes into the items list is strongly not recommended.
        --------------------------------------------------


        This bug is to update documentation to articulate this recommendation for other Virtualized controls such as ListView, TableView, and TreeTableView.

        Attachments

          Issue Links

            backported by

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8301689 Update the documentation of Virtualized controls to include the best practice of not using Nodes directly in the item list

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved
            csr for

            CSR - null JDK-8301002 Update the documentation of Virtualized controls to include the best practice of not using Nodes directly in the item list

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Closed
            relates to

            Bug - A problem which impairs or prevents the functions of the product. JDK-8280442 TreeTableView updates invisible cells

            • P3 - Major loss of function.
            • Open

            Bug - A problem which impairs or prevents the functions of the product. JDK-8277437 ListView is not refreshed when navigated through keyboard arrow keys with Narrator application

            • P3 - Major loss of function.
            • Closed

            Bug - A problem which impairs or prevents the functions of the product. JDK-8299958 TreeCell Flicker on TreeView when using Pane

            • P3 - Major loss of function.
            • Closed

            Bug - A problem which impairs or prevents the functions of the product. JDK-8090254 [ListView] page up/down navigation doesn't work, when items are large (again!)

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Closed
            links to

            Commit Commit openjdk/jfx/39d87471

            Review Review openjdk/jfx/995

            Activity

              People

                aghaisas Ajit Ghaisas
                aghaisas Ajit Ghaisas
                Votes:
                0 Vote for this issue
                Watchers:
                6 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved: