TextOptions interface

Riferimento

Pacchetto:: azure-maps-control

Opzioni usate per personalizzare il testo in un SymbolLayer

Extends: Options

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 .