Sigueme en Facebook Sigueme en Twitter Sigueme en Instagram Sigueme en Youtube
JC Mouse Bolivia
Index / JavaFX / Control de Paginación (Pagination) en tus Apps FX

Control de Paginación (Pagination) en tus Apps FX

Autor jc mouse martes, julio 26, 2016

El control de paginación de JavaFX (Pagination) se usa para navegar a través de varias paginas de contenido divididas en partes más pequeñas, por ejemplo la lista de correros de GMail usa paginación, los resultados de búsqueda de Google usa paginación.

google page

A continuación crearemos un proyecto FX para aprender a usar este control en tus aplicaciones java. En el ejemplo de este tutorial, se cargara en el paginador una lista de nombres aleatorios entre los que podremos navegar pulsando en cada botón del paginador.

Necesitamos:

  • IDE Netbeans con JavaFX
  • Scene Builder
  • Java

Tiempo: 30 minutos

Nivel: Novato

Paso 1. El Proyecto

Ve al menu Archivo → New Project → JavaFX (Categories) → JavaFX FXML Application (Projects)

A continuación escribe el nombre del proyecto “JavaFXPagination”  y deja el resto de los valores por defecto.

tutorial fx

Clic en Terminar para crear el proyecto.

fx bolivia

Paso 2. La Vista

Doble clic sobre “FXMLDocument.fxml” para abrir el archivo en el Scene Builder, elimina el Button y Label creados por defecto, en el menú desplegable “Controls“, busca el control Pagination y arrastra hasta el diseñador. Con ayuda del mouse dale un ancho y alto de 300×300 y acomodalo en la interfaz. Es el único control que utilizaremos en la interfaz.

pagination

Con el control Pagination seleccionado, en el menú de la derecha busca la opción “Code“, busca la propiedad fx:id y escribe “pagination” este es el nombre con el que identificaremos al control desde el código. Podemos cambiar sus propiedades desde esta vista, pero lo haremos todo por código. Guarda los cambios y cierra el Scene Builder.

Paso 3. Código extra

Antes de proseguir, con el Controlador, definiremos una clase aparte el cual tendrá 2 métodos, un método para generar nombres aleatorios y otro método para generar colores en formato hexadecimal, también aleatorios.

Para crear el archivo, clic derecho sobre el paquete “javafxpagination” new → Java Class… el nombre de la clase sera “Dummy“, es solo un nombre, puede ser cualquier otro 🙂 , lo importante son las funciones que contiene.

La clase es la siguiente:

package javafxpagination;
import java.util.ArrayList;
import java.util.Random;
/**
 * @see https://www.jc-mouse.net/
 * @author mouse
 */
public class Dummy {
    
    /**
     * Genera un nombre aleatorio
     * @return String nombre de la forma Juan Perez Pereira
     */
    static String getFullName(){
        Random randomGenerator  = new Random();   
        
        ArrayList<String> name = new ArrayList();        
        name.add("Juan");name.add("Carmen");
        name.add("Maria");name.add("Camila");
        name.add("Pablo");name.add("Cornelio");
        name.add("Anibal");name.add("Ruben");
        name.add("Julio");name.add("Manfred");
        name.add("Ana");name.add("Luis");
        name.add("Luz");name.add("Lucas");
        name.add("Gretta");name.add("Lauren");
        
        ArrayList<String> lastName = new ArrayList();        
        lastName.add("Perez");lastName.add("Bayle");
        lastName.add("Panama");lastName.add("Simpsons");
        lastName.add("Choque");lastName.add("Bush");
        lastName.add("Tamayo");lastName.add("Obama");
        lastName.add("da Silva");lastName.add("Trump");
        lastName.add("Souza");lastName.add("Toledo");
        
        String fullName = name.get(randomGenerator.nextInt(name.size())) +  " " + 
                          lastName.get(randomGenerator.nextInt(lastName.size())) + " " + 
                          lastName.get(randomGenerator.nextInt(lastName.size()));        
        return fullName;
    }
    
    /**
     * Genera un color aleatorio en formato hexadecimal
     * @return String color de la forma #FFFFFF
     */
    static String randomHexColor(){
        Random randomGenerator = new Random();        
        int r =  randomGenerator.nextInt(155) + 100;
        int g =  randomGenerator.nextInt(155) + 100;
        int b =  randomGenerator.nextInt(155) + 100;
        return String.format("#%02x%02x%02x", r, g, b);         
    }
    
}//end Dummy

Paso 4. El Controlador

Una vez definido la clase Dummy con todos los métodos que necesitamos, abrimos el archivo “FXMLDocumentController” y podremos ver algo como esto:

 1 public class FXMLDocumentController implements Initializable {
 2     
 3     @FXML
 4     private Label label;
 5     
 6     @FXML
 7     private void handleButtonAction(ActionEvent event) {
 8         System.out.println("You clicked me!");
 9         label.setText("Hello World!");
10     }
11     
12     @Override
13     public void initialize(URL url, ResourceBundle rb) {
14         // TODO
15     }    
16     
17 }

Borra desde la linea de código 3 hasta la 10.

Reemplaza los imports por los siguientes:

import java.net.URL;
import java.util.ResourceBundle;
import javafx.fxml.FXML;
import javafx.fxml.Initializable;
import javafx.scene.Node;
import javafx.scene.control.Label;
import javafx.scene.control.Pagination;
import javafx.scene.layout.VBox;
import javafx.util.Callback;

Declara el control de Pagination que agregamos en la vista

@FXML Pagination pagination;

En el método initialize del controlador, agrega el siguiente código:

    @Override
    public void initialize(URL url, ResourceBundle rb) {
        //Propiedades del control Pagination        
        pagination.setMaxPageIndicatorCount(7);//Cantidad de botones para el paginador
        pagination.setPageCount(12);//cantidad de paginas
        pagination.setStyle("-fx-border-color:green;");//estilo CSS del control FX
        //establece lo que retornara el paginador cuando se haga clic en algun boton
        pagination.setPageFactory(new Callback<Integer, Node>() {
            @Override
            public Node call(Integer pageIndex) {
                return createPage(pageIndex);
            }
        });
    }    

Para terminar, definimos el método que creara la pagina que veremos en el paginador cuando hagamos un clic sobre algún botón:

    /**
     * Crea el contenido del control de paginacion 
     * llamado por el metodo setPageFactory 
     * @param pageIndex posicion del paginador
     * @return VBox Contenedor
     */
    public VBox createPage(int pageIndex) {        
        int itemsPerPage = 8;//items por pagina
        VBox box = new VBox();//contenedor
        int page = pageIndex * itemsPerPage;         
        for (int i = page; i < page + itemsPerPage; i++) {            
            //Crea un Label con un nombre aleatorio
            Label text = new Label( (i+1) + ".- " + Dummy.getFullName());
            //Agrega estilo CSS al Label con un color de fonto aleatorio
            text.setStyle("-fx-font-size:16;-fx-background-color:" + Dummy.randomHexColor() + 
                          ";-fx-pref-width:300px;-fx-padding:8px 0 8px 8px;");            
            box.getChildren().add(text);
        }
        return box;
    }

Ejecutamos y tenemos:

javafx pagination

BONUS

Si quieres cambiar el estilo del paginador puedes usar CSS, otra opción es agregar la siguiente linea de código en el método initialize del controlador:

pagination.getStyleClass().add(Pagination.STYLE_CLASS_BULLET);

Y así tenemos:

fx latam

enjoy!!!

Tags

Si te ha gustado podrías compartirlo o dejar un comentario. ¡Muchas gracias!
Autor: JC Mouse

Yo soy yo :) JC Mouse, Soy orgullosamente boliviano soy fundador y CEO de la web jc-Mouse.net uno de las pocas web en emprendimiento y tecnología en Bolivia.

Toda la información que encuentres en este sitio es y sera completamente gratis siempre, puedes copiar, descargar y re-publicar si así lo deseas en otros blogs o sitios web, solo te pido a cambio que dejes una referencia a esta web. Esto nos ayuda a crecer y seguir aportando. Bye

Enjoy! :)

También Te Podría Interesar

Reproductor de video con VLCJ

Reproductor de video con VLCJ

VLC Media Player es un reproductor multimedia de código abierto muy popular desarrollado por el proyecto VideoLAN. VLCJ...

Tangram: El rompecabezas chino

Tangram: El rompecabezas chino

El Tangram es un juego chino muy antiguo, esta compuesto por 7 piezas: un paralelogramo (romboide), un cuadrado y 5 triá...

Control de Stock en Java (Parte 1)

Control de Stock en Java (Parte 1)

Un SGA “Sistema de Gestión de Almacenes”  es un programa informático destinado a gestionar las entradas y sa...

Procedimientos Almacenados: Parámetros INOUT

Procedimientos Almacenados: Parámetros INOUT

En post anteriores vimos lo que son los parámetros IN y los parámetros OUT pero existe otro tipo de parámetro que es la...

Servicio Web SOAP en Java

Servicio Web SOAP en Java

En este post vamos a construir un Servicio Web bajo el protocolo SOAP (Simple Object Access Protocol) el cual básicament...

Agregar soporte para JNLP en servidor Apache

Agregar soporte para JNLP en servidor Apache

Java Network Launching Protocol (JNLP) es una especificación usada por Java Web Start. Esta especificación, permite tene...

Comparte lo que sabes

Categorias

Últimas entradas

“MyBatis es una herramienta de persistencia Java que se encarga de mapear sentencias SQL y procedimientos almacena...

MyBatis es un framework de persistencia Java que se encarga de mapear sentencias SQL y procedimientos almacenados a part...

Webcam Capture es un API  que permite usar una cámara web incorporada o externa directamente desde código Java utilizand...

im4java es una interfaz pura de Java para la línea de comandos de ImageMagick. La interfaz de la línea de comandos de IM...

Herramientas

Generador de Enlaces a Whatsapp