Documentacion

Aprende a crear y compartir calculadoras personalizadas con Calcula.club.

Primeros pasos

Calcula.club te permite crear calculadoras personalizadas sin escribir codigo. Ve al Builder para empezar a construir tu calculadora arrastrando campos y definiendo formulas.

  • Haz clic en "Empezar a crear" en la pagina principal
  • Arrastra campos al lienzo o haz clic en los tipos de campo
  • Configura las propiedades de cada campo (etiqueta, min, max, etc.)
  • Escribe tu formula usando los IDs de los campos
  • Comparte tu calculadora con la URL generada
  • Tipos de campo

    Calcula.club ofrece varios tipos de campo:

  • Numero — Campo de entrada numerica con min, max y paso opcionales
  • Slider — Deslizador visual con rango configurable
  • Selector — Lista desplegable con opciones personalizadas (cada opcion tiene un valor numerico)
  • Checkbox — Casilla si/no que produce 0 o 1
  • Radio — Grupo de botones con opciones personalizadas
  • Fecha — Selector de fecha (se convierte a dias epoch en la formula)
  • Rango — Deslizador doble que genera dos variables: id_min e id_max
  • Seccion — Bloque de texto con soporte para markdown y valores dinamicos {{formula}}
  • Divisor — Separador visual, opcionalmente con imagen o texto
  • Sintaxis de formulas

    Las formulas usan los IDs de los campos como variables. Puedes usar operadores aritmeticos estandar y funciones incorporadas.

    Operadores: +, -, *, /, % (modulo), ^ (potencia)

    Comparaciones: >, <, >=, <=, ==, != (devuelven 1 o 0)

    Variables intermedias: Usa punto y coma para definir variables locales:

    tasa_mensual = interes / 100 / 12;
    n = plazo * 12;
    capital * tasa_mensual / (1 - pow(1 + tasa_mensual, -n))

    Funciones disponibles:

  • Matematicas: pow(x,y), sqrt(x), abs(x), round(x), floor(x), ceil(x)
  • Trigonometria: sin(x), cos(x), tan(x), asin(x), acos(x), atan(x)
  • Estadisticas: min(a,b), max(a,b), avg(a,b,c), sum(a,b,c), factorial(n)
  • Logaritmos: ln(x), log(x), log10(x), exp(x)
  • Condicionales: if(cond, entonces, sino)
  • Busqueda: lookup(valor, umbral1, resultado1, ..., por_defecto)
  • Constantes: pi, e
  • Funciones avanzadas

    La seccion Avanzado del Builder permite anadir funcionalidades extra:

  • Resultados extra — Muestra valores adicionales calculados con sus propias formulas (ej: cuota mensual, total intereses)
  • Umbrales de resultado — Cambia el color del resultado segun rangos (ej: verde para IMC normal, rojo para sobrepeso)
  • Desglose — Muestra un desglose linea a linea del resultado
  • Grafico circular — Visualiza la distribucion de valores con segmentos personalizados
  • Visibilidad condicional — Cada campo tiene una opcion "Mostrar si" que acepta una formula; el campo se muestra cuando el resultado no es cero
  • Compartir y embeber

    Cada calculadora tiene una URL unica que contiene toda su configuracion codificada. No se necesita backend ni base de datos.

    Compartir por URL: Copia la URL directa desde la seccion "Compartir" del Builder.

    Embeber en tu web: Usa el codigo iframe generado en la seccion "Embeber widget". Puedes personalizar los valores iniciales anadiendo parametros a la URL.

    Descargar HTML: Genera un archivo HTML autocontenido que funciona sin conexion a internet.

    Valores personalizados: Anade parametros de consulta a la URL del embed con los IDs de campo para preconfigurar valores (ej: ?campo1=50&campo2=100).