Outdated version of the documentation. Find the latest one here.

La cornice HTML

Puoi aggiungere una cornice che consente di visualizzare i contenuti di un sito web o anche creare una pagina HTML e visualizzarla!

Clicca sull’icona addHtml Aggiungi cornice HTML, posiziona l’elemento trascinando un rettangolo tenendo premuto il tasto sinistro del mouse sulla tavola di stampa e personalizzala nella scheda Item Properties (see figure_composer_html_1).

Figure Composer HTML 1:

../../../../_images/html_properties.png

Corinice HTML, la scheda delle proprietà nix

Sorgente HTML

Come sorgente di HTML, è possibile impostare un URL e attivare il pulsante radio URL o inserire il codice HTML direttamente nella casella di testo e attivare il pulsante radio Sorgente.

Il punto Sorgente HTML della cornice HTML della scheda Proprietà oggetto fornisce le seguenti funzionalità (vedi figure_composer_html_2):

Figure Composer HTML 2:

../../../../_images/html_source.png

Corinice HTML, le proprietà di Sorgente HTML nix

  • In URL puoi inserire l’URL di una pagina web copiata dal browser oppure selezionare un file HTML utilizzando il pulsante Sfoglia browseButton. C’è anche la possibilità di utilizzare il pulsante Descrizione definita dei dati per fornire un URL dai contenuti di un campo attributo di una tabella o utilizzando un’espressione regolare.

  • In Sorgente puoi inserire il testo nella casella con tag HTML o fornire una pagina HTML completa.

  • Puoi usare il pulsante **[Inserisci un’espressione] ** per inserire un’espressione come ``[%Year($now)%]`nella casella Sorgente per visualizzare l’anno in corso. Questo pulsante viene attivato solo quando il bottone radio Sorgente è selezionato. Dopo aver inserito l’espressione clicca da qualche parte nella casella di testo prima di aggiornare il frame HTML, altrimenti si perde l’espressione.

  • Attiva checkbox Valuta le espressioni QGIS in HTML per vedere il risultato dell’espressione che hai incluso.

  • Utilizza il pulsante [Aggiorna HTML] per aggiornare la cornice HTML e vedere il risultato di cambiamenti.

Cornici

Il punto Cornici della cornice HTML della scheda Proprietà oggetto fornisce le seguenti funzionalità (vedi figure_composer_html_3):

Figure Composer HTML 3:

../../../../_images/html_frame.png

HTML frame, the Frames properties nix

  • With Resize mode you can select how to render the HTML contents:
    • Use existing frames displays the result in the first frame and added frames only.
    • Extend to next page will create as many frames (and corresponding pages) as necessary to render the height of the web page. Each frame can be moved around on the layout. If you resize a frame, the webpage will be divided up between the other frames. The last frame will be trimmed to fit the web page.
    • Repeat on every page will repeat the upper left of the web page on every page in frames of the same size.
    • Repeat until finished will also create as many frames as the Extend to next page option, except all frames will have the same size.
  • Use the [Add Frame] button to add another frame with the same size as selected frame. If the HTML page that will not fit in the first frame it will continue in the next frame when you use Resize mode or Use existing frames.
  • Activate checkbox Don’t export page if frame is empty prevents the map layout from being exported when the frame has no HTML contents. This means all other composer items, maps, scalebars, legends etc. will not be visible in the result.
  • Activate checkbox Don’t draw background if frame is empty prevents the HTML frame being drawn if the frame is empty.

Use smart page breaks and User style sheet

The Use smart page breaks dialog and Use style sheet dialog of the HTML frame Item Properties tab provides the following functionalities (see figure_composer_html_4):

Figure Composer HTML 4:

../../../../_images/html_breaks.png

HTML frame, Use smart page breaks and User stylesheet properties nix

  • Activate checkbox Use smart page breaks to prevent the html frame contents from breaking mid-way a line of text so it continues nice and smooth in the next frame.

  • Set the Maximum distance allowed when calculating where to place page breaks in the html. This distance is the maximum amount of empty space allowed at the bottom of a frame after calculating the optimum break location. Setting a larger value will result in better choice of page break location, but more wasted space at the bottom of frames. This is only used when Use smart page breaks is activated.

  • Activate checkbox User stylesheet to apply HTML styles that often is provided in cascading style sheets. An example of style code is provide below to set the color of <h1> header tag to green and set the font and fontsize of text included in paragraph tags <p>.

    h1 {color: #00ff00;
    }
    p {font-family: "Times New Roman", Times, serif;
       font-size: 20px;
    }
    
  • Use the [Update HTML] button to see the result of the stylesheet settings.