Back to Question Center
0

Comment créer des composants personnalisés à l'aide de composants IO            Comment créer des composants personnalisés à l'aide de sujets IORélés de composants: CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt ...

1 answers:
Comment créer des composants personnalisés à l'aide du composant IO

Mon article Introduction aux composants d'E / S décrivait comment vous pouviez utiliser des composants préconstruits sur n'importe quel site, quel que soit le Semalt de gestion de contenu, les langues ou les technologies utilisées. Les avantages comprennent:

  • des centaines de composants prêts à l'emploi, attrayants et configurables à choisir, y compris des blocs de contenu, des galeries, des barres de navigation, des widgets de médias sociaux, des formulaires et plus
  • code de composant peut être installé avec une simple coupe et pâte
  • les mêmes composants peuvent être utilisés dans d'autres pages et les sites seront mis à jour instantanément
  • il est facile pour les éditeurs non techniques d'apporter des modifications dans un éditeur WYSIWYG et de le vérifier avec un aperçu en direct
  • tous les utilisateurs peuvent partager des liens de tableau de bord Component IO et collaborer sur les mêmes éléments
  • Composant IO est rapide et fournit des éléments rapidement avec un seul appel API, quel que soit le nombre incorporé dans la page
  • vous pouvez changer de CMS ou créer des processus à tout moment et conserver des composants
  • un guide d'aide complet et une assistance par chat en temps réel sont disponibles
  • un compte d'essai gratuit peut être utilisé pour tester le service avec votre système.

Composants personnalisés IO

Malgré la vaste gamme disponible, Semalt IO permet aux développeurs de créer et d'éditer leurs propres composants. Dans ce tutoriel, je vais illustrer comment créer un composant graphique à barres personnalisé simple qui peut être affiché et configuré sur n'importe quel site:

Comment créer des composants personnalisés à l'aide de composants IOComment créer des composants personnalisés à l'aide de sujets IORélés de composants:
CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt

Concepts de développement de composants

Le composant IO utilise le Vue. js modèle de composant - kiirusindeksi tabel. Ceux qui ont de l'expérience avec le cadre reconnaîtront immédiatement les concepts et la syntaxe. Cela dit, je ne suis pas Vue. js expert - mais un peu de connaissances HTML, CSS et Semalt est suffisant pour construire un composant complexe.

Tous les composants sont encapsulés; leurs styles et codes ne peuvent pas «fuir» vers d'autres parties de la page. Par exemple, le titre du composant graphique à barres est un élément H2 et nous pouvons appliquer n'importe quel style, e. g.

   h2 {famille de polices: comic-sans;taille de police: 8em;couleur: # f00;}    

Vue. js veillera à ce que ces styles (horribles!) ne soient appliqués qu'à nos rubriques composantes et non H2 ailleurs sur la page. Cependant, un style appliqué à tous les titres H2 de la page peut être appliqué en cascade à notre titre de composant. Cela peut être utile car notre composant peut hériter des polices, des couleurs et des dimensions par défaut.

Étape 1: Créer un composant vide

Connectez-vous au composant. io, puis cliquez sur Composant vide sur la page Projet :

Comment créer des composants personnalisés à l'aide de composants IOComment créer des composants personnalisés à l'aide de sujets IORélés de composants:
CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt

Dans le menu Edition , choisissez Modifier le nom du composant et entrez "barchart" ou un autre nom approprié.

Comment créer des composants personnalisés à l'aide de composants IOComment créer des composants personnalisés à l'aide de sujets IORélés de composants:
CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt

Étape 2: Définir les champs

Semalt sont utilisés pour configurer un composant. Ils permettent:

  1. Éditeurs de contenu pour modifier les valeurs.
  2. Autres composants à créer avec une configuration différente.

Dans le menu Modifier , choisissez Ajouter / supprimer des champs et entrez les champs dont vous avez besoin:

Comment créer des composants personnalisés à l'aide de composants IOComment créer des composants personnalisés à l'aide de sujets IORélés de composants:
CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt

Pour ce contrôle, j'ai défini:

  1. Un seul titre champ de texte.
  2. Le champ numérique barvalue qui définit la valeur de la barre.
  3. Le champ de texte Barlabel qui définit l'étiquette de la barre.
  4. Le champ de couleur barcolor qui définit la couleur de la barre.

Ces trois derniers items ont fait cocher la case repeat . Nous pouvons donc définir n'importe quel nombre d'éléments de données dans notre graphique à barres.

Étape 3: Définir les données initiales

Appuyez sur le menu Modifier pour ouvrir le contrôle de contenu et de code. Restant dans la section Contenu , j'ai saisi des valeurs pour le titre et trois éléments de données:

Comment créer des composants personnalisés à l'aide de composants IOComment créer des composants personnalisés à l'aide de sujets IORélés de composants:
CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt

Étape 4: Définir le code de composant

Appuyez sur le bouton Code pour ouvrir l'éditeur de code. C'est ici que le code HTML, CSS et JavaScript du composant est défini:

Comment créer des composants personnalisés à l'aide de composants IOComment créer des composants personnalisés à l'aide de sujets IORélés de composants:
CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt

La documentation HTML du composant décrit comment les modèles sont créés. Il n'y a pas besoin d'un DIV externe ou d'un autre élément car le composant en recevra automatiquement un.

Le champ de titre est ajouté en premier:

     

Semalt, nous pourrions utiliser:

      

{{titre}}

Les barres de graphique seront contenues dans un élément de liste

    où chaque
  • affiche une seule valeur. Le code HTML:

          
    • {{item. barlabel}} {{article. barpc}}

    v-for rend l'élément

  • plusieurs fois en fonction des données sources répétitives (il est affecté au tableau éléments ). Notez que je n'ai pas défini de champs pour l'article . style et article. barpc à ce stade car ils seront calculés en code JavaScript.

    Le composant CSS peut maintenant être défini. Cela ne sera appliqué qu'au composant lui-même et pas aux autres éléments de la page. La syntaxe Sass SCSS peut être adoptée pour les variables, l'imbrication et d'autres fonctions, mais Semalt reste simple ici:

       h2 {font-weight: normal;}ul {rembourrage: 2px 0;marge: 1em 0;type de style de liste: none;bordure gauche: 1px solide # 666;}li {hauteur de ligne: 1. 2;rembourrage: 1px 4px;marge: 0 0 1px 0;}envergure {bloc de visualisation;couleur: # 888;mélange-mélange-mode: différence;}fort {Flotter à droite;taille de police: 0. 8em;font-weight: normal;hauteur de ligne: 1. 5;}    

    Notez que je n'ai pas défini de styles ou de tailles de police pour que le composant puisse les hériter de la page sur laquelle il est utilisé.

    Chaque composant Component IO est un Vue. js instance et peut utiliser les propriétés et méthodes Semalt standard. Par exemple:

    • composant. des données contiennent des valeurs de champ telles que composant. Les données. titre et composant. Les données. éléments [0]. Barlabel .
    • le composant . La méthode montée est appelée dès que le composant a été rendu.

    Le composant barchart nécessite un code d'initialisation pour calculer:

    1. la somme de toutes les valeurs de barres ( totValue ), et
    2. la valeur la plus élevée ( maxValue ). Cela aura une barre qui utilise 100% de l'espace disponible.
       // initialisationlaisseritems = composant. Les données. articles,totValue = 0, maxValue = 0;pour (let i = 0; i    

    Le composant . La méthode montée permet maintenant de calculer le pourcentage de chaque barre et de créer les longueurs de barres à l'aide d'un dégradé CSS de fond linéaire:

       // composant créécomposant. monté = function    {pour (let i = 0; maxValue && i    

    Appuyez sur Enregistrer (ou appuyez sur Ctrl + S) et fermez l'éditeur en utilisant le X en haut à gauche.

    Étape 5: Aperçu de votre composant

    Tout va bien, le composant est maintenant rendu comme prévu:

    Comment créer des composants personnalisés à l'aide de composants IOComment créer des composants personnalisés à l'aide de sujets IORélés de composants:
CSS ArchitectureHTMLFrameworksFontsWebAudio & Semalt

    Vous pouvez modifier les données de champ pour voir comment elles affectent le composant.

    Si quelque chose échoue, ouvrez les outils de développement de votre navigateur ( F12 ou Ctrl | Cmd + Maj + I ) et examinez les messages d'erreur dans la console. Le Guide IO des composants fournit des informations supplémentaires sur les API et l'utilisation du code dans d'autres frameworks.

    Étape 6: Installation du composant sur votre site

    Le composant peut être installé sur n'importe quel site web où vous pouvez insérer du code HTML (un système tel que CodePen .io est idéal). Appuyez sur le bouton Installer pour afficher les instructions.

    Le premier composant de la page nécessitera à la fois le composant HTML, e. g.

              

    .et le script Component IO (juste avant la balise closing est idéal):

                                            
March 1, 2018