CoFormRenderer

This content is not available in your language yet.

CoFormRenderer toma el objeto que devuelve useForm() y renderiza todos los campos automáticamente. Para casos típicos no necesitas escribir un solo <co-input> a mano.

Uso básico

<script setup>
import { useForm, CoFormRenderer } from '@prolibu-suite/cobalt-form-vue';

const form = useForm(() => ({
  schema: { modelSchema: userSchema, locale: 'es' },
}));
</script>

<template>
  <CoFormRenderer :form="form" />
</template>

Props

Prop	Tipo	Default	Descripción
`form`	`UseFormReturn`	—	Objeto retornado por `useForm()`. Requerido.
`layout`	`'grid' \| 'stack'`	`'grid'`	Layout de los campos
`columns`	`number`	`2`	Nº de columnas del grid (`stack` fuerza 1)
`disabled`	`boolean`	`false`	Deshabilita todos los campos
`excludeFields`	`string[]`	`[]`	Nombres de campos a NO renderizar (siguen validando)
`fieldComponents`	`Record<string, Component>`	—	Override de renderers (ver Custom fields)
`refResolver`	`RefResolver`	—	Callback para campos `ref` (ver Ref fields)

Eventos

Evento	Payload	Cuándo
`submit`	`{ values: Record<string, any> }`	Submit exitoso (válido)
`invalid`	`Record<string, string[]>` (el mapa de errores)	Submit con errores
`change`	`{ name: string; value: any }`	Cada cambio de campo

<template>
  <CoFormRenderer
    :form="form"
    @submit="onSubmit"
    @invalid="onInvalid"
    @change="onChange"
  />
</template>

<script setup>
const onSubmit = ({ values }) => {
  console.log('válido, valores:', values);
};
const onInvalid = (errors) => {
  console.warn('inválido:', errors);
};
const onChange = ({ name, value }) => {
  console.log(`${name} →`, value);
};
</script>

Layout

Grid (default)

CSS Grid responsive de columns columnas (default 2). Cada campo ocupa 1 columna; si el field schema tiene full: true, ocupa la fila completa. Ajustá el número de columnas con la prop columns.

const schema = {
  firstName: { type: 'String' },              // 1 columna
  lastName:  { type: 'String' },              // 1 columna (al lado)
  bio:       { type: 'String', full: true },  // fila completa
};

Stack

Una columna, un campo por fila. Útil para forms angostos (drawers, modales).

<CoFormRenderer :form="form" layout="stack" />

Slots

CoFormRenderer expone slots para personalizar zonas específicas.

`header` y `footer`

<CoFormRenderer :form="form">
  <template #header>
    <h2>Crear usuario</h2>
    <p>Completa los datos para registrarte.</p>
  </template>

  <template #footer>
    <div class="actions">
      <co-button label="Cancelar" variant="ghost" @click="onCancel" />
      <co-button
        label="Guardar"
        variant="primary"
        :disabled="!form.isValid.value"
        @click="form.submit"
      />
    </div>
  </template>
</CoFormRenderer>

Si no defines #footer, se renderiza un botón “Enviar” por defecto.

`field:<name>` — override de un campo específico

Para cambiar cómo se renderiza UN campo sin tocar los demás:

<CoFormRenderer :form="form">
  <template #field:password="{ field, value, setValue, errors }">
    <co-input
      :label="field.label"
      type="password"
      :value="value"
      :status="errors.length ? 'error' : undefined"
      :helper-text="errors[0] || 'Mín. 8 caracteres'"
      @co-input="(e) => setValue(e.detail.value)"
    >
      <button slot="action" @click="togglePasswordVisibility">👁</button>
    </co-input>
  </template>
</CoFormRenderer>

El slot recibe:

Variable	Tipo	Descripción
`field`	`FieldDescriptor`	Metadata del campo (name, label, kind, etc.)
`value`	`any`	Valor actual
`errors`	`string[]`	Errores del campo (vacío si aún no está touched)
`setValue`	`(v) => void`	Setter
`touch`	`() => void`	Marca el campo como touched

Excluir campos sin sacarlos del schema

A veces quieres validar un campo (porque la API lo requiere) pero no mostrarlo:

<CoFormRenderer
  :form="form"
  :exclude-fields="['internalId', 'createdAt']"
/>

Los campos excluidos:

NO se renderizan en la UI
SÍ participan de validación
SÍ están en form.values.value (con su default)

Diferente a poner hidden: true en el schema: ese marca a nivel schema; excludeFields es por instancia de renderer.

Pasar disabled globalmente

<!-- form completo deshabilitado durante un loading -->
<CoFormRenderer :form="form" :disabled="isLoading" />

Tiene precedencia sobre el disabled individual de cada campo en el schema.

Ejemplo completo

<script setup>
import { useForm, CoFormRenderer } from '@prolibu-suite/cobalt-form-vue';
import { ref } from 'vue';
import { useToast } from '@/composables/useToast';

const toast = useToast();
const isSaving = ref(false);

const schema = {
  firstName: { type: 'String', required: true, minLength: 2, label: 'Nombre' },
  lastName:  { type: 'String', required: true, minLength: 2, label: 'Apellido' },
  email:     { type: 'String', required: true, format: 'email', label: 'Email' },
  role:      {
    type: 'String',
    enum: ['admin', 'user', 'viewer'],
    default: 'user',
    label: 'Rol',
  },
  bio: {
    type: 'String',
    uiCom: 'TextArea',
    maxLength: 500,
    full: true,
    label: 'Biografía',
  },
};

const form = useForm(() => ({
  schema: { modelSchema: schema, locale: 'es' },
}));

// El evento @submit del renderer solo dispara con valores válidos
async function onSubmit({ values }) {
  isSaving.value = true;
  try {
    await api.createUser(values);
    toast.success('Usuario creado');
  } finally {
    isSaving.value = false;
  }
}
</script>

<template>
  <CoFormRenderer
    :form="form"
    layout="grid"
    @submit="onSubmit"
    @invalid="() => toast.error('Revisa los errores marcados')"
  >
    <template #header>
      <h2>Nuevo usuario</h2>
    </template>

    <template #footer="{ submit }">
      <co-button label="Cancelar" variant="ghost" @click="$emit('cancel')" />
      <co-button
        label="Crear usuario"
        variant="primary"
        :disabled="!form.isValid.value || isSaving"
        @click="submit"
      />
    </template>
  </CoFormRenderer>
</template>