Descrizioni avanzate

La descrizione di un segnaposto può essere più di un paragrafo di testo. Scrivi un piccolo insieme di tag HTML nel campo della descrizione e il popup del segnaposto li visualizza: titoli, grassetto e corsivo, codice in linea, elenchi, link, tabelle e un grafico a linee incorporato.

Il testo semplice continua a funzionare esattamente come prima — se non usi alcun tag, non cambia nulla.

Formattazione, elenchi e link

Un popup di segnaposto che mostra un titolo, testo in grassetto e corsivo, un frammento di codice in linea, un elenco puntato e un link.

Quel popup deriva da questa descrizione:

<h2>Site notes</h2>
Readings look <b>stable</b>, but sensor <code>A1</code> is <i>drifting</i>.
<ul><li>Recalibrate on Tuesday</li><li>Replace the battery</li></ul>
<a href="https://www.swisstopo.admin.ch">Reference station data</a>

Tag utilizzabili

Scopo	Tag
Enfasi	`<b>` `<strong>` `<i>` `<em>` `<u>`
Codice	`<code>`
Titoli	`<h1>` `<h2>` `<h3>`
Elenchi	`<ul>` `<ol>` `<li>`
Paragrafi e interruzioni	`<p>` `<br>` `<hr>`
Link	`<a href="https://…">`
Tabelle	`<table>` `<tr>` `<th>` `<td>` (`<thead>`/`<tbody>` facoltativi)
Grafici	`<chart>` — vedi più sotto

Le righe vuote iniziano un nuovo paragrafo e le interruzioni di riga singole vengono mantenute: puoi quindi scrivere testo normale e ricorrere a un tag solo dove serve.

Aggiungere una tabella

Un popup di segnaposto con una tabella a tre colonne di stazioni, livelli dell’acqua e tendenze, con la riga di intestazione ombreggiata.

<h3>Water level by station</h3>
<table>
<tr><th>Station</th><th>Level</th><th>Trend</th></tr>
<tr><td>A1</td><td>2.4 m</td><td>rising</td></tr>
<tr><td>B7</td><td>1.9 m</td><td>steady</td></tr>
<tr><td>C3</td><td>3.1 m</td><td>falling</td></tr>
</table>

Una prima riga composta interamente da celle <th> diventa l’intestazione. Non servono <thead> né <tbody> — vengono aggiunti per te. Un segnaposto con una tabella ottiene un popup più largo, e una tabella molto larga scorre lateralmente al suo interno.

Il testo delle tabelle è ricercabile: il pannello Segnaposto trova un segnaposto anche da un valore che compare solo dentro una cella.

Aggiungere un grafico a linee

Inserisci un tag <chart> nella descrizione, con i suoi dati in JSON all’interno.

Un popup di segnaposto con un grafico a linee a due serie del livello dell’acqua per settimana, con legenda sopra il tracciato e assi etichettati.

<chart>{
  "v": 1,
  "type": "line",
  "title": "Water level",
  "xLabel": "week",
  "yLabel": "m",
  "series": [
    { "label": "A1", "points": [[1, 2.1], [2, 2.4], [3, 2.2], [4, 2.9]] },
    { "label": "B7", "points": [[1, 3.4], [2, 3.1], [3, 3.6], [4, 3.2]] }
  ]
}</chart>

Ogni voce di series è una linea. points è un elenco di coppie [x, y] — non devono essere in ordine. title, xLabel, yLabel e il label di ciascuna serie sono facoltativi; vale la pena aggiungere un label quando hai più di una linea, perché la identifica nella legenda.

Campo	Note
`v`	Sempre `1`.
`type`	Sempre `"line"`.
`series`	Da 1 a 4 serie, fino a 1.000 punti in totale.
`label`	Nome della serie, mostrato nella legenda.
`color`	Colore esadecimale facoltativo, ad esempio `"#315ee7"`. Omettilo per usare la palette integrata.

Ogni linea riceve un colore proprio e un proprio tratteggio, così le linee restano distinguibili anche stampate in bianco e nero o lette da chi ha un deficit della visione dei colori.

Anteprima durante la scrittura

Comporre alla cieca una tabella o il JSON di un grafico non è piacevole, perciò il campo della descrizione ha un interruttore Anteprima. Mostra esattamente ciò che apparirà nel popup.

Il pannello Aggiungi segnaposto con l’anteprima della descrizione attivata, che mostra una tabella e un grafico sotto il campo di testo.

Digita la descrizione nel pannello Aggiungi segnaposto o Modifica segnaposto.
Fai clic su Anteprima sopra il campo.
Il risultato compare sotto. Continua a modificare — si aggiorna mentre scrivi.

Primo piano del riquadro di anteprima della descrizione con la tabella e il grafico a linee resi.

Da sapere

Ovunque altrove compare testo semplice. L’elenco dei segnaposto, i richiami della presentazione, la vista cronologia e i file esportati mostrano una versione testuale leggibile della descrizione. Solo il popup sulla mappa rende la formattazione.
Le descrizioni sono condivise. Tutti nella stanza — e chiunque consulti una stanza pubblica — vedono ciò che scrivi, reso allo stesso modo in cui lo vedi tu.
C’è un limite di dimensione. Una descrizione può arrivare a 20.000 caratteri. Il campo ti avvisa quando ti avvicini, e una descrizione oltre il limite ricade su testo semplice.
Le esportazioni conservano la formattazione. Esporta una stanza e reimportala: la descrizione avanzata torna esattamente com’era stata scritta.

Segnaposto e disegnoPosizionare segnaposto, icone, foto, date e forme disegnate.