Editor X : Ajouter un élément personnalisé à votre site

Temps de lecture : 5 min
Editor X passe à Wix Studio, notre nouvelle plateforme pour les agences et les freelances.En savoir plus sur Wix Studio
Améliorez votre site avec vos propres fonctionnalités de design et capacités CSS à l'aide d'éléments personnalisés. Vous pouvez ajouter n'importe quel composant JavaScript en reliant un élément personnalisé à une URL de serveur ou à un fichier Velo. Si nécessaire, vous pouvez définir plus d'attributs directement à partir de l'Editor X. 

En savoir plus sur :

Avant de commencer :
Assurez-vous que votre site possède un forfait Premium et un domaine connecté sans publicité Editor X. En savoir plus

Que sont les éléments personnalisés ?

Les éléments personnalisés vous permettent d'utiliser vos propres balises HTML sur votre site Editor X. Ces éléments fonctionnent sur tous les navigateurs pris en charge et peuvent être utilisés avec n'importe quelle bibliothèque ou framework JavaScript ES6 qui fonctionne avec HTML 5.
Suggestions :
  • Vous pouvez utiliser des éléments personnalisés provenant de sources tierces, assurez-vous simplement de mettre à jour le nom de la balise dans les propriétés lorsque vous ajoutez l'élément personnalisé à votre page.
  • Les performances de votre élément personnalisé dépendent de sa mise en œuvre.

Ajouter et configurer l'élément personnalisé

Ajoutez autant d'éléments personnalisés que vous le souhaitez à votre site. Après avoir fait glisser un élément personnalisé sur votre page, définissez sa source (URL du serveur ou un fichier Velo) et donnez-lui un nom de balise qui apparaîtra dans le registre de la page.
Utiliser le panneau Inspecteur  pour vous assurer que votre élément personnalisé apparaît correctement dans tous les points de rupture – vous pouvez ajuster sa taille, son ancrage, son alignement et plus encore. 
Remarque :
Par défaut, les éléments personnalisés apparaissent dans le registre customElements de votre page. Le nom de la balise que vous saisissez pour votre élément personnalisé définit son nom dans ce registre. 

Paramétrer les attributs de l'élément personnalisé

Ajustez davantage les propriétés et le comportement de votre élément en définissant des attributs HTML. Le panneau Attributs des éléments vous permet d'ajouter, de modifier et de supprimer des attributs directement à partir de l'Editor X, afin que vous n'ayez pas à accéder au code réel.
Important :
Le code de votre élément personnalisé doit reconnaître et gérer les attributs définis. Sinon, ils ne fonctionneront pas correctement.

Exemple d'élément personnalisé

Vous trouverez ci-dessous un exemple d'ajout d'un élément personnalisé de base à votre site. Les instructions expliquent comment ajouter le texte « Bonjour à tous » sur votre site.
Tout d'abord, vous devez créer et coder l'élément et son comportement dans un fichier JavaScript. 
Ensuite, définissez la classe d'élément personnalisée.
Dans cet exemple, nous l'avons définie comme BonjouràTous et nous utiliserons le même nom lors de l'inscription de l'élément personnalisé. La fonction connectedCallback () ci-dessous est une fonction de rappel du cycle de vie qui se déclenche automatiquement lorsque l'élément est attaché au DOM.
1La classe Bonjour à tous étend le HTMLElement { connectedCallback() { this.innerHTML = 'Bonjour à tous!' ; } } customElements.define('bonjour-à-tous', Bonjour à tous) 
Après avoir défini la classe d'élément personnalisé, nous l'enregistrons avec la méthode customElements.define(name, class)
Lorsque vous ajoutez l'élément personnalisé à votre site, saisissez le nom enregistré comme Nom de la balise. Une fois enregistré, l'élément personnalisé peut être utilisé sur votre site.
1CustomElementRegistry.define('bonjour-à-tous', Bonjouràtous) ;
Vous souhaitez obtenir davantage d'informations ?
Cliquez ici pour savoir comment utiliser cet élément avec Velo by Wix.

Cela vous a-t-il aidé ?

|