Selectores

Casi todo lo que el usuario elige en Dinaup pasa por uno de estos componentes. Cinco parecen el mismo desplegable, pero se diferencian en el origen de los datos. Antes de elegir uno, comprueba si el conjunto cabe siempre en memoria o crece sin tope.

Árbol de decisión

1. Es un enum: DnzEnumDropDown.
2. Crece sin tope (clientes, productos, lotes, empleados): DnzRowSelector.
3. Acotado y estable, según cómo lo veas:
   • solo texto, con el valor (Guid) enlazado: RadzenDropDown
   • texto, con la fila enlazada y botones de crear, quitar y abrir ficha: DnzDropDown
   • columnas, color e icono por fila: DnzDataGridDropDown
   • los registros de una sección pequeña, sin cargarlos tú: DnzSectionDropDown
4. DnzRowSelector en una lista con el nombre ya en memoria: SelectedRow precargado o DefaultLabel, nunca DefaultID solo.

Los selectores comparados

"Cliente" filtra en el navegador sobre lo cargado: es instantáneo y solo encuentra lo cargado. "Servidor" envía cada búsqueda a la API: encuentra todo y cuesta un viaje de red.

DnzEnumDropDown

Desplegable directo sobre un enum de C#. No recibe opciones: las obtiene del tipo, y usa el [Display(Name = "...")] de cada valor como texto visible si lo tiene.

<DnzEnumDropDown TEnum="EstadoPedidoE" @bind-Value=@estadoPedido Placeholder="Selecciona estado" />

@code {
    EstadoPedidoE estadoPedido = EstadoPedidoE.Pendiente;
}

Acepta atributos extra que se pasan al elemento raíz.

DnzDataGridDropDown

Selector para una lista en memoria, montado sobre RadzenDropDownDataGrid. Recibe la colección por Data y la propiedad a mostrar con TextProperty, y monta un desplegable con buscador, columnas y acciones (limpiar, abrir ficha, añadir). T tiene que implementar IDinaupRow.

@using static DemoUp.MyDinaup.Reports.FuncionalidadD

<DnzDataGridDropDown T="APIImpuestosC.APIImpuestos_RowC" Label="Impuestos" IsRequired=true TextProperty=@nameof(APIImpuestosC.APIImpuestos_RowC.TextoPrincipal) Data=@impuestos.Values @bind-Value=@impuestoSeleccionado @bind-Value:after=@Recalcular Style="width:100%" />

Con color por estado (etiqueta automática) e icono por fila:

<DnzDataGridDropDown T="EstadoPedidoRow" Label="Estado" TextProperty=@nameof(EstadoPedidoRow.Nombre) ColorProperty=@nameof(EstadoPedidoRow.Color) IconoProperty=@nameof(EstadoPedidoRow.Icono) Data=@estados @bind-Value=@estado />

Acepta atributos extra que se pasan al elemento raíz.

DnzRowSelector

No recibe Data: recibe un ReportId (el informe de la sección) y un Client, y busca en el servidor de 20 en 20 filas, con una espera de 500 ms tras la última tecla. Para catálogos grandes (clientes, productos, proveedores) donde cargar todo en memoria no tiene sentido.

<DnzRowSelector Client=@Client Label="Cliente" ReportId=@SectionsD.EntidadesD._SectionID @bind-SelectedRow=@cliente AdvancedFilter=@filtro OnAdd=@CrearCliente />

Hay tres formas de indicar una selección inicial al cargar; dos no consultan al servidor y una sí:

<DnzRowSelector Client=@Client Label="Cliente" ReportId=@SectionsD.EntidadesD._SectionID @bind-SelectedRow=@cliente />

@code {
    private IDinaupRow cliente = new DinaupBasicInformation(mov.EntidadId, mov.Entidad);
}

<DnzRowSelector Client=@Client Label="Cliente" ReportId=@SectionsD.EntidadesD._SectionID DefaultID=@clienteId DefaultLabel=@clienteNombre @bind-SelectedRow=@cliente />

<DnzRowSelector Client=@Client Label="Cliente" ReportId=@SectionsD.EntidadesD._SectionID DefaultID=@clienteId @bind-SelectedRow=@cliente />

Acepta atributos extra que se pasan al elemento raíz.

DnzSectionDropDown

Desplegable con los registros de una sección, cargados una vez con Client.IAQuery_GetAsync(new IAQueryRequestParameters(sectionId, MaxItems)). Para secciones pequeñas y cerradas (estados, tipos, categorías) donde el usuario espera abrir y elegir. Enlaza el Guid del registro. El filtro busca entre lo cargado; si la sección tiene más registros que MaxItems, avisa de que solo se muestran los primeros.

<DnzSectionDropDown Client=@Client SectionId=@SectionsD.ImpuestosD._SectionID Label="Impuesto" @bind-Value=@impuestoId />

@code {
    private Guid impuestoId;
}

DnzDropDown

El mismo desplegable sobre IDinaupRow que DnzDataGridDropDown, sin columnas, plantillas ni apertura de ficha en ventana. Enlaza la fila con @bind-Selected y trae los botones de crear, quitar y abrir ficha. TextProperty es obligatorio.

@using static DemoUp.MyDinaup.Reports.FuncionalidadD

<DnzDropDown T="APIAlmacenesC.APIAlmacenes_RowC" Label="Almacén" TextProperty=@nameof(APIAlmacenesC.APIAlmacenes_RowC.TextoPrincipal) Data=@almacenes.Values @bind-Selected=@almacenSeleccionado />

Acepta atributos extra que se pasan al elemento raíz.

DnzSearchInput

Caja de búsqueda con icono de lupa que espera 500 ms tras la última tecla (Dinaup.Debouncer). No es un selector: es la pieza que dispara el filtro sin lanzar una consulta por cada tecla. La usa DnzRowSelector internamente, y sirve para tu propio buscador sobre una lista o un informe.

<DnzSearchInput Placeholder="Buscar producto" BounceValueChanged=@OnBuscar Class="w-100" />

@code {
    async Task OnBuscar(string texto)
    {
        await CargarResultados(texto);
    }
}

Los atributos extra (autofocus, maxlength) van al <input>.

DnzItemPickerDialog

Ventana de selección sobre un informe, en lugar de un desplegable embebido. Se abre con OpenAsync y devuelve la fila elegida, o null si el usuario cierra.

@inject DialogService DialogService

@code {
    async Task ElegirCliente()
    {
        var fila = await DnzItemPickerDialog.OpenAsync(DialogService, Client, SectionsD.EntidadesD._SectionID);
        if (fila.IsNotNull()) clienteSeleccionado = fila;
    }
}

El método estático OpenAsync(DialogService, DinaupClientC, string reportId) abre el diálogo (ancho min(95%, 1806px), alto 600 px, redimensionable y arrastrable) con un DnzReportView de 50 filas por página y devuelve un DinaupDynamicRowDTO, o null si se cancela.

Relacionado

• DinaZen
• Componentes
• Tablas e informes
• Informes de Flex
• Cliente Dinaup
• MyDinaup
• Guías de estilo C# y Blazor