Referência rápida

Guia Rápido de Ractive.js

Guia de referência para Ractive.js: ligação bidirecional de dados, modelos mustache, propriedades computadas e arquitetura de componentes.

· Publicado

O Ractive.js é uma biblioteca de UI orientada a templates que fornece data-binding bidirecional, transições e reatividade ao DOM.

Inicialização

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

Sintaxe de Templates (Mustache)

<!-- Saída de dados -->
<h1>{{greeting}}, {{user.name}}!</h1>

<!-- Saída HTML bruta -->
<div>{{{unescapedHtml}}}</div>

<!-- Vinculação bidirecional de input -->
<input value="{{user.name}}" />

<!-- Condicionais -->
{{#if count > 0}}
  <p>Itens no carrinho: {{count}}</p>
{{else}}
  <p>Seu carrinho está vazio.</p>
{{/if}}

<!-- Iteração de lista -->
<ul>
  {{#each items:i}}
    <li>{{i + 1}}: {{this.name}}</li>
  {{/each}}
</ul>

Métodos de Instância

// Lendo e gravando dados reativos
ractive.get('user.name');        // => "Alice"
ractive.set('user.name', 'Bob'); // Updates DOM immediately

// Utilitários numéricos
ractive.add('count', 1);
ractive.subtract('count', 1);

// Alternar valor booleano
ractive.toggle('isVisible');

// Observar alterações
ractive.observe('user.name', (newValue, oldValue) => {
  console.log(`Nome alterado para ${newValue}`);
});

Manipulação de Eventos

<button on-click="@this.fire('submitForm', user)">Enviar</button>
ractive.on('submitForm', (event, user) => {
  console.log('Usuário enviado:', user);
});

Referências

Temas relacionados