Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Es fácil representar tarjetas adaptables dentro de la aplicación. Proporcionamos SDK para todas las plataformas comunes, así como para proporcionar una especificación detallada para crear su propio representador de tarjeta adaptable.
- Instale un SDK de representador para la plataforma de destino.
- Cree una instancia de representador , configurada con los controladores de eventos de acción, reglas y estilo de la aplicación.
- Representar una tarjeta en una interfaz de usuario nativa , con el estilo automático de la aplicación.
SDK de tarjetas adaptables
| Plataforma | Instalar | Construir | Documentación | Estado |
|---|---|---|---|---|
| JavaScript |
|
Fuente | Documentación |
|
| .NET WPF |
|
Fuente | Documentación |
|
| HTML de .NET |
|
Fuente | Documentación |
|
| Windows UWP |
|
Fuente | Documentación |
|
| WinUI 3 |
|
Fuente | Documentación |
|
| Androide |
|
Fuente | Documentación |
|
| Ios |
|
Fuente | Documentación |
|
Creación de una instancia del representador
El siguiente paso es crear una instancia de .AdaptiveCardRenderer
Enlazar eventos de acción
De forma predeterminada, las acciones se representarán como botones en la tarjeta, pero depende de la aplicación para que se comporten según lo esperado. Cada SDK tiene el equivalente de un OnAction evento que debe controlar.
-
Action.OpenUrl - abre el especificado
url. - Action.Submit: tome el resultado del envío y envíelo al origen. Cómo usted lo envía a la fuente de la tarjeta depende completamente de usted.
-
Action.ShowCard : invoca un cuadro de diálogo y representa la tarjeta secundaria en ese diálogo. Tenga en cuenta que solo tiene que controlar esto si
ShowCardActionModeestá establecido enpopup.
Representación de una tarjeta
Después de adquirir el payload de la tarjeta, simplemente llame al renderizador y pase la tarjeta. Recibirá de vuelta un objeto de interfaz de usuario nativo compuesto por los contenidos de la tarjeta. Ahora, coloque esta interfaz de usuario en algún lugar de la aplicación.
Personalización
Hay varias maneras de personalizar lo que se representa.
Configuración del Host
Un hostConfig es un objeto de configuración multiplataforma compartido que controla el estilo básico y el comportamiento de las tarjetas dentro de la aplicación. Define cosas como tamaños de fuente, espaciado entre elementos, colores, número de acciones admitidas, etc.
Estilo de plataforma nativa
La mayoría de los marcos de interfaz de usuario permiten aplicar estilo a la tarjeta representada mediante el estilo del marco de interfaz de usuario nativo. Por ejemplo, en HTML puedes especificar clases CSS para el HTML, o en XAML puedes pasar un ResourceDictionary personalizado para un control específico de la salida.
Personalización de la representación por elemento
Cada SDK permite invalidar la representación de cualquier elemento o incluso agregar compatibilidad con elementos completamente nuevos que defina. Por ejemplo, puede cambiar el Input.Date renderizador para generar su propio control personalizado mientras conserva el resto de la salida del renderizador. O bien, puede agregar compatibilidad con un elemento personalizado Rating que defina.