Sys.Component.create, méthode
Mise à jour : novembre 2007
Crée et initialise un composant du type spécifié. Cette méthode est statique et peut être appelée sans créer d'instance de la classe.
aComponent.create(type, properties, events, references, element);
Paramètres
Paramètre |
Description |
|---|---|
type |
Type du composant à créer. |
properties |
(Facultatif) Objet JSON qui décrit les propriétés et leurs valeurs. |
events |
(Facultatif) Objet JSON qui décrit les événements et leurs gestionnaires. |
references |
(Facultatif) Objet JSON qui décrit les propriétés qui sont des références à d'autres composants. |
element |
(Facultatif) Élément DOM auquel doit être joint le composant. |
Valeur de retour
Nouvelle instance d'un composant qui utilise les paramètres spécifiés.
Notes
La méthode create instancie un composant du type spécifié. Si le composant est un contrôle ou un comportement, la méthode create joint le composant à l'élément spécifié. La méthode définit toutes les propriétés ou tous les événements qui sont passés en tant que paramètres, puis appelle la méthode initialize.
Le composant à créer doit dériver de la classe Sys.Component, soit directement, soit par dérivation de Sys.UI.Control ou de Sys.UI.Behavior. Vous devez appeler la méthode create durant l'événement Sys.Application.init afin de garantir que le composant créé est disponible durant le chargement de la page.
La méthode create peuvent également être appelée à l'aide de la méthode de raccourci $create.
La plupart des paramètres pour cette méthode sont facultatifs, mais un appel à la méthode create doit inclure null en tant qu'espace réservé pour tous les paramètres que vous ne transmettez pas. Les valeurs utilisées pour les paramètres properties, events et references doivent être encadrées par des accolades ({}) et doivent être au format JSON standard suivant :
{argument: value, argument2: value, ...}
L'exemple suivant représente une méthode create qui transmet des valeurs pour la plupart des paramètres :
$create(MyControl, {id: 'c1', visible: true}, {click: showValue}, null, $get('button1'));
Cette méthode crée une instance de la classe MyControl, affecte à sa propriété id la valeur "c1" et affecte à sa propriété visible la valeur true. Cette classe comporte un événement click, qui est lié à la fonction showValue() sur la page. Cette instance crée une liaison avec un élément DOM HTML qui possède l'ID "button1". Cette classe ne comporte aucune propriété qui fait référence à d'autres composants, par conséquent, le paramètre references a la valeur null.
.gif "Remarque") Remarque : |
|---|
N'appelez pas la méthode create ni la méthode de raccourci $create à partir de la méthode initialize d'un autre composant. Sinon, le nouveau composant ne s'initialisera pas correctement. Au lieu de cela, créez le composant, puis passez-le comme une référence au composant supérieur. |
Voir aussi
Tâches
Création de composants clients non visuels personnalisés
Concepts
Création d'une classe Component cliente à l'aide du modèle de prototype