# Introdução ao Velo by Wix

Source: https://support.wix.com/pt/article/introdu%C3%A7%C3%A3o-ao-velo-by-wix (updated 2024-06-02)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Visite o [site do Velo by Wix](https://www.wix.com/velo) para começar e continuar aprendendo.

Velo by Wix é um produto inovador que permite criar aplicações Web sofisticadas sem nenhuma configuração. Utilize o construtor visual do Wix, adicione funcionalidades e interações personalizadas usando as APIs do Velo e crie código sem servidores tanto no front-end quanto no back-end. Com Velo, sua aplicação Web pode estar em pleno funcionamento em uma fração do tempo que normalmente levaria.

Para apresentar você ao Velo, criamos nossa própria versão do "Olá, mundo!": um site simples de conversão de moeda que usa a [API wix-fetch](https://www.wix.com/code/reference/wix-fetch.html) para fazer conexão com um serviço de terceiros. Os visitantes do site podem escolher as moedas de origem e destino em menus dropdown e digitar uma quantia a ser convertida. Os resultados são exibidos em uma caixa de texto.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/0ca9e8ba-16ed-4cd8-a1e1-58d01c4420f7/2019/03/07/37a87ea6-7a20-4902-b51a-0fe6acecd54a.png)

Siga as etapas abaixo para se familiarizar com a estrutura e sintaxe básicas do Velo.

## Etapa 1: crie um novo site Wix

1. Faça login na sua conta Wix ou [crie uma conta Wix](https://users.wix.com/signin?overrideLocale=en&loginDialogContext=signup) caso ainda não tenha uma.
2. [Abra um template em branco](https://editor.wix.com/html/editor/web/renderer/new?siteId=cbf36d3a-49d0-41c2-9482-1bb58d5fdda3&metaSiteId=a573279f-ae6f-46d1-8556-7c93ae9b2c84&editorSessionId=799795e9-07c2-4e7e-8a17-33dab829f776) no Editor.

## Etapa 2: ative o Velo

Ative o Velo no Editor Wix para que você possa usar código no site.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/2d3f30b2-74a7-4aec-8ef7-67de4fff5318/2021/01/04/068db20d-6a79-4308-a41b-0b92360d2bb2/a44cc7f9-a032-43b7-a522-c46a8bc2afd4.png)

## Etapa 3: adicione elementos à página

Adicione elementos da página no Editor Wix:

1. Clique em **Adicionar** na parte esquerda do Editor.
2. Adicione ao seu site os elementos da página ilustrados abaixo.
* Ao adicionar cada elemento, defina o ID no painel de [propriedades e eventos](https://support.wix.com/pt/article/velo-trabalhar-com-o-painel-propriedades-e-eventos) que é exibido na parte direita do Editor. Use o nome de cada elemento exibido abaixo, retirando o hashtag (#). Veja na tabela abaixo a lista completa de elementos e onde encontrá-los no menu Adicionar.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/40afd1a0-2e56-4e00-b71d-c690764e3c7e/2019/07/22/027850ea-8056-4ca8-9151-fea4ddc651ac/2e15e00f-99a5-4015-be14-0a278662b740.png)

| Elemento | Local no menu Adicionar | Descrição | ID |
| --- | --- | --- | --- |
| Menu Dropdown | Campo de Entrada | Para selecionar a moeda de origem | sourceCurrency |
| Menu Dropdown | Campo de Entrada | Para selecionar a moeda de destino | targetCurrency |
| Entrada | User Input | Para digitar a quantia a ser convertida | sourceAmount |
| Caixa de Texto | Campo de Entrada | Para exibir a quantia convertida | targetAmount |
| Botão | Botão | Para efetuar a conversão de moeda ao ser clicado | calculateButton |

## Etapa 4: adicione código

> **Observações**
>
> * Todo o código deste exemplo é adicionado a uma única página do site. Nesta seção, dividimos o código em pequenos blocos seguidos de explicações. Para ver o código completo deste exemplo sem os comentários, [role a tela](https://support.wix.com/pt/article/introdução-ao-velo-by-wix#example-code) para o final do tutorial.
> * Consulte nossa [referência de API](https://www.wix.com/code/reference/) para saber mais sobre o código baseado em Velo deste exemplo.

**Para adicionar o código:**

1. Clique duas vezes no **Código da Página Inicial** na parte inferior do Editor para abrir o [painel de código](https://support.wix.com/pt/article/velo-trabalhar-no-painel-de-código).
2. Adicione o seguinte código à parte superior do código na aba antes da função [onReady](https://support.wix.com/pt/article/velo-trabalhar-no-painel-de-código#making-sure-the-element-has-loaded-before-you-reference-it):

```javascript
// A função getJSON em wix-fetch permite recuperar um
// recurso JSON da rede usando HTTPS.
import {getJSON} from 'wix-fetch';

// Configura o URL do serviço de terceiros.
const url = "https://api.exchangeratesapi.io/latest";

// Define os valores de opção de moeda e o texto dos menus dropdown.
let currencyOptions = [
  { "value": "USD",  "label": "US Dollars"},
  { "value": "EUR",  "label": "Euros"},
  { "value": "JPY",  "label": "Japanese Yen"},
];
```

1. Adicione o código abaixo à função [onReady](https://support.wix.com/pt/article/velo-trabalhar-no-painel-de-código#making-sure-the-element-has-loaded-before-you-reference-it). O código dentro da função onReady é executado quando a página é carregada.

```javascript
$w.onReady(function () {
  // Define as opções de moeda dos menus dropdown.
  populateDropdowns();

  // Define o manipulador de eventos onClick para que o calculateButton calcule a moeda de destino.
  $w('#calculateButton').onClick((event) => {
    calculateCurrency();
  })
});
```

A função [$w](https://www.wix.com/code/reference/$w.html#$w) pode selecionar elementos de uma página por ID ou por tipo, permitindo a execução de funções e definição das propriedades dos elementos. Use esta sintaxe para selecionar um elemento por ID: `$w("#myElementId")` e esta para selecionar por tipo: `$w("ElementType")`.

qui selecionamos o botão e definimos um manipulador de eventos `onClick` [event handler](https://support.wix.com/pt/article/velo-reagindo-a-ações-do-usuário-utilizando-eventos#about-events-event-handlers-and-wiring) para calcular a quantia na moeda de destino.

4\. Adicione código para definir as funções:  
  
**populateDropdowns( )**

```javascript
// Preenche os menus dropdown.
function populateDropdowns(){
  // Define as opções dos menus dropdown.
  $w("Dropdown").options = currencyOptions;
  // Define a primeira opção do menu dropdown como a opção inicial.
  $w("Dropdown").selectedIndex = 0;
}
```

Aqui selecionamos todos os menus dropdown por tipo. Ao chamar a função [$w](https://www.wix.com/code/reference/$w.html) com o elemento do tipo "Menu Dropdown", selecionamos todos os menus `dropdown` da página.

**calculateCurrency( )**

```javascript
// Calcula a quantia de destino.
function calculateCurrency() {
  // Quantia inicial 
  let initialAmount = $w("#sourceAmount").value;
  // Moeda de origem
  let sourceSymbol = $w("#sourceCurrency").value;
  // Moeda de destino
  let targetSymbol = $w("#targetCurrency").value;
  // Define o URL completo.
  let fullUrl = `${url}?base=${sourceSymbol}&symbols=${targetSymbol}`;
    
  // Chama a função API wix-fetch para recuperar o recurso JSON.
  getJSON(fullUrl)
  .then(json => {
    // Define a quantia de destino como a quantia inicial multiplicada 
   // pela taxa de conversão.
    $w("#targetAmount").value = initialAmount * json.rates[targetSymbol];
  }
)}
```

Usamos [literais](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template%5Fliterals) para definir o URL completo, que inclui as moedas de destino e de origem.

A função [getJSON](https://www.wix.com/code/reference/wix-fetch.html#getJSON) da API wix-fetch recupera o recurso JSON usando o URL completo. A função `getJSON` retorna uma [promessa](https://support.wix.com/pt/article/velo-como-trabalhar-com-promessas), que é resolvida para um objeto JSON.

Multiplicamos a taxa recebida pela quantia inicial e atribuímos o resultado à caixa de texto `targetAmount`.

## Etapa 5: veja o código em funcionamento

Agora está na hora de testar o site:  
  
1. Clique em **Visualizar** na parte superior direita do Editor.
2. Digite uma quantia no campo de entrada da moeda de origem.
3. Clique no botão Calcular e veja a quantia convertida na caixa de texto da quantia de destino.
4. [Publique](https://support.wix.com/pt/article/editor-wix-publicando-seu-site) o site online para atualizá-lo e deixá-lo pronto para exibição.

  
 Pronto! Em apenas alguns minutos, você criou uma aplicação Web no Velo! Sem precisar configurar nem gerenciar a infraestrutura de servidores, apenas integrando as APIs do Velo com o construtor visual do Wix.

## Próximas etapas

Agora que você conhece o Velo, confira o que mais você pode fazer:

* Chame facilmente o código de back-end a partir do front-end usando [módulos Web](https://support.wix.com/pt/article/módulos-web-velo-chamando-código-do-lado-do-back-end-do-front-end)
* Utilize o [construtor visual](https://support.wix.com/pt/article/editor-wix-introdução-ao-editor-wix) do Wix
* Adicione recursos e personalize seu site usando as [APIs do Velo](https://www.wix.com/code/reference/). Seguem alguns exemplos do que você pode fazer:  
   * [Receber](https://support.wix.com/pt/article/tutorial-do-velo-como-utilizar-a-api-velo-pagamentos-para-receber-pagamentos-por-um-único-produto) pagamentos  
   * [Criar](https://support.wix.com/en/article/velo-tutorial-expand-text-with-a-read-more-link) um link "Mostrar mais" (artigo em inglês)  
   * [Usar](https://www.wix.com/Velo/example/create-a-custom-chart) componentes HTML para incorporar um gráfico na sua página  
   * Trabalhar com dados de [outros aplicativos Wix](https://support.wix.com/pt/article/velo-trabalhando-com-coleções-de-aplicativos-wix-e-código), como [Stores](https://support.wix.com/pt/wix-code/wix-stores-with-wix-code), [Bookings](https://support.wix.com/pt/wix-code/wix-bookings-with-wix-code) e Events
* Visite [Velo by Wix](https://www.wix.com/velo) para começar e continuar aprendendo. Verifique a [documentação](https://support.wix.com/pt/wix-code/wix-code-basics) do Velo e a [referência de API](https://www.wix.com/Velo/reference)

## Exemplo de código

Segue o código completo deste exemplo sem comentários:

```javascript
import {getJSON} from 'wix-fetch';

const url = "https://api.exchangeratesapi.io/latest";

let currencyOptions = [
  { "value": "USD",  "label": "US Dollars"},
  { "value": "EUR",  "label": "Euros"},
  { "value": "JPY",  "label": "Japanese Yen"},
];

$w.onReady(function () {
  populateDropdowns();
 
  $w('#calculateButton').onClick((event) => {
    calculateCurrency();
  })
});

function populateDropdowns(){
  $w('Dropdown').options = currencyOptions;
  $w('Dropdown').selectedIndex = 0;
}

function calculateCurrency() {
  let initialAmount = $w("#sourceAmount").value;
  let sourceSymbol = $w("#sourceCurrency").value;
  let targetSymbol = $w("#targetCurrency").value;
  let fullUrl = `${url}?base=${sourceSymbol}&symbols=${targetSymbol}`;

  getJSON(fullUrl)
  .then(json => {
    $w("#targetAmount").value = initialAmount * json.rates[targetSymbol];
  }
)}
```
