widget IFrame

Il widget IFrame è un widget speciale che può essere utilizzato per integrare un'applicazione differente. Questo widget crea un iframe HTML.

Il widget IFrame supporta i seguenti attributi:

frameId - Stringa. L'identificativo dell'iframe.
frameSrc - Stringa. L'attributo src per iframe che corrisponde all' URL della pagina da caricare.
Nota: alcuni siti web, ad esempio google o yahoo, impediscono a se stessi di essere integrati in un iFrame contenuto in un'applicazione diversa. Pertanto, assicurarsi che i siti Web necessari non impongano tali limitazioni.
applyCSRF - Booleano. Indica se il token CSRF deve far parte dell' URL per iframe. Il valore predefinito è true.
qryParamsList - Array. Contiene un array di parametri di query che deve far parte di URL per iframe. Ogni parametro di interrogazione è un oggetto JSON e contiene i seguenti attributi:
- name - Stringa. Il nome del parametro.
- value - Stringa. Il valore del parametro.
frameClass - Stringa. Utilizzare la classe CSS per lo stile iframe. Il valore predefinito è scIFrame.
frameScrolling - Stringa. Imposta l'attributo di scorrimento per iframe. Per abilitare lo scorrimento in iframe, impostare il valore di questo attributo su yes. Per impostazione predefinita, il valore è impostato su no. È disponibile anche il valore auto .
frameborder - Numero. Specifica se visualizzare un bordo per iframe. I valori validi sono 0 e 1. Il valore predefinito è 0.

È possibile aggiungere un widget IFrame nella propria applicazione in uno dei seguenti metodi:

Dichiarativo - Crea un elemento HTML nel file <Screen>.html come fornito nel seguente codice di esempio.

<div data-dojo-type="sc/plat/dojo/widgets/IFrame" data-dojo-props=" uId: 'customiframe', frameId: 'sampleId', frameSrc: '<provide your application URL here>',
 applyCSRF:true,frameScrolling: 'yes' ">
</div>

In modo programmatico - Utilizzare il programma di utilità sc.plat.dojo.utils.WidgetUtils.createIframeWidget JavaScript . Per ulteriori informazioni sul metodo del widget createIframeWidget , consultare la documentazione JavaScript .
- Argomenti
  - Screen - L'istanza dello schermo in cui il widget deve essere creato.
  - uId - uId del nuovo widget da creare. Se passi come null, viene restituito uId generato automaticamente.
  - configObj - L'oggetto JSON che contiene tutti gli attributi come frameId, frameSrc, applyCSRFe altri richiesti per creare un IFrame. Il seguente codice spiega la struttura dell'oggetto JSON:
```
var iframeUId = _scWidgetUtils.createIframeWidget(this, null, {"IFrame": {frameId: 'pqr',frameSrc: 
'<provide your application URL here>', applyCSRF: true, frameScrolling: 'yes' }	});
```
  - Valore di ritorno - Viene restituito l' uId del widget appena creato, che è uguale a widgetUId.
Per inserire il widget creato sullo schermo, utilizzare il metodo widget placeAt fornito da Dojo.

Aggiorna l'applicazione caricata nel widget IFrame

Utilizzare il widget IFrame creato per caricare un'applicazione separata o ricaricare un'applicazione esistente con parametri differenti utilizzando il programma di utilità sc.plat.dojo.utils.WidgetUtils.setIFrameSrc JavaScript .

Argomenti:

screenInstance - L'istanza della schermata in cui è presente il widget IFrame.
iframeUId - uId del widget IFrame.
src - L' URL dell'applicazione da caricare.
qryParamsList - Facoltativo. Contiene un array di parametri di interrogazione che devono far parte di URL per iframe. Ogni parametro di interrogazione è un oggetto JSON e contiene i seguenti attributi:
- name - Stringa. Il nome del parametro.
- value - Stringa. Il valore del parametro.