Skip to Content
Componentes

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.

  1. Es un enum: DnzEnumDropDown.
  2. Crece sin tope (clientes, productos, lotes, empleados): DnzRowSelector. Es el único que encuentra cualquier registro.
  3. 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

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.

ComponenteDatosBúsquedaEnlazaMuestra
RadzenDropDownmemoriaen el navegadorun valor (Guid)un texto
DnzEnumDropDownel enumen el navegadorel enumun texto
DnzDropDownmemoriaen el navegadorla fila (T : IDinaupRow)un texto y acciones
DnzDataGridDropDownmemoriaen el navegadorla fila (T : IDinaupRow)columnas, color, icono
DnzSectionDropDownservidor, una cargaen el navegadorun Guidun texto
DnzRowSelectorservidor, paginadoen el servidor, 500 ms tras la última teclala 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.

Un DnzEnumDropDown con un estado elegido, un DnzRowSelector con el cliente elegido y sus botones de abrir ficha y quitar, y otro vacío con el + de crear

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ámetroTipoPor defectoQué hace
ValueTEnumValor elegido. Con @bind-Value.
ValueChangedEventCallback<TEnum>Al cambiar la selección.
Placeholderstring""Texto sin selección.
DisabledboolfalseBloquea el control.
Stylestring"width:200px"Estilo en línea, normalmente el ancho.
Namestring""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ámetroTipoPor defectoQué hace
DataIEnumerable<T>lista vacíaLa colección.
ValueTFila elegida. Con @bind-Value.
ValueChangedEventCallback<T>Al cambiar la selección.
TextPropertystringObligatorio. Propiedad que se muestra.
ColorPropertystringPropiedad con el estilo de color; muestra la opción como etiqueta.
IconoPropertystringPropiedad con el icono de cada opción.
LabelstringEtiqueta del campo.
IconstringIcono al inicio del campo.
IsRequiredboolfalseMarca de obligatorio si no hay valor.
DisabledboolfalseBloquea el control.
VisiblebooltrueOculta el componente.
Widthstring"280px"Ancho del campo.
StylestringEstilo en línea adicional.
OpenInWindowbooltrueAbre la ficha elegida en ventana. Necesita Client.
ClientDinaupClientCCliente para abrir la ficha.
OnAddEventCallbackAl pulsar añadir, sin nada elegido.
OnRemoveEventCallback<T>Al limpiar. Sin delegado, limpia el valor.
OnOpenEventCallback<T>Al pulsar abrir ficha.
ColumnsRenderFragmentColumnas propias.
ValueTemplateRenderFragment<dynamic>Plantilla del valor en el campo.
IconTemplateRenderFragment<T>Plantilla del icono por fila.
ColumnWidthstring""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ámetroTipoPor defectoQué hace
ClientDinaupClientCObligatorio. Cliente que consulta el informe.
ReportIdstringGUID del informe de la búsqueda (SectionsD.EntidadesD._SectionID).
SelectedRowIDinaupRowFila elegida. Con @bind-SelectedRow.
SelectedRowChangedEventCallback<IDinaupRow>Al cambiar la selección.
DefaultIDGuidGuid.EmptyID inicial. Sin DefaultLabel, consulta el informe.
DefaultLabelstringEtiqueta de DefaultID, sin consultar.
LabelstringEtiqueta del campo.
PlaceholderstringTexto sin selección.
IconstringIcono al inicio del campo.
IsRequiredboolfalseMarca de obligatorio si está vacío.
DisabledboolfalseBloquea el control.
AdvancedFilterList<FilterCondition>Condiciones que acotan la búsqueda.
AdminModeboolfalseConsulta en modo administrador.
Widthstring"280px"Ancho del campo.
Stylestring"flex:1"Estilo en línea.
Classstring""Clases CSS del contenedor.
OpenInWindowbooltrueAbre la ficha elegida en ventana.
OnAddEventCallback<Guid>Al pulsar añadir para crear una ficha.
OnOpenRecordEventCallback<IDinaupRow>Al pulsar abrir. Sin delegado, abre la ficha en ventana.
FetchInterceptorFunc<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ámetroTipoPor defectoQué hace
ClientDinaupClientCObligatorio. Cliente de la consulta.
SectionIdstring""Obligatorio. GUID de la sección.
Labelstring""Etiqueta del campo.
ValueGuidGuid.EmptyRegistro elegido. Con @bind-Value.
ValueChangedEventCallback<Guid>Al cambiar la selección.
DisabledboolfalseBloquea el control.
MaxItemsint500Registros 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.

En esta página