Cuadro combinado: especificación de interacción
Define estados, disparadores, acciones del usuario, comportamiento responsivo, reglas de contenido y estados de fallo para el patrón de cuadro combinado. Establece límites de adopción y evidencia observable de fallos mientras mantiene configurables los límites específicos del entorno.
Estado del paquete: contexto de referencia listo para revisión humana. El contrato y los escenarios de prueba están completos, pero no se afirma que una implementación adoptante los haya superado.
Decisión
Para el Cuadro combinado, adoptar un contrato reutilizable de estado e interacción usando semánticas nativas cuando estén disponibles. Definir un recorrido de usuario determinista con estado visible, elecciones reversibles cuando sea posible, entrada preservada y recuperación accesible. Este paquete es un contrato de referencia: el equipo adoptante debe elegir límites numéricos, proveedores, jurisdicciones y responsables operativos basándose en la evidencia de su propio entorno.
Alcance
- Los actores, entradas, salidas, estados, versiones de política o esquema y resultados visibles externamente descritos por este bloque UX.
- Interfaces primarias y alternativas, trabajo en segundo plano, cachés, integraciones, rutas de soporte y evidencia que puedan ejercer el mismo límite.
- Configuración específica de adopción, despliegue, recuperación y responsabilidades de verificación necesarias para aplicar la referencia de forma segura.
Fuera de este bloque
- Elegir un proveedor universal, framework, jurisdicción, umbral numérico, periodo de retención u objetivo de nivel de servicio para todos los adoptantes.
- Afirmar que los escenarios empaquetados se han ejecutado contra una implementación descendente o que esta referencia otorga certificación legal, de seguridad o accesibilidad.
Contrato
- Definir estados de disparo, abierto o activo, cargando, éxito, vacío, inválido, error, deshabilitado y de cierre que el patrón puede adoptar.
- Especificar entrada por teclado, entrada y retorno de foco, nombre accesible, anuncios, comportamiento del puntero y comportamiento del objetivo táctil en conjunto.
- Hacer explícitos los efectos destructivos, irreversibles o externos y prevenir activaciones duplicadas mientras el trabajo está pendiente.
- Mantener la jerarquía de contenido y acciones usables en anchos estrechos, alto zoom, expansión de texto, colores forzados y movimiento reducido.
- Mostrar progreso solo mientras el trabajo esté realmente pendiente y prevenir activaciones duplicadas sin ocultar la intención comprometida del usuario.
- Usar mensajes simples y específicos de acción que distingan validación, permiso, conectividad, conflicto y fallo terminal.
- Implementar el patrón de cuadro combinado editable o solo selección adecuado con un nombre accesible, estado expandido, relación controlada de ventana emergente y comportamiento de descendiente activo o foco.
- Soportar las interacciones esperadas con flechas, escritura, Escape, Enter, Tab, composición, tacto y lector de pantalla distinguiendo valores resaltados, seleccionados y comprometidos.
Guía de implementación
- Prototipar los caminos más largos, vacíos, lentos, sin conexión, denegados y con tecnología asistiva antes de fijar el diseño del camino feliz.
- Modelar entradas, salidas, actores, estados, invariantes, efectos secundarios y evidencia del Cuadro combinado antes de seleccionar detalles de framework o proveedor.
- Almacenar la versión aplicable del contrato o política del Cuadro combinado con el estado material para que migraciones, reproducción y decisiones de soporte sean atribuibles.
- Introducir el camino detrás de un despliegue controlado, comparar resultados esperados y observados, y mantener una ruta de recuperación probada hasta completar la evidencia de adopción.
Manejo de fallos y salvaguardas
- En acción fallida, preservar la entrada y foco relevantes, anunciar el resultado y devolver el componente a un estado con una ruta de recuperación segura.
- El estado inválido o contradictorio del Cuadro combinado es rechazado o puesto en cuarentena; la implementación nunca adivina un valor que amplíe autoridad o duplique un efecto.
- Los reintentos están limitados y usan identidad durable; tras agotarse, el trabajo alcanza un estado terminal inspeccionable con un responsable accountable.
Verificación y operaciones
- Completar el recorrido con teclado, tacto, lector de pantalla, vista estrecha, red con retraso y un error recuperable del servidor.
- Monitorear éxito, denegación, fallo de validación, fallo de dependencia, agotamiento de reintentos y recuperación del Cuadro combinado por versión de contrato sin dimensiones sensibles de carga útil.
- Reejecutar casos positivos y negativos emparejados tras cambios en política, esquema, dependencia, migración o límites y preservar la evidencia resultante.
Suposiciones de adopción
- Los nombres y valores en el ejemplo son un caso concreto, no valores predeterminados universales; los adoptantes los reemplazan mediante evidencia documentada y propiedad.
- El sistema adoptante puede proveer identidad autenticada, versiones durables de operación o registro, telemetría limitada y una ruta controlada para cambios.
Los ejemplos con apariencia ejecutable en este paquete son casos y contratos de aceptación. Ejecute el validador de colección para verificar estructura y metadatos, luego traduzca y ejecute los escenarios en el repositorio destino antes de registrar evidencia de implementación.