Référence rapide

Aide-mémoire Ractive.js

Guide de référence rapide pour Ractive.js : liaison de données bidirectionnelle, modèles mustache, propriétés calculées et architecture de composants.

· Publié le

Ractive.js est une bibliothèque d interface utilisateur pilotée par des modèles apportant liaison bidirectionnelle et réactivité au DOM.

Initialisation

const ractive = new Ractive({
  target: '#app',
  template: '#my-template',
  data: {
    greeting: 'Hello',
    user: { name: 'Alice' },
    count: 0
  }
});

Syntaxe des modèles (Mustache)

<!-- Affichage des données -->
<h1>{{greeting}}, {{user.name}}!</h1>

<!-- Sortie HTML brute non échappée -->
<div>{{{unescapedHtml}}}</div>

<!-- Liaison bidirectionnelle de champ -->
<input value="{{user.name}}" />

<!-- Conditions -->
{{#if count > 0}}
  <p>Articles dans le panier : {{count}}</p>
{{else}}
  <p>Votre panier est vide.</p>
{{/if}}

<!-- Itération de liste -->
<ul>
  {{#each items:i}}
    <li>{{i + 1}}: {{this.name}}</li>
  {{/each}}
</ul>

Méthodes d instance

// Lecture et écriture de données réactives
ractive.get('user.name');        // => "Alice"
ractive.set('user.name', 'Bob'); // Updates DOM immediately

// Utilitaires numériques
ractive.add('count', 1);
ractive.subtract('count', 1);

// Basculer une valeur booléenne
ractive.toggle('isVisible');

// Observer les modifications
ractive.observe('user.name', (newValue, oldValue) => {
  console.log(`Nom modifié en ${newValue}`);
});

Gestion des événements

<button on-click="@this.fire('submitForm', user)">Envoyer</button>
ractive.on('submitForm', (event, user) => {
  console.log('Utilisateur soumis :', user);
});

Références

Sujets associés