Uso básico de elementos Swing con NetBeans – 11 – Uso básico de JEditorPane y JPanel, visualizar documento HTML.

Visualizar documentos HTML con JEditorPane

En esta oportunidad veremos el uso que se le puede dar a un “JEditorPane”, precisamente la utilizaremos para abrir un documento HTML. Es un elemento útil para la apertura de documentos en texto plano o del tipo HTML. El ejemplo es sencillo, agregaremos nuestro “JEditorPane” dentro de un panel junto con dos botones, al apretar cada botón se podrá visualizar un ejemplo de documento HTML. Los documentos HTML deberán estar dentro del mismo paquete que nuestro formulario.

Diseñamos un formulario utilizando un JFrame (Nombre del formulario UsoJEditorPane). Como se ve en la imagen, agregamos un JPanel al cual le especificamos un borde con texto, esto se consigue modificando la propiedad “border” e indicando que sea “Borde con título”; dentro del JPanel agregamos nuestro JEditorPane. En la imagen siguiente vemos el diseño de nuestro formulario, cada elemento tiene un nombre de variable como se especifica en la imagen, tomar en cuenta este punto ya que es necesario para referenciar los objetos. Se puede cambiar el “Nombre de variable” de cada objeto haciendo clic derecho sobre la misma y clic en “Cambiar nombre de variable…”. (clic sobre la imagen para ampliar)

En este caso creamos dos métodos similares, cada una se relacionará con un documento HTML distinto. Se agregan comentario para conocer el funcionamiento de cada línea de código.

    private void inicio(){
        //jep es el nombre de variable de nuesto JEditorPane.
        //indicamos que no sea editable.
        jep.setEditable(false);
        //Utilizamos el método siguiente para referenciar nuestro HTML
        //Para ejemplo se puede usar cualquier documento HTML, tomar en cuenta el nombre.
        java.net.URL urlHtm = UsoJEditorPane.class.getResource("Welcome.html");
        //Se ejecuta si no se retorna vacio.
        if (urlHtm != null){
            //Control de posibles errores de lectura.
            try {
                //Método para cargar el documento HTML al JEditorPane
                jep.setPage(urlHtm);
            } catch (IOException e) {
                System.err.println("No se puede leer la URL: " + urlHtm + e);
            }
        }
        //Se ejecuta en caso que retorne vacio.
        else{
            JOptionPane.showMessageDialog(null, "No se pudo cargar la url...");
        }
       
    }
    //Método similar a la anterior, solo varia el nombre del documento HTML
    private void inicioDos(){
        jep.setEditable(false);
        java.net.URL urlHtm = UsoJEditorPane.class.getResource("bookmarks.html");
        if (urlHtm != null){
            try {
                jep.setPage(urlHtm);
            } catch (IOException e) {
                System.err.println("No se puede leer la URL: " + urlHtm + e);
            }
        }
        else{
            JOptionPane.showMessageDialog(null, "No se pudo cargar la url...");
        }
       
    }

En la imagen siguiente vemos las importaciones que necesitamos, nuestro paquete si la utilizamos y el método que llámanos desde el constructor.

El paso siguiente es establece eventos para los botones, esto les dará la funcionalidad que necesitamos. El evento que normalmente se utiliza para este tipo de elementos es el ActionPerformed. Si ya vieron alguna guía anterior a esta podrán saber cómo se agrega un evento, la ubicación habitual tanto para la lista de eventos, como también los métodos que hayamos creado al igual de la forma en que se implementan estos eventos y llamadas a métodos.

    private void jButton1ActionPerformed(java.awt.event.ActionEvent evt) {                                         
        inicio();
    }                                        

    private void jButton2ActionPerformed(java.awt.event.ActionEvent evt) {                                         
        inicioDos();
    }   

En este punto ya podremos ejecutar nuestro formulario y comprobar su funcionalidad. (Por si hay alguna duda en el proceso, debemos hacer clic derecho sobre nuestro archivo fuente y presionar “ejecutar archivo” ya que nuestro proyecto no tiene una clase principal definida)