Elements a utilitzar en la descripció XML del connector

Les propietats dels elements s'enumeren en una secció separada.

Elements generals

<document>

Cal que sigui present en cada fitxer «description.xml» com a node arrel. No hi ha cap funció especial. Sense atributs

<about>

Informació sobre aquest connector (autor, llicència, etc.). Aquest element està permès tant en el fitxer .xml d'un connector individual com en els fitxers .pluginmap. Consulteu la referència del fitxer .pluginmap per als detalls de referència, el capítol sobre la informació «about» per a una introducció.

<code>

Defineix on cercar la plantilla JS al connector. Utilitzeu-ho només una vegada per fitxer, com a fill directe de l'etiqueta del document. Atributs:

file

Nom de fitxer de la plantilla JS, relatiu al directori on està l'«xml» del connector

<help>

Defineix on cercar el fitxer d'ajuda del connector. Utilitzeu-ho només una vegada per fitxer, com a fill directe de l'etiqueta del document. Atributs:

file

Nom de fitxer del fitxer d'ajuda, relatiu al directori on està l'«xml» del connector

<copy>

Es pot utilitzar com a fill (directe o indirecte) dels elements principals de la disposició, és a dir, <dialog> i <wizard>. Això s'utilitza per a copiar 1:1 tot un bloc a elements XML. Atributs:

id

L'ID a cercar. L'etiqueta <copy> cercarà un element XML anterior que tingui el mateix ID, i el copiarà incloent-hi tots els elements descendents.

copy_element_tag_name

En alguns casos, voldreu una còpia gairebé literal, però canvieu el nom d'etiqueta de l'element a copiar. L'exemple més important d'això és quan voleu copiar tot un <tab> des d'una interfície de diàleg a <page> d'una interfície assistent. En aquest cas, establiu copy_element_tag_name="page" per a fer aquesta conversió automàticament.

Definicions d'interfície

<dialog>

Defineix una interfície de tipus diàleg. Col·loca la definició de la IGU dins d'aquesta etiqueta. Utilitzeu només una vegada per fitxer, com a fill directe de l'etiqueta document. Es requereix almenys una de les etiquetes «dialog» o «wizard» per a un connector. Atributs:

label

Llegenda per al diàleg

recommended

S'ha d'utilitzar el diàleg com a interfície «recomanada» (és a dir, la interfície que es mostrarà de manera predeterminada, llevat que l'usuari hagi configurat el RKWard a una interfície específica com a predeterminada)? Aquest atribut actualment no té cap efecte, ja que és implícitament «true», llevat que es recomani l'assistent.

<wizard>

Defineix una interfície de tipus assistent. Col·loca la definició de la IGU dins d'aquesta etiqueta. Utilitzeu només una vegada per fitxer, com a fill directe de l'etiqueta del document. Es requereix almenys una de les etiquetes «dialog» o «wizard» per a un connector. Accepta només etiquetes <page> o <embed> com a fills directes. Atributs:

label

Llegenda per a l'assistent

recommended

S'ha d'utilitzar l'assistent com a interfície «recomanada» (és a dir, la interfície que es mostrarà de manera predeterminada, llevat que l'usuari hagi configurat el RKWard a una interfície específica com a predeterminada)? Opcional, el valor predeterminat és «false».

Elements de disposició

Tots els elements d'aquesta secció accepten un atribut id="identifierstring". Aquest atribut és opcional per a tots els elements. Es pot utilitzar, per exemple, per a ocultar/inhabilitar tot l'element de la disposició i tots els elements continguts en ell (vegeu el capítol de la lògica de la IGU). La cadena «id» no pot contenir «.» (punt) ni «;» (punt i coma), i generalment s'ha de limitar a caràcters alfanumèrics i el guió baix («_»). Només es llisten els atributs addicionals.

<page>

Defineix una pàgina nova dins d'un assistent. Només es permet com a fill directe d'un element <wizard>.

<row>

Tots els fills directes d'una etiqueta «row» es col·locaran d'esquerra a dreta.

<column>

Tots els fills directes d'una etiqueta «column» es col·locaran de dalt a baix.

<stretch>

De manera predeterminada, els elements de la IGU ocupen tot l'espai disponible. Per exemple, si teniu dues columnes una al costat de l'altra, l'esquerra està empaquetada amb elements, però la dreta només conté un sol <radio>, el control <radio> s'expandirà verticalment, tot i que realment no necessita l'espai disponible, i es veurà lleig. En aquest cas, realment voleu afegir un «blank» a sota del <radio>. Per a això, utilitzeu l'element <stretch>. Simplement utilitzarà una mica d'espai. No utilitzeu en excés aquest element, normalment és una bona idea que els elements de la IGU obtinguin tot l'espai disponible, només de vegades la disposició es veurà espaiada. L'element <stretch> no pren cap argument, ni tan sols una «id». Tampoc podeu posar un fill dins de l'element <stretch> (en altres paraules, només l'utilitzareu com a «<stretch/>»)

<frame>

Dibuixa un marc/quadre al voltant dels seus fills directes. Es pot utilitzar per a agrupar visualment les opcions relacionades. La disposició dins d'un marc és de dalt a baix, llevat que col·loqueu una <row> a dins. Atributs:

label

Llegenda per al marc (opcional)

checkable

Els marcs es poden marcar. En aquest cas, tots els elements continguts s'inhabilitaran quan el marc no estigui marcat i s'habilitaran quan estigui marcat. (Opcional, de manera predeterminada és "false")

checked

Només per als marcs que es poden marcar: s'ha de marcar el marc de manera predeterminada? El valor predeterminat és «true». No s'interpreta per a marcs que no es poden marcar.

<tabbook>

Organitza elements en un «tabbook». Accepta només etiquetes <tab> com a fills directes.

<tab>

Defineix una pàgina en un «tabbook». Col·loca la definició de la IGU per a la pestanya dins d'aquesta etiqueta. Només es pot utilitzar com a fill directe d'una etiqueta <tabbook>. Un <tabbook> hauria de tenir almenys dues pestanyes definides. Atributs:

label

Llegenda per a la pàgina de pestanya (requerit)

<text>

Mostra el text envoltat per aquesta etiqueta a la IGU. S'admeten alguns marcadors senzills d'estil HTML (en particular <b>, <i>, <p>, i <br/>). No obstant això, mantingueu el format al mínim. Inserir una línia completament buida afegeix un salt de línia dur. Atributs:

type

Tipus del text. Un de "normal", "avís" o "error". Això influeix en l'aspecte del text (opcional, el predeterminat és "normal")

Elements actius

Tots els elements d'aquesta secció accepten l'atribut id="identifierstring". Aquest atribut és obligatori per a tots els elements. Només es llisten els atributs addicionals. La cadena d'identificació no pot contenir "." (punts).

<varselector>

Proporciona una llista d'objectes disponibles des dels quals l'usuari pot seleccionar-ne un o més. Requereix una o més <varslot> com a contrapartida per a ser útil. Atributs:

label

Etiqueta per al «varselector» (opcional, el predeterminat és "Select variable(s)")

<varslot>

S'utilitza conjuntament amb un "varselector" per a permetre que l'usuari seleccioni una o més variables. Atributs:

label

Etiqueta per al «varslot» (recomanada, la predeterminada és «Variable:»)

source

El «varselector» des d'on obtenir la selecció (requerit, llevat que es connecti manualment o usant «source_property»)

source_property

Una propietat arbitrària d'on copiar els valors, quan es fa clic al botó de selecció. Si s'especifica, això anul·la l'atribut «source».

required

Si es requereix que per a enviar el codi aquest «varslot» tingui un valor vàlid. Vegeu la propietat requerida (opcional, predeterminada a "false")

multi

Si el «varslot» només conté un (predeterminat, «fals») o diversos objectes

allow_duplicates

Si el «varslot» només pot acceptar objectes únics (predeterminat, «fals»), o si el mateix objecte es pot afegir diverses vegades.

min_vars

Només té sentit si és multi="true": nombre mínim de variables que s'han de seleccionar perquè la selecció es consideri vàlida (opcional, el valor predeterminat és "1")

min_vars_if_any

Només té sentit si és multi="true": Alguns «varslots» es poden considerar vàlids, si, per exemple, el «varslot» està buit o té almenys dos valors. Això especifica quantes variables s'han de seleccionar si n'hi ha (2 a l'exemple). (Opcional, el valor predeterminat és "1")

max_vars

Només té sentit si és multi="true": nombre màxim de variables a seleccionar (opcional, el valor predeterminat és "0", el qual vol dir sense màxim)

classes

Si especifiqueu un o més noms de classe R (separats per espais (" ")), aquí, el «varslot» només acceptarà objectes pertanyents a aquestes classes (opcional, useu-ho amb molta cura, no s'hauria d'impedir a l'usuari prendre decisions vàlides, i Rmoltes classes diferents)

types

Si especifiqueu un o més tipus de variables (separades per espais («)»), aquí, el «varslot» només acceptarà objectes d'aquests tipus. Els tipus vàlids són "unknown", "number", "string", "factor", "invalid". (Opcional, useu-ho amb molta cura, no s'ha d'impedir a l'usuari que prengui decisions vàlides, i el RKWard no sempre coneix el tipus d'una variable)

num_dimensions

El nombre de dimensions que un objecte necessita tenir. "0" (predeterminat), vol dir que qualsevol nombre de dimensions és acceptable. (Opcional, el valor predeterminat és "0")

min_length

La longitud mínima que un objecte ha de tenir per a ser acceptable. (Opcional, el valor predeterminat és "0")

max_length

La longitud màxima que un objecte ha de tenir per tal de ser acceptable. (Opcional, predeterminat pel nombre enter més gran representable al sistema)

<valueselector>

Proporciona una llista de cadenes disponibles (no objectes R) que se seleccionaran en una o més àrees d'acompanyament <valueslot>. Les opcions de cadena es poden definir utilitzant etiquetes <option> com a fills directes (vegeu més avall), o establir-les utilitzant propietats dinàmiques. Atributs:

label

Etiqueta per al «valueselector» (opcional, predeterminat a sense etiqueta)

<valueslot>

S'utilitza conjuntament amb un <valueselector> per a permetre a l'usuari seleccionar un o més elements de cadena. Aquest element és majoritàriament idèntic a <varslot>, i comparteix els mateixos atributs, excepte els que es refereixen a les propietats dels elements acceptables (és a dir classes, types, num_dimensions, min_length, max_length).

<radio>

Defineix un grup de botons exclusius d'opcions (només es pot seleccionar un alhora). Requereix almenys dues etiquetes <option> com a fills directes. No es permeten altres etiquetes com a filles. Atributs:

label

Etiqueta per al control d'opcions (recomanada, la predeterminada és «Select one:»)

<dropdown>

Defineix un grup d'opcions de les quals es pot seleccionar una i només una alhora, utilitzant una llista desplegable. Això és funcionalment equivalent a un <radio>, però es veu diferent. Requereix almenys dues etiquetes <option> com a filles directes. No es permeten altres etiquetes com a filles. Atributs:

label

Etiqueta per a la llista desplegable (recomanada, la predeterminada és «Select one:»)

<select>

Proporciona una llista de cadenes disponibles des de les quals l'usuari pot seleccionar un nombre arbitrari. Les opcions de cadena es poden definir utilitzant etiquetes <option> com a filles directes (vegeu més avall), o establir-les utilitzant propietats dinàmiques. Atributs:

label

Etiqueta per a <select> (opcional, predeterminat a sense etiqueta)

single

Si s'estableix a cert, només es podrà seleccionar un valor únic, en lloc de diversos valors alhora (booleà, predeterminat a fals)

<option>

Només es pot utilitzar com a fill directe d'un element <radio>, <dropdown>, <valueselector> o <select>. Representa una opció seleccionable en un control d'opcions o llista desplegable. Com que els elements <option> sempre formen part d'un dels elements de selecció, normalment no tenen una "id" pròpia, però vegeu a continuació. Atributs:

label

Etiqueta per a l'opció (requerit)

value

El valor de la cadena que retornarà l'element pare si aquesta opció està marcada/seleccionada (requerit)

checked

Si l'opció s'ha de marcar/seleccionar de manera predeterminada a «true» o «false». En un <radio> o <dropdown>, només es pot establir una opció a checked="true", i si no s'estableix cap opció a «checked», es marcarà/seleccionarà automàticament la primera opció de l'element pare. En un <select>, es pot establir com a «checked» qualsevol nombre d'opcions. (Opcional, predeterminat a "false")

id

És opcional especificar el paràmetre «id» per als elements <option> (i de fet, es recomana no establir un «id», llevat que realment en necessiteu un). No obstant això, especificar un "id" us permetrà habilitar/inhabilitar dinàmicament <option>, connectant-vos a la propietat booleana id_of_radio.id_of_optionX.enabled. Actualment això funciona per a opcions dins d'elements <radio> o <dropdown>, només; actualment les opcions <valueselector> i <select> no admeten els identificadors.

<checkbox>

Defineix una casella de selecció, és a dir, una opció única que es pot activar o desactivar. Atributs:

label

Etiqueta per a la casella de selecció (requerit)

value

El valor que la casella de selecció retornarà si està marcada (requerit)

value_unchecked

El valor que es retornarà si la casella de selecció no està marcada (opcional, el valor predeterminat és "", és a dir, una cadena buida)

checked

Si l'opció s'ha de marcar per defecte "true" o "false" (opcional, predeterminat a "false")

<frame>

L'element del marc s'utilitza generalment com un element de disposició pur, i es llista a la secció sobre elements de disposició. No obstant això, també es pot fer que es pugui marcar, actuant així com una casella de selecció senzilla al mateix temps.

<input>

Defineix un camp d'entrada de text lliure. Atributs:

label

Etiqueta per al camp d'entrada (requerida)

initial

Text inicial del camp de text (opcional, el valor predeterminat és "", és a dir, una cadena buida)

size

Un de "small", "medium", o "large". "large" defineix un camp d'entrada multilínia, "small" i "medium" són camps d'una sola línia (opcional, el predeterminat és "medium")

required

Si es requereix que per a enviar el codi aquesta entrada no estigui buida. Vegeu la propietat requerida (opcional, predeterminat a "false")

<matrix>

Una taula per a introduir dades de matrius (o vectors) a la IGU.

Nota

Aquest element d'entrada no està optimitzat per a introduir/editar grans quantitats de dades. Si bé no hi ha un límit estricte en la mida d'una <matrix>, en general no hauria de superar al voltant de deu files/columnes. Si espereu dades més grans, permeteu als usuaris seleccionar-lo com un objecte R (el qual pot ser una bona idea com a opció alternativa, en gairebé cada instància on utilitzeu un element de matriu).

Atributs:

label

Etiqueta per a la taula (requerida)

mode

Un d'entre "integer", "real", o "string". El tipus de dades que s'acceptaran a la taula (requerit)

min

Valor mínim acceptable (per a matrius de tipus "integer" o "real") (opcional, predeterminat al valor més petit representable)

max

Valor màxim acceptable (per a matrius de tipus "integer" o "real") (opcional, predeterminat al valor més gran representable)

allow_missings

Si es permeten valors (buits) a la matriu. Això està implícit per a matrius o mode «cadena» (opcional, el valor predeterminat és "false").

allow_user_resize_columns

Quan s'estableix a «true» (cert), l'usuari pot afegir columnes escrivint a les cel·les (inactives) més a la dreta (opcional, predeterminat a "true").

allow_user_resize_rows

Quan s'estableix a «true» (cert), l'usuari pot afegir files escrivint a les cel·les (inactives) de la part de baix de tot (opcional, predeterminat a "true").

rows

Nombre de files a la matriu. No té cap efecte per allow_user_resize_rows="true".

Nota

Això també es pot controlar establint la propietat "rows".

(opcional, predeterminat a 2).

columns

Nombre de columnes a la matriu. No té cap efecte per allow_user_resize_columns="true".

Nota

Això també es pot controlar establint la propietat "columns".

(opcional, predeterminat a 2).

min_rows

Nombre mínim de files a la matriu. La matriu refusarà reduir-se per sota d'aquesta mida. (Opcional, el valor predeterminat és 0; vegeu també: allow_missings).

min_columns

Nombre mínim de columnes a la matriu. La matriu refusarà reduir-se per sota d'aquesta mida. (Opcional, el valor predeterminat és 0; vegeu també: allow_missings).

fixed_height

Força l'element de la IGU a romandre a la seva alçada inicial. No l'utilitzeu en combinació amb matrius, on el nombre de files pot canviar de qualsevol manera. Especialment útil quan es crea un element d'entrada vectorial (columns="1"). Amb aquesta opció establerta a «true» (cert), no es mostrarà cap barra de desplaçament horitzontal, fins i tot si la matriu excedeix l'amplada disponible (ja que això afectaria l'alçada). (Opcional, el valor predeterminat és "false").

fixed_width

Nom lleugerament incorrecte: suposa que el comptador de columnes no canviarà. L'última columna (o normalment només) s'estirarà per a agafar l'amplada disponible. No l'utilitzeu en combinació amb matrius, on el nombre de columnes pot canviar de qualsevol manera. Especialment útil quan es crea un element d'entrada vectorial (rows="1"). (Opcional, el valor predeterminat és "false").

horiz_headers

Cadenes a usar per a la capçalera horitzontal, separades per «;». La capçalera s'ocultarà, si s'estableix a "". (Opcional, el valor predeterminat és el número de columna).

vert_headers

Cadenes a usar per a la capçalera vertical, separades per «;». La capçalera s'ocultarà, si s'estableix a "". (Opcional, el valor predeterminat és el número de fila).

<optionset>

Una interfície d'usuari per a repetir un conjunt d'opcions per a un nombre arbitrari d'elements (introducció als «optionsets»). Atributs:

min_rows

Si s'especifica, el conjunt es marcarà com a no vàlid, llevat que tingui almenys aquest nombre de files (opcional, enter).

min_rows_if_any

Com «min_rows», però només es provaran si hi ha almenys una fila (opcional, enter).

max_rows

Si s'especifica, el conjunt es marcarà com a no vàlid, llevat que tingui com a màxim aquest nombre de files (opcional, enter).

keycolumn

L'ID de la columna per a actuar com a «keycolumn». Un «optionset» amb una «keycolumn» (vàlida) actuarà com un «optionset» "driven". Un «optionset» sense «keycolumn» permetrà la inserció/eliminació manual d'elements. La «keycolumn» s'ha de marcar com a externa. (Opcional, de manera predeterminada no hi ha cap «keycolumn»).

Elements fills:

<optioncolumn>

Declara una «optioncolumn» del conjunt. Per a cada valor que voleu obtenir des de l'«optionset», haureu de declarar una <optioncolumn> separada. Atributs:

id

L'identificador de l'«optioncolumn» (requerit, cadena).

external

Establiu-ho a «true» (cert), si l'«optioncolumn» es controla des de fora de l'«optionset» (opcional, booleà, el valor predeterminat és "false").

label

Si s'indica, l'«optioncolumn» es mostrarà en una columna amb aquesta etiqueta (opcional, cadena, de manera predeterminada no es mostrarà).

connect

La propietat a la qual connectar aquesta «optioncolumn», donada com a «id» dins de l'àrea <content>. Per a <optioncolumn> externes, el valor corresponent s'establirà al valor establert externament. Per a les <optioncolumn> normals (no externes), la fila corresponent de la propietat <optioncolumn> s'establirà quan la propietat canviï dins de l'àrea de contingut. (Opcional, cadena, de manera predeterminada no està connectada).

default

Només per a columnes externes: el valor que s'ha d'assumir per a aquesta columna, si no es coneix cap valor per a una entrada. És útil rares vegades. (Opcional, el valor predeterminat és una cadena buida)

<content>

Declara el contingut/IU del conjunt. Sense atributs. Es permeten tots els elements actius, passius i de disposició habituals com a elements de nom fill. A més, en versions anteriors del RKWard (fins a 0,6.3), es va permetre l'element fill especial <optiondisplay>. Això és obsolet en el RKWard 0.6.4, i simplement s'hauria d'eliminar dels connectors existents.

<logic>

Especificació opcional de la lògica de la IU a aplicar dins de la regió de contingut de l'«optionset». Vegeu la referència a <logic>

<browser>

Un element dissenyat per a seleccionar un únic nom de fitxer (o nom de directori). Tingueu en compte que aquest camp prendrà qualsevol cadena, encara que estigui destinada a utilitzar-se només per a fitxers:

label

Etiqueta per al navegador (opcional, el valor predeterminat és "Enter filename")

initial

Text inicial del navegador (opcional, predeterminat a "", és a dir, una cadena buida)

type

Un d'entre "file", "dir", o "savefile". Per a seleccionar un fitxer existent, un directori existent o un fitxer no existent, respectivament (opcional, el valor predeterminat és "file")

allow_urls

Si es poden seleccionar URL (no locals) (opcional, predeterminat a "false")

filter

Filtre del tipus de fitxer, p. ex. ("*.txt *.csv" per als fitxers .txt i .csv). Automàticament s'afegeix una entrada separada per a "All files" (opcional, per defecte a "", és a dir "All files")

required

Si es requereix que per a enviar el codi el camp no estigui buit. Tingueu en compte que això no significa necessàriament que el nom de fitxer seleccionat sigui vàlid. Vegeu la propietat requerida (opcional, predeterminat a "true")

<saveobject>

Un element dissenyat per a seleccionar el nom d'un objecte R a on desar (és a dir, generalment no existeix prèviament, en contrast amb un «varslot»):

label

Etiqueta per a l'entrada (opcional, predeterminada a "Save to:")

initial

Text inicial de l'entrada (opcional, predeterminat a "my.data")

required

Si es requereix que per a enviar el codi el camp tingui un nom d'objecte admès. Vegeu la propietat requerida (opcional, predeterminat a "true")

checkable

En molts casos d'ús, desar a un objecte R és opcional. En aquests casos, es pot integrar una casella de selecció a l'element «saveobject» usant aquest atribut. Quan s'estableix a «true» (cert), la casella de selecció activarà/desactivarà el «saveobject». Vegeu la propietat activa de «saveobject» (opcional, predeterminat a "false")

checked

Per a elements «saveobject» seleccionables, només: si el control està marcat/activat de manera predeterminada (opcional, el valor predeterminat és "false")

<spinbox>

Un «spinbox» en el qual l'usuari pot seleccionar un valor numèric, utilitzant l'entrada directa del teclat o les fletxes amunt/avall petites. Atributs:

label

Etiqueta per al «spinbox» (recomanada, la predeterminada és «Enter value:»)

min

El valor més baix que l'usuari pot introduir en el «spinbox» (opcional, de manera predeterminada el valor més baix que es pot representar tècnicament en el «spinbox»)

max

El valor més gran que l'usuari pot introduir al botó de selecció de valors (opcional, de manera predeterminada el valor més alt que es pot representar tècnicament en el «spinbox»)

initial

El valor inicial que es mostra al botó de selecció de valors (opcional, el valor predeterminat és "0")

type

Un entre "real" o "integer". Si el botó de selecció de valors accepta nombres reals o només enters (opcional, el valor predeterminat és "real")

default_precision

Només té sentit si el «spinbox» és de tipus="real". Especifica el nombre predeterminat de xifres decimals que es mostren al botó de selecció de valors (només es mostraran aquests zeros finals). Quan l'usuari prem les fletxes amunt/avall, aquest lloc decimal es canviarà. Tanmateix, l'usuari pot ser capaç d'introduir valors amb una precisió més alta (vegeu més avall) (opcional, predeterminat a "2")

max_precision

El nombre màxim de dígits que es poden representar significativament (opcional, predeterminat a "8")

<formula>

Aquest element avançat permet a l'usuari seleccionar una fórmula/conjunt d'interaccions a partir de les variables seleccionades. Per exemple, per un GLM, aquest element es pot utilitzar per a permetre a l'usuari especificar els termes d'interacció en el model. Atributs:

fixed_factors

L'ID del «varslot» que conté els factors fixos seleccionats (requerit)

dependent

L'ID del «varslot» que conté la variable dependent seleccionada (requerit)

<embed>

Incrusta un connector diferent en aquest (vegeu el capítol sobre la incrustació). Atributs:

component

El nom registrat del component a incrustar (vegeu el capítol sobre el registre de components) (requerit)

as_button

Si s'estableix a "true", només es col·locarà un botó a la IGU incrustada, la IGU incrustada només es mostrarà (en una finestra separada) quan es premi el botó (opcional, de manera predeterminada és "false")

label

Només té sentit si as_button="true": l'etiqueta del botó (recomanada, la predeterminada és «Options»)

<preview>

Una casella de selecció per a commutar la funcionalitat de vista prèvia. Tingueu en compte que a partir de la versió 0.6.5 del RKWard els elements de vista prèvia <preview> són casos especials en els diàlegs de connectors (no assistents): es col·locaran a la columna de botons, independentment d'on estiguin exactament definits a la interfície d'usuari. Continua sent una bona idea definir-les en un lloc assenyat de la disposició, per a la compatibilitat cap endarrere. Atributs:

label

Etiqueta del quadre (opcional, el valor predeterminat és "Preview")

mode

Tipus de vista prèvia. Els tipus admesos són "plot" (vegeu el capítol sobre les previsualitzacions de gràfics), "output" (vegeu el capítol sobre les previsualitzacions de sortida (HTML), "data" (vegeu les previsualitzacions de dades), i "custom" (vegeu les previsualitzacions personalitzades ). (Opcional, el valor predeterminat és "plot")

placement

Col·locació de la vista prèvia: "attached" (al lloc de treball principal), "detached" (finestra independent), "docked" (adjunt al diàleg del connector) i "default" (actualment és el mateix que "docked", però pot arribar a ser configurable per l'usuari en algun moment). En general, es recomana deixar-ho com a paràmetre predeterminat per a la millor coherència de la interfície d'usuari (opcional, el valor predeterminat és "default")

active

Si la vista prèvia està activa de manera predeterminada. En general, només les vistes prèvies acoblades es faran actives de manera predeterminada, i fins i tot per a aquestes, hi ha un motiu pel qual el valor predeterminat és de vistes prèvies inactives (opcional, el valor predeterminat és "false")

Secció de lògica

<logic>

L'element que conté la secció lògica. Tots els elements següents només es permeten dins de l'element <logic>. L'element <logic> només es permet com a fill directe de l'element <document> (com a màxim una vegada per document), o dels elements <optionset> (com a màxim una vegada per «optionset»). La secció lògica del document s'aplica tant a la IGU de <dialog> com a <wizard> de la mateixa manera.

<external>

Crea una propietat nova (cadena) que se suposa que està connectada a una propietat externa si el connector s'incrusta. Vegeu la secció sobre els connectors «incomplets». Atributs:

id

L'ID de la propietat nova (requerit)

default

El valor predeterminat de la cadena de la propietat nova, és a dir, el valor utilitzat si la propietat no està connectada a una propietat externa (opcional, el valor predeterminat és una cadena buida)

<i18n>

Crea una propietat nova (cadena) que se suposa que proporciona una etiqueta que es pot traduir (i18n). Atributs:

id

L'ID de la propietat nova (requerit)

label

L'etiqueta. Això es traduirà. (Requerida)

<set>

Estableix una propietat a un valor fix (per descomptat, si connecteu addicionalment la propietat a alguna altra propietat, el valor no es manté fix). Per exemple, si incrusteu un connector, però voleu ocultar alguns dels seus elements, podeu establir la propietat de visibilitat d'aquests elements a fals. Especialment útil per a connectors incrustats/incrustants. Nota: si hi ha diversos elements <set> per a un únic id, l'últim a definir tindrà prioritat. Això de vegades serà útil per a confiar quan s'usin les parts <include>. Atributs:

id

L'ID de la propietat a establir (requerit)

to

El valor de la cadena a establir la propietat (requerit). Nota: Per a les propietats booleanes com la visibilitat, l'habilitació, normalment establireu l'atribut a «to="true"» o a «to="false"».

<convert>

Crea una propietat booleana nova que depèn de l'estat d'una o més propietats diferents. Atributs:

id

L'ID de la propietat nova (requerit)

sources

Els identificadors de les propietats de les quals dependrà aquesta propietat. Es poden especificar una o més propietats, separades per «;» (requerit)

mode

El mode de conversió/operació. Un d'entre "equals", "notequals", "range", "and", "or". Si és en mode "equals", la propietat només serà certa si el valor de totes les seves fonts és igual que l'estàndard de l'atribut (vegeu a sota). Si està en el mode "notequals", la propietat només serà certa si el valor de totes les seves fonts són diferents de l'estàndard de l'atribut (vegeu a sota). Si està en mode "range", les fonts han de ser numèriques (entera o real). La propietat només serà certa, si totes les fonts estan en l'interval especificat pels atributs mín i màx. Si està en mode "and", les fonts han de ser propietats booleanes. La propietat només serà certa, si totes les fonts són certes simultàniament. Si està en mode "or", les fonts han de ser propietats booleanes. La propietat només serà certa, si almenys una de les fonts és certa. (Requerit)

standard

Només té sentit en els modes "equal" o "notequals": el valor de la cadena contra el qual comparar (requerit si està en un d'aquests modes)

min

Només té sentit en el mode "range": el valor mínim contra el qual comparar (opcional, predeterminat al número de coma flotant més baix representable a la màquina)

max

Només té sentit en el mode "range": el valor màxim contra el qual comparar (opcional, predeterminat al número de coma flotant més gran representable a la màquina)

require_true

Si s'estableix a "true", la propietat serà obligatòria, i només es considerarà vàlida si el seu estat és cert/activat. Per tant, si la propietat és falsa, bloquejarà el botó Envia (opcional, el valor predeterminat és "false").

Atenció

Si utilitzeu això, assegureu-vos que l'usuari pot detectar fàcilment el què està malament, com ara mostrar un <text> d'explicació.

<switch>

Crea una propietat nova que retransmetrà a diferents propietats de destinació (o cadenes fixes) en funció del valor d'una propietat de condició. Això permet crear una lògica similar a les construccions if() o switch(). Atributs:

id

L'ID de la propietat nova (requerit)

condition

L'identificador de la propietat de condició (requerit)

Elements fills:

<true>

Si la propietat condició és booleana, podeu especificar els dos elements fills <true> i <false> (i només aquests). (Requerit, si també es proporciona <false>)

<false>

Si la propietat condició és booleana, podeu especificar els dos elements fills <true> i <false> (i només aquests). (Requerit, si també es proporciona <true>)

<case>

Si la propietat condició no és booleana, podeu proporcionar un nombre arbitrari d'elements <case>, un per a cada valor de la propietat condició que voleu que coincideixi (almenys es requereix un d'aquests elements, si la propietat condició no és booleana)

<default>

Si la propietat condició no és booleana, l'element opcional <default> permet especificar el comportament, si no hi ha cap element <case> que coincideixi amb el valor de la propietat condició (opcional, permès només una vegada, en combinació amb un o més elements <case>).

Els elements fills <true>, <false>, <case>, i <default> prenen els atributs següents:

standard

Només per als elements <case>: el valor amb el qual coincidir la propietat condició (requerit, cadena).

fixed_value

Una cadena fixa que s'ha de proporcionar com el valor de la propietat <switch>, si la condició actual coincideix (requerit, si no es proporciona dynamic_value).

dynamic_value

L'id de la propietat de destinació que s'ha de proporcionar com el valor de la propietat <switch>, si la condició actual coincideix (requerit, si no es proporciona fixed_value).

<connect>

Connecta dues propietats. La propietat del client es canviarà sempre que la propietat del governador canviï (però no a l'inrevés). Atributs:

client

L'ID de la propietat del client, és a dir, la propietat que s'ajustarà (requerit)

governor

L'ID de la propietat del governador, és a dir, la propietat que ajustarà la propietat del client. Això pot incloure un modificador (requerit)

reconcile

Si és «true», la propietat del client ajustarà la propietat del governador en la connexió de tal manera que la propietat del governador només acceptarà valors que també siguin acceptables pel client (p. ex., suposem que el governador és una propietat numèrica amb valor mínim «0», i el client és una propietat numèrica amb valor mínim «100». El mínim d'ambdues propietats s'ajustarà a 100, si reconcile="true"). Generalment només funciona per a propietats del mateix tipus bàsic (opcional, predeterminat a "false")

<dependency_check>

Crea una propietat booleana que és certa, si es compleixen les dependències especificades, falsa en cas contrari. La sintaxi XML de l'element és la mateixa que la de l'element <dependencies>, descrit en la referència del .pluginmap. A partir del RKWard 0.6.1, només es tindran en compte les especificacions de versió del RKWard i R, no les dependències en els paquets o els .pluginmap.

<script>

Defineix el codi de script per a controlar la lògica de la IU. Vegeu la secció sobre la lògica de script de GUJI per a més detalls. El codi de l'script a executar es pot donar utilitzant l'atribut "file", o com un text (comentat) de l'element. L'element <script> no està permès a la secció <logic> d'un «optionset». Atributs:

file

Nom de fitxer del fitxer de script. (Requerit)