Widget Area di testo
Il widget Area di testo consente all'utente di immettere un testo su più righe in un mashup.
 |
Il widget Area di testo è disponibile come widget standard in ThingWorx Platform e come componente Web che può essere importato da un SDK.
|
Dimensionamento di default dei widget
La dimensione del widget Area di testo cambia in base alla versione di ThingWorx:
• In ThingWorx 9.3.2 e versioni successive il widget è dinamico per default. Quando viene aggiunto a un contenitore vuoto, si espande per riempire tutto lo spazio disponibile nel contenitore.
• Nelle versioni precedenti di ThingWorx il widget presenta una larghezza e un'altezza di default che è possibile regolare manualmente utilizzando le proprietà.
Quando si esegue la migrazione a ThingWorx 9.3.2 o versioni successive, i widget Area di testo visualizzati come un unico widget all'interno di un contenitore riempiono tutto lo spazio disponibile nel contenitore. Questa modifica può influire sul layout del mashup. Per aggiornare il layout, assicurarsi di regolare il layout del mashup. Per ulteriori informazioni, vedere le sezioni riportate di seguito.
Dimensionamento dei widget in ThingWorx 9.3.1 e versioni precedenti
Per default, l'area di testo viene visualizzata utilizzando le dimensioni di default di larghezza e altezza. La larghezza è impostata su un valore fisso. L'altezza, invece, è impostata su Autosize per permettere al widget di espandersi in senso verticale. Mentre si digita, se il testo supera lo spazio disponibile, il widget aumenta di dimensioni per visualizzare caratteri aggiuntivi, fino a quando non viene raggiunto il valore definito nella proprietà MaxNumberOfCharacters. È possibile aggiungere ulteriori widget e controllare il layout utilizzando le opzioni di allineamento e distribuzione nel pannello Layout. La figura seguente mostra il widget in un layout di mashup:
Il layout è suddiviso come segue:
1. Un contenitore dinamico che include quattro widget: un'etichetta, due campi di testo e un'area di testo.
2. Un contenitore fisso con due pulsanti.
La larghezza del widget è impostata su un valore fisso. L'altezza è invece impostata su Autosize per consentire al widget di espandersi in verticale quando il numero di caratteri è maggiore dello spazio disponibile. È possibile utilizzare le proprietà Width e Height per regolare la dimensione del widget. Vengono visualizzati i puntini di sospensione.
Dimensionamento dei widget in ThingWorx 9.3.2 e versioni successive
Quando si aggiunge il widget a un mashup nuovo o esistente, le relative dimensioni di default vengono impostate in base alla dimensione del contenitore. Il widget si espande automaticamente in modo da riempire lo spazio disponibile all'interno del contenitore. Per regolare le dimensioni del widget rispetto al layout, è necessario configurare il layout del contenitore utilizzando il pannello Layout. Quando il widget è espanso nel contenitore, le proprietà Width e Height non vengono elencate nel pannello Proprietà. L'aggiunta di ulteriori widget al contenitore Area di testo ripristina il dimensionamento precedente. La figura seguente mostra il widget in un contenitore dinamico nella versione 9.3.2 o successiva della piattaforma di ThingWorx:
Il layout è suddiviso come segue:
1. Un contenitore statico con un'altezza fissa contenente tre widget: un widget Etichetta e due widget Campo di testo. La direzione degli elementi è impostata su Verticale.
2. Un contenitore dinamico con un widget Area di testo.
3. Un contenitore statico che visualizza due pulsanti.
L'utilizzo di un contenitore separato per visualizzare il widget consente di creare layout più dinamici. L'immagine seguente mostra il modulo precedente quando è disponibile più spazio per il mashup. L'area di testo si espande con il relativo contenitore, mentre la dimensione dei campi di testo rimane inalterata.
Proprietà del widget
Le proprietà del widget Area di testo sono elencate di seguito.
Nome proprietà | Descrizione | Tipo di base | Valore di default | Associabile? (Y/N) | Localizzabile? (Y/N) |
|---|---|---|---|---|---|
Text | Testo visualizzato nell'area di testo. | STRING | n/d | Y | Y |
Label | Testo visualizzato come etichetta per l'area di testo. | STRING | n/d | Y | Y |
Counter | Conta e visualizza il numero di caratteri immessi nell'area di testo. | BOOLEAN | False | N | N |
MaxNumberOfCharacters | Consente di impostare un numero massimo di caratteri consentiti nell'area di testo. | NUMBER | 100 | Y | N |
HintText | Visualizza il testo segnaposto che spiega cosa inserire nel campo. | STRING | n/d | N | Y |
Disabled | Utilizzare questa proprietà per disattivare il widget nel mashup. Il widget viene visualizzato nel mashup, ma non è possibile farvi clic. | BOOLEAN | False | Y | N |
ReadOnly | Consente di impostare l'area di testo su sola lettura e impedisce all'utente di modificare il testo in essa contenuto. | BOOLEAN | False | N | N |
TextAlignment | Consente di allineare il testo a sinistra o a destra. | STRING | A sinistra | N | N |
LabelAlignment | Consente di allineare l'etichetta a sinistra, a destra o al centro. | STRING | A sinistra | N | N |
TabSequence | Sequenza in cui i widget vengono evidenziati quando l'utente preme il tasto TAB. | NUMBER | n/d | N | N |
CustomClass | Consente di definire la classe CSS per il div. superiore del widget. È possibile inserire più classi, separate da uno spazio. | STRING | n/d | Y | N |
Changed | Evento che viene attivato quando i dati vengono modificati. | n/d | n/d | Y | N |
ResetToDefaultValue | Ripristina i valori di default degli input di questo widget. | n/d | n/d | Y | N |
Width | Larghezza del widget. In ThingWorx 9.3.2 o versioni successive questa proprietà è nascosta, a meno che non si aggiunga il widget a un contenitore con uno o più widget. | NUMBER | 273 | N | N |
Height | Altezza del widget. Viene calcolato automaticamente per default. Immettere un valore nel pannello delle proprietà o ridimensionare il widget nell'area di lavoro per impostare un'altezza fissa. In ThingWorx 9.3.2 o versioni successive questa proprietà è nascosta, a meno che non si aggiunga il widget a un contenitore con uno o più widget. | NUMBER | Ridimensionamento automatico | N | N |
MinWidth | Imposta la larghezza minima del widget quando viene aggiunto a un contenitore dinamico in ThingWorx 9.3.2 o versioni successive. | NUMBER | n/d | N | N |
TextChanged | Evento associabile attivato quando si fa clic su un'area esterna al widget dopo avere aggiornato il valore del widget. | n/d | n/d | Y | N |
TooltipField | Imposta il testo di una descrizione comando che viene visualizzata quando si posiziona il puntatore del mouse sul widget. | STRING | n/d | Y | Y |
TooltipIcon | Imposta l'immagine di un'icona per la descrizione comando del widget. È possibile aggiungere un'immagine o specificare un percorso URL dell'immagine. | MEDIA ENTITY | n/d | N | N |
Convalida dei dati dei widget
Oltre alle proprietà di convalida comuni, è possibile utilizzare le proprietà MaxLength e MinLength per convalidare il numero di caratteri nel widget Area di testo.
È possibile personalizzare i messaggi di errore di default utilizzando le proprietà MaxLengthFailureMessage e MinLengthFailureMessage. I valori massimo e minimo vengono visualizzati all'interno dei messaggi utilizzando il parametro ${value}.
Per ulteriori informazioni sull'utilizzo delle proprietà di convalida comuni, vedere Applicazione della convalida ai widget.
Nella tabella che segue sono elencate le proprietà disponibili nel pannello Convalida.
Proprietà | Descrizione | Tipo di base | Valore di default | Associabile (Y/N) | Localizzabile? (Y/N) |
|---|---|---|---|---|---|
CriteriaMessage | Messaggio da visualizzare per i criteri di convalida e in caso di errore. | STRING | n/d | Y | Y |
CriteriaMessageDetails | Dettagli da visualizzare per i criteri di convalida e per il messaggio di errore. | STRING | n/d | Y | Y |
MaxLength | Lunghezza massima per il valore dell'area di testo. | STRING | n/d | Y | N |
MaxLengthFailureMessage | Messaggio da visualizzare quando il valore corrente supera la lunghezza massima di caratteri. | STRING | ${value} characters is the maximum | Y | Y |
MinLength | Lunghezza minima per il valore dell'area di testo. | STRING | n/d | Y | N |
MinLengthFailureMessage | Messaggio da visualizzare quando il valore corrente è inferiore alla lunghezza minima di caratteri. | STRING | ${value} characters is the minimum | Y | Y |
RequiredMessage | Messaggio da visualizzare quando il valore richiesto è impostato su true e l'elemento non è selezionato. | STRING | È richiesto un valore | Y | Y |
ShowValidationCriteria | Visualizza un messaggio di suggerimento sull'input richiesto durante la modifica dell'area di testo. | BOOLEAN | False | Y | N |
ShowValidationFailure | Visualizza un messaggio di errore quando il valore immesso non supera la convalida. | BOOLEAN | False | Y | N |
ShowValidationState | Servizio associabile che consente di visualizzare lo stato di convalida prima che un utente interagisca con il widget in fase di esecuzione. Per default, lo stato di convalida viene visualizzato solo dopo l'interazione dell'utente. | Servizio | n/d | In | N |
ShowValidationSuccess | Visualizza un messaggio di esito positivo quando il valore immesso viene convalidato. | BOOLEAN | False | Y | N |
SuccessMessage | Messaggio da visualizzare quando la convalida ha esito positivo. | STRING | n/d | Y | Y |
SuccessMessageDetails | Messaggio secondario che visualizza altre informazioni sul messaggio di esito positivo della convalida. | STRING | n/d | Y | Y |
Validate | Evento associabile che viene attivato quando il valore del widget viene modificato. Associare questo evento a un servizio o a una funzione per applicare uno schema o un'espressione di convalida. | evento | n/d | Y | N |
ValidationCriteriaIcon | Selezionare un'icona SVG da visualizzare all'interno del messaggio di suggerimento per i criteri di convalida. | IMAGELINK | info | N | N |
ValidationFailureIcon | Imposta l'icona SVG da visualizzare all'interno del messaggio di stato quando l'esito della convalida è negativo. | IMAGELINK | error | N | N |
ValidationOutput | Recupera l'output della convalida del widget. I valori restituiti sono Undefined, Unvalidated , Valid o Invalid. | STRING | n/d | Y | N |
ValidationState | Proprietà associabile che imposta lo stato di convalida. È possibile impostare questa proprietà su Undefined, Unvalidated, Valid, Invalid. | STRING | Undefined | Y | N |
ValidationSuccessIcon | Selezionare un'icona SVG da visualizzare all'interno del messaggio di stato quando l'esito della convalida è positivo. | IMAGELINK | success | N | N |
ValueRequired | È necessario selezionare un elemento dell'elenco. | BOOLEAN | False | Y | N |