Selectores
Cómo elegir el desplegable correcto según el origen de los datos: enum, lista en memoria, sección pequeña o catálogo del servidor.
El selector depende de dónde salen las opciones y de si el conjunto crece sin tope.
- Es un
enum:DnzEnumDropDown. - Crece sin tope (clientes, productos, lotes, empleados):
DnzRowSelector. Es el único que encuentra cualquier registro. - Acotado y estable (estados, monedas, almacenes), según cómo lo muestres:
- solo texto, enlazando el valor (
Guid):RadzenDropDown - texto, enlazando la fila, con 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
- solo texto, enlazando el valor (
No cargues un catálogo que crece sin tope en un desplegable con límite. El registro que queda fuera no aparece ni se puede elegir, y no hay aviso. Usa DnzRowSelector.
| Componente | Datos | Búsqueda | Enlaza | Muestra |
|---|---|---|---|---|
RadzenDropDown | memoria | en el navegador | un valor (Guid) | un texto |
DnzEnumDropDown | el enum | en el navegador | el enum | un texto |
DnzDropDown | memoria | en el navegador | la fila (T : IDinaupRow) | un texto y acciones |
DnzDataGridDropDown | memoria | en el navegador | la fila (T : IDinaupRow) | columnas, color, icono |
DnzSectionDropDown | servidor, una carga | en el navegador | un Guid | un texto |
DnzRowSelector | servidor, paginado | en el servidor, 500 ms tras la última tecla | la fila (IDinaupRow) | el resultado del informe |
Pasar de un selector que enlaza un valor a uno que enlaza la fila cambia el tipo del enlace y el evento (ValueChanged pasa a SelectedRowChanged).
Para elegir una ficha en una ventana aparte en lugar de un campo, usa DnzItemPickerDialog.
DnzEnumDropDown
Las opciones salen del tipo. El texto de cada una es su [Display(Name = "...")] o, sin el atributo, el nombre del miembro.
<DnzEnumDropDown TEnum="EstadoPedidoE" @bind-Value=@estadoPedido Placeholder="Selecciona estado" />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Value | TEnum | Valor elegido. Con @bind-Value. | |
ValueChanged | EventCallback<TEnum> | Al cambiar la selección. | |
Placeholder | string | "" | Texto sin selección. |
Disabled | bool | false | Bloquea el control. |
Style | string | "width:200px" | Estilo en línea, normalmente el ancho. |
Name | string | "" | Nombre del campo para formularios y validación. |
DnzDataGridDropDown
Desplegable con buscador, columnas y acciones (limpiar, abrir ficha, añadir) sobre una lista en memoria. T implementa 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%" />Sin TextProperty, el componente muestra un aviso en rojo en lugar del desplegable. Pásalo con @nameof(Tipo.Propiedad).
| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Data | IEnumerable<T> | lista vacía | La colección. |
Value | T | Fila elegida. Con @bind-Value. | |
ValueChanged | EventCallback<T> | Al cambiar la selección. | |
TextProperty | string | Obligatorio. Propiedad que se muestra. | |
ColorProperty | string | Propiedad con el estilo de color; muestra la opción como etiqueta. | |
IconoProperty | string | Propiedad con el icono de cada opción. | |
Label | string | Etiqueta del campo. | |
Icon | string | Icono al inicio del campo. | |
IsRequired | bool | false | Marca de obligatorio si no hay valor. |
Disabled | bool | false | Bloquea el control. |
Visible | bool | true | Oculta el componente. |
Width | string | "280px" | Ancho del campo. |
Style | string | Estilo en línea adicional. | |
OpenInWindow | bool | true | Abre la ficha elegida en ventana. Necesita Client. |
Client | DinaupClientC | Cliente para abrir la ficha. | |
OnAdd | EventCallback | Al pulsar añadir, sin nada elegido. | |
OnRemove | EventCallback<T> | Al limpiar. Sin delegado, limpia el valor. | |
OnOpen | EventCallback<T> | Al pulsar abrir ficha. | |
Columns | RenderFragment | Columnas propias. | |
ValueTemplate | RenderFragment<dynamic> | Plantilla del valor en el campo. | |
IconTemplate | RenderFragment<T> | Plantilla del icono por fila. | |
ColumnWidth | string | "" | Ancho de columna por defecto. |
DnzDropDown
El mismo desplegable sobre IDinaupRow sin columnas, plantillas ni ventana. Enlaza la fila con @bind-Selected.
<DnzDropDown T="APIAlmacenesC.APIAlmacenes_RowC" Label="Almacén" TextProperty=@nameof(APIAlmacenesC.APIAlmacenes_RowC.TextoPrincipal) Data=@almacenes.Values @bind-Selected=@almacenSeleccionado />Parámetros: Data, Selected, SelectedChanged, TextProperty (obligatorio), ColorProperty, IconoProperty, Label, Icon, Style, Class, Disabled, Visible, OnAdd, OnRemove y OnOpen, con el mismo sentido que en DnzDataGridDropDown.
DnzRowSelector
Busca en un informe del servidor de 20 en 20 filas, 500 ms después de la última tecla. Recibe Client y ReportId, no Data.
<DnzRowSelector Client=@Client Label="Cliente" ReportId=@SectionsD.EntidadesD._SectionID @bind-SelectedRow=@cliente AdvancedFilter=@filtro OnAdd=@CrearCliente />AdvancedFilter limita la búsqueda a un subconjunto (clientes activos, productos de un almacén); cada condición es new FilterCondition(field, operator, value).
Selección inicial
Pasa la fila por @bind-SelectedRow. Con solo el Guid y el nombre, construye una DinaupBasicInformation(id, title). No consulta al servidor.
@code {
private IDinaupRow cliente = new DinaupBasicInformation(mov.EntidadId, mov.Entidad);
}| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Client | DinaupClientC | Obligatorio. Cliente que consulta el informe. | |
ReportId | string | GUID del informe de la búsqueda (SectionsD.EntidadesD._SectionID). | |
SelectedRow | IDinaupRow | Fila elegida. Con @bind-SelectedRow. | |
SelectedRowChanged | EventCallback<IDinaupRow> | Al cambiar la selección. | |
DefaultID | Guid | Guid.Empty | ID inicial. Sin DefaultLabel, consulta el informe. |
DefaultLabel | string | Etiqueta de DefaultID, sin consultar. | |
Label | string | Etiqueta del campo. | |
Placeholder | string | Texto sin selección. | |
Icon | string | Icono al inicio del campo. | |
IsRequired | bool | false | Marca de obligatorio si está vacío. |
Disabled | bool | false | Bloquea el control. |
AdvancedFilter | List<FilterCondition> | Condiciones que acotan la búsqueda. | |
AdminMode | bool | false | Consulta en modo administrador. |
Width | string | "280px" | Ancho del campo. |
Style | string | "flex:1" | Estilo en línea. |
Class | string | "" | Clases CSS del contenedor. |
OpenInWindow | bool | true | Abre la ficha elegida en ventana. |
OnAdd | EventCallback<Guid> | Al pulsar añadir para crear una ficha. | |
OnOpenRecord | EventCallback<IDinaupRow> | Al pulsar abrir. Sin delegado, abre la ficha en ventana. | |
FetchInterceptor | Func<string, bool, Func<Task<ReportResponse>>, Task<ReportResponse>> | Gancho de caché: reabrir el desplegable sin cambios sirve la primera página desde caché. |
Métodos por @ref: SelectByIdAsync(Guid id) resuelve la fila contra el informe; SelectAsync(...) acepta una IDinaupRow, una DinaupBasicInformation u otro DnzRowSelector; ToggleAsync() abre o cierra el desplegable.
DnzSectionDropDown
Carga una vez los registros de una sección pequeña y cerrada (estados, tipos, categorías) con Client.IAQuery_GetAsync(new IAQueryRequestParameters(sectionId, MaxItems)) y enlaza el Guid elegido. Si la sección tiene más de MaxItems, avisa de que solo muestra los primeros.
<DnzSectionDropDown Client=@Client SectionId=@SectionsD.ImpuestosD._SectionID Label="Impuesto" @bind-Value=@impuestoId />| Parámetro | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Client | DinaupClientC | Obligatorio. Cliente de la consulta. | |
SectionId | string | "" | Obligatorio. GUID de la sección. |
Label | string | "" | Etiqueta del campo. |
Value | Guid | Guid.Empty | Registro elegido. Con @bind-Value. |
ValueChanged | EventCallback<Guid> | Al cambiar la selección. | |
Disabled | bool | false | Bloquea el control. |
MaxItems | int | 500 | Registros que trae. El resto no aparece. |
Para tu propio buscador sobre una lista o un informe, usa DnzSearchInput, la caja con espera que DnzRowSelector usa por dentro.