SearchBox control (versión preliminar)
[Este artículo es documentación preliminar y está sujeto a modificaciones].
Un control utilizado para crear una experiencia de búsqueda.
Descripción
Un cuadro de búsqueda (SearchBox) proporciona un campo de entrada para buscar dentro de un sitio o aplicación a fin de encontrar elementos específicos.
Este componente de código proporciona un envoltorio alrededor del control Fluent UI SearchBox para su uso en páginas de lienzo y personalizadas.
Importante
- Esta es una característica en versión preliminar.
- Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
Propiedades importantes
| Property | Descripción |
|---|---|
SearchText |
Texto ingresado por el usuario. Refiérase a esto como la entrada para las funciones de búsqueda. |
IconName |
Nombre del icono de Fluent UI (vea Iconos de Fluent UI). |
Underlined |
Si el cuadro de búsqueda está subrayado o no. |
DisableAnimation |
Si animar o no el icono de SearchBox en foco. |
PlaceholderText |
Marcador de posición para el cuadro de búsqueda. |
Propiedades adicionales
| Property | Descripción |
|---|---|
Theme |
El objeto Theme (sin formato Json). Para obtener ayuda sobre cómo configurarlo vea Tematización. |
AccessibilityLabel |
aria-label para lectores de pantalla. |
InputEvent |
Evento para enviar al control. por ejemplo, SetFocus. |
Ejemplo
Configure el comportamiento de la búsqueda
Añada este control a su aplicación donde necesite una interfaz de búsqueda, que se combina normalmente con una galería, DetailsList o algún control que pueda mostrar un conjunto de datos.
Cree una experiencia de búsqueda utilizando las expresiones Buscar() o Filtrar(), que usan el valor de la propiedad SearchText en el SearchBox.
Search( Accounts, SearchBox.SearchText, "name" )
Limitaciones
Este componente de código solo se puede usar en aplicaciones de lienzo y páginas personalizadas.