Condividi tramite


TextOptions interface

Opzioni usate per personalizzare il testo in un SymbolLayer

Extends

Proprietà

allowOverlap

Specifica se il testo sarà visibile se si scontra con altri simboli. Se true, il testo sarà visibile anche se si sbatte con altri simboli disegnati in precedenza. Impostazione predefinita false.

anchor

Specifica quale parte dell'icona viene posizionata più vicina alla posizione di ancoraggio delle icone sulla mappa.

'"center"': il centro dell'icona è posizionato più vicino all'ancoraggio.

'"left": il lato sinistro dell'icona è posizionato più vicino all'ancoraggio.

'"right": il lato destro dell'icona è posizionato più vicino all'ancoraggio.

'"top"': la parte superiore dell'icona è posizionata più vicina all'ancoraggio.

'"bottom"': la parte inferiore dell'icona è posizionata più vicina all'ancoraggio.

'"top-left": l'angolo superiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in alto a destra": l'angolo superiore destro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a sinistra": l'angolo inferiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a destra": l'angolo in basso a destra dell'icona viene posizionato più vicino all'ancoraggio.

Impostazione predefinita '"center"'.
color

Colore del testo. Impostazione predefinita "#000000".

font

Stack di caratteri da usare per la visualizzazione del testo. Valori possibili: "SegoeFrutigerHelveticaMYingHei-Bold""StandardFont-Regular""SegoeFrutigerHelveticaMYingHei-Regular""SegoeFrutigerHelveticaMYingHei-Medium""SegoeUi-Bold""SegoeUi-Light""StandardCondensedSegoeUi-Bold""StandardCondensedSegoeUi-Black""StandardCondensedSegoeUi-Light""SegoeUi-SymbolRegular""StandardCondensedSegoeUi-Regular""SegoeUi-SemiLight""StandardFont-Black""StandardFont-Bold""SegoeUi-SemiBold""SegoeUi-Regular""StandardFontCondensed-Black""StandardFontCondensed-Bold""StandardFont-Light""StandardFontCondensed-Light", . "StandardFontCondensed-Regular" Impostazione predefinita ["StandardFont-Regular"].

haloBlur

Distanza di fadeout dell'halo verso l'esterno in pixel. Deve essere un numero maggiore o uguale a 0. Impostazione predefinita 0.

haloColor

Colore dell'halo del testo, che lo aiuta a distinguersi dagli sfondi. Impostazione predefinita "rgba(0,0,0,0)".

haloWidth

Distanza dell'halo alla struttura del tipo di carattere in pixel. Deve essere un numero maggiore o uguale a 0. La larghezza massima del testo halo è 1/4 della dimensione del carattere. Impostazione predefinita 0.

ignorePlacement

Specifica se gli altri simboli sono autorizzati a collidere con il testo. Se true, altri simboli possono essere visibili anche se sono in confronto con il testo. Impostazione predefinita false.

justify

Opzioni di giustificazione del testo.

'"auto": il testo è allineato verso la posizione di ancoraggio.

'"left": il testo è allineato a sinistra.

'"center"': il testo è centrato.

'"right"': il testo è allineato a destra. Impostazione predefinita '"center"'.

offset

Specifica una distanza di offset dell'icona dall'ancoraggio in ems. I valori positivi indicano destra e giù, mentre i valori negativi indicano sinistra e verso l'alto. Impostazione predefinita [0, 0].

opacity

Numero compreso tra 0 e 1 che indica l'opacità in corrispondenza della quale verrà disegnato il testo. Impostazione predefinita 1.

optional

Specifica se il testo può essere nascosto se viene sovrapposto da un altro simbolo. Se true, le icone verranno visualizzate senza il testo corrispondente quando il testo collige con altri simboli e l'icona non viene visualizzata. Impostazione predefinita false.

padding

Dimensioni dell'area aggiuntiva intorno al rettangolo di selezione del testo usato per rilevare le collisioni dei simboli. Impostazione predefinita 2.

pitchAlignment

Specifica l'orientamento del testo quando viene inserita la mappa.

'"auto": corrisponde automaticamente al valore di 'rotationAlignment'.

'"map"': il testo è allineato al piano della mappa.

'"viewport"': il testo è allineato al piano del viewport.

Impostazione predefinita: '"auto"'
radialOffset

Offset radiale del testo, nella direzione dell'ancoraggio del simbolo. Utile in combinazione con variableAnchor, che per impostazione predefinita usa il valore bidimensionale offset se presente. Valore predefinito: 0

rotation

Importo per ruotare il testo in senso orario in gradi. Predefinito 0

rotationAlignment

In combinazione con la proprietà di SymbolLayerOptions, specifica il placement comportamento di rotazione dei singoli glifi che formano il testo.

'"auto": quando il 'posizionamento' è impostato su '"point"', questo equivale a '"map"'. Quando il 'posizionamento' è impostato su '"line"' equivale a ""map"'.

'"map"': quando il 'posizionamento' è impostato su '"point"', allinea il testo a est-ovest. Quando il 'posizionamento' è impostato su '"line"', allinea gli assi x di testo alla riga.

'"viewport":Produce glifi i cui assi x sono allineati all'asse x del riquadro di visualizzazione, indipendentemente dal valore di 'posizionamento'.

Impostazione predefinita: '"auto"'
size

Dimensioni del carattere in pixel. Deve essere un numero maggiore o uguale a 0. Impostazione predefinita 16.

textField

Specifica il nome di una proprietà nelle funzionalità da usare per un'etichetta di testo.

variableAnchor

Elenco di posizioni di ancoraggio potenziali, per aumentare la possibilità di inserire etichette con priorità elevata sulla mappa. Il renderer tenterà di posizionare l'etichetta in ogni posizione, in ordine, prima di passare all'etichetta successiva. Usare justify: "auto" per scegliere la giustificazione del testo in base alla posizione di ancoraggio. Per applicare un offset, usare le radialOffset opzioni o bidimensionali offset .

'"center"': il centro dell'icona è posizionato più vicino all'ancoraggio.

'"left": il lato sinistro dell'icona è posizionato più vicino all'ancoraggio.

'"right": il lato destro dell'icona è posizionato più vicino all'ancoraggio.

'"top"': la parte superiore dell'icona è posizionata più vicina all'ancoraggio.

'"bottom"': la parte inferiore dell'icona è posizionata più vicina all'ancoraggio.

'"top-left": l'angolo superiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in alto a destra": l'angolo superiore destro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a sinistra": l'angolo inferiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a destra": l'angolo in basso a destra dell'icona viene posizionato più vicino all'ancoraggio.

Impostazione predefinita: 'undefined'

Dettagli proprietà

allowOverlap

Specifica se il testo sarà visibile se si scontra con altri simboli. Se true, il testo sarà visibile anche se si sbatte con altri simboli disegnati in precedenza. Impostazione predefinita false.

allowOverlap?: boolean

Valore della proprietà

boolean

anchor

Specifica quale parte dell'icona viene posizionata più vicina alla posizione di ancoraggio delle icone sulla mappa.

'"center"': il centro dell'icona è posizionato più vicino all'ancoraggio.

'"left": il lato sinistro dell'icona è posizionato più vicino all'ancoraggio.

'"right": il lato destro dell'icona è posizionato più vicino all'ancoraggio.

'"top"': la parte superiore dell'icona è posizionata più vicina all'ancoraggio.

'"bottom"': la parte inferiore dell'icona è posizionata più vicina all'ancoraggio.

'"top-left": l'angolo superiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in alto a destra": l'angolo superiore destro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a sinistra": l'angolo inferiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a destra": l'angolo in basso a destra dell'icona viene posizionato più vicino all'ancoraggio.

Impostazione predefinita '"center"'.
anchor?: PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

Valore della proprietà

PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

color

Colore del testo. Impostazione predefinita "#000000".

color?: string | DataDrivenPropertyValueSpecification<string>

Valore della proprietà

string | DataDrivenPropertyValueSpecification<string>

font

Stack di caratteri da usare per la visualizzazione del testo. Valori possibili: "SegoeFrutigerHelveticaMYingHei-Bold""StandardFont-Regular""SegoeFrutigerHelveticaMYingHei-Regular""SegoeFrutigerHelveticaMYingHei-Medium""SegoeUi-Bold""SegoeUi-Light""StandardCondensedSegoeUi-Bold""StandardCondensedSegoeUi-Black""StandardCondensedSegoeUi-Light""SegoeUi-SymbolRegular""StandardCondensedSegoeUi-Regular""SegoeUi-SemiLight""StandardFont-Black""StandardFont-Bold""SegoeUi-SemiBold""SegoeUi-Regular""StandardFontCondensed-Black""StandardFontCondensed-Bold""StandardFont-Light""StandardFontCondensed-Light", . "StandardFontCondensed-Regular" Impostazione predefinita ["StandardFont-Regular"].

font?: string[] | DataDrivenPropertyValueSpecification<string[]>

Valore della proprietà

string[] | DataDrivenPropertyValueSpecification<string[]>

haloBlur

Distanza di fadeout dell'halo verso l'esterno in pixel. Deve essere un numero maggiore o uguale a 0. Impostazione predefinita 0.

haloBlur?: number | DataDrivenPropertyValueSpecification<number>

Valore della proprietà

number | DataDrivenPropertyValueSpecification<number>

haloColor

Colore dell'halo del testo, che lo aiuta a distinguersi dagli sfondi. Impostazione predefinita "rgba(0,0,0,0)".

haloColor?: string | DataDrivenPropertyValueSpecification<string>

Valore della proprietà

string | DataDrivenPropertyValueSpecification<string>

haloWidth

Distanza dell'halo alla struttura del tipo di carattere in pixel. Deve essere un numero maggiore o uguale a 0. La larghezza massima del testo halo è 1/4 della dimensione del carattere. Impostazione predefinita 0.

haloWidth?: number | DataDrivenPropertyValueSpecification<number>

Valore della proprietà

number | DataDrivenPropertyValueSpecification<number>

ignorePlacement

Specifica se gli altri simboli sono autorizzati a collidere con il testo. Se true, altri simboli possono essere visibili anche se sono in confronto con il testo. Impostazione predefinita false.

ignorePlacement?: boolean

Valore della proprietà

boolean

justify

Opzioni di giustificazione del testo.

'"auto": il testo è allineato verso la posizione di ancoraggio.

'"left": il testo è allineato a sinistra.

'"center"': il testo è centrato.

'"right"': il testo è allineato a destra. Impostazione predefinita '"center"'.

justify?: "auto" | "left" | "center" | "right"

Valore della proprietà

"auto" | "left" | "center" | "right"

offset

Specifica una distanza di offset dell'icona dall'ancoraggio in ems. I valori positivi indicano destra e giù, mentre i valori negativi indicano sinistra e verso l'alto. Impostazione predefinita [0, 0].

offset?: Pixel | DataDrivenPropertyValueSpecification<Pixel>

Valore della proprietà

Pixel | DataDrivenPropertyValueSpecification<Pixel>

opacity

Numero compreso tra 0 e 1 che indica l'opacità in corrispondenza della quale verrà disegnato il testo. Impostazione predefinita 1.

opacity?: number | DataDrivenPropertyValueSpecification<number>

Valore della proprietà

number | DataDrivenPropertyValueSpecification<number>

optional

Specifica se il testo può essere nascosto se viene sovrapposto da un altro simbolo. Se true, le icone verranno visualizzate senza il testo corrispondente quando il testo collige con altri simboli e l'icona non viene visualizzata. Impostazione predefinita false.

optional?: boolean

Valore della proprietà

boolean

padding

Dimensioni dell'area aggiuntiva intorno al rettangolo di selezione del testo usato per rilevare le collisioni dei simboli. Impostazione predefinita 2.

padding?: number | PropertyValueSpecification<number>

Valore della proprietà

number | PropertyValueSpecification<number>

pitchAlignment

Specifica l'orientamento del testo quando viene inserita la mappa.

'"auto": corrisponde automaticamente al valore di 'rotationAlignment'.

'"map"': il testo è allineato al piano della mappa.

'"viewport"': il testo è allineato al piano del viewport.

Impostazione predefinita: '"auto"'
pitchAlignment?: "auto" | "map" | "viewport"

Valore della proprietà

"auto" | "map" | "viewport"

radialOffset

Offset radiale del testo, nella direzione dell'ancoraggio del simbolo. Utile in combinazione con variableAnchor, che per impostazione predefinita usa il valore bidimensionale offset se presente. Valore predefinito: 0

radialOffset?: number | DataDrivenPropertyValueSpecification<number>

Valore della proprietà

number | DataDrivenPropertyValueSpecification<number>

rotation

Importo per ruotare il testo in senso orario in gradi. Predefinito 0

rotation?: number | DataDrivenPropertyValueSpecification<number>

Valore della proprietà

number | DataDrivenPropertyValueSpecification<number>

rotationAlignment

In combinazione con la proprietà di SymbolLayerOptions, specifica il placement comportamento di rotazione dei singoli glifi che formano il testo.

'"auto": quando il 'posizionamento' è impostato su '"point"', questo equivale a '"map"'. Quando il 'posizionamento' è impostato su '"line"' equivale a ""map"'.

'"map"': quando il 'posizionamento' è impostato su '"point"', allinea il testo a est-ovest. Quando il 'posizionamento' è impostato su '"line"', allinea gli assi x di testo alla riga.

'"viewport":Produce glifi i cui assi x sono allineati all'asse x del riquadro di visualizzazione, indipendentemente dal valore di 'posizionamento'.

Impostazione predefinita: '"auto"'
rotationAlignment?: "auto" | "map" | "viewport"

Valore della proprietà

"auto" | "map" | "viewport"

size

Dimensioni del carattere in pixel. Deve essere un numero maggiore o uguale a 0. Impostazione predefinita 16.

size?: number | DataDrivenPropertyValueSpecification<number>

Valore della proprietà

number | DataDrivenPropertyValueSpecification<number>

textField

Specifica il nome di una proprietà nelle funzionalità da usare per un'etichetta di testo.

textField?: string | DataDrivenPropertyValueSpecification<string>

Valore della proprietà

string | DataDrivenPropertyValueSpecification<string>

variableAnchor

Elenco di posizioni di ancoraggio potenziali, per aumentare la possibilità di inserire etichette con priorità elevata sulla mappa. Il renderer tenterà di posizionare l'etichetta in ogni posizione, in ordine, prima di passare all'etichetta successiva. Usare justify: "auto" per scegliere la giustificazione del testo in base alla posizione di ancoraggio. Per applicare un offset, usare le radialOffset opzioni o bidimensionali offset .

'"center"': il centro dell'icona è posizionato più vicino all'ancoraggio.

'"left": il lato sinistro dell'icona è posizionato più vicino all'ancoraggio.

'"right": il lato destro dell'icona è posizionato più vicino all'ancoraggio.

'"top"': la parte superiore dell'icona è posizionata più vicina all'ancoraggio.

'"bottom"': la parte inferiore dell'icona è posizionata più vicina all'ancoraggio.

'"top-left": l'angolo superiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in alto a destra": l'angolo superiore destro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a sinistra": l'angolo inferiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.

'"in basso a destra": l'angolo in basso a destra dell'icona viene posizionato più vicino all'ancoraggio.

Impostazione predefinita: 'undefined'
variableAnchor?: PositionAnchor[]

Valore della proprietà