> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/es/portal/portal-widgets/syntax.md). # Sintaxis PSBlazor es una sintaxis personalizada basada en Blazor y las páginas Razor. Es similar a XML o XAML y proporciona un mecanismo para definir de forma declarativa una interfaz de usuario. ## Componentes Cada componente se define con un nodo XML, como ` ``` El resultado es una página con un botón definido.

### Establecer atributos Todos los componentes tienen atributos disponibles. Dentro del editor de código de la página PSBlazor, los atributos se mostrarán automáticamente para el componente que esté editando.

Establecer atributos es igual que establecer cualquier atributo XML. Este ejemplo cambia el botón al estado de peligro. ```xml ``` Una vez que guarde la herramienta, se actualizará la visualización. Con el botón en estado de peligro, verá que ahora es rojo.

### Contenido secundario Algunos componentes ofrecen la posibilidad de definir contenido secundario. Puede utilizar el nodo `` para especificar que es el caso. ```xml ``` Si no se especifica ningún otro nodo dentro del elemento secundario del componente, se asume que es contenido secundario. Lo anterior se puede simplificar así. ```xml ``` Algunos componentes proporcionan atributos de plantilla que se pueden establecer especificando varios nodos de contenido secundario con los nombres de nodo adecuados. Por ejemplo, la tabla puede tener contenido secundario formado por columnas y una plantilla de título que define cómo se muestra el título. Cuando se definen varios nodos secundarios, `` es obligatorio. ```xml My Services

``` ## PowerShell Cada herramienta o componente de PSBlazor tiene un fichero PSM1 asociado que contiene la lógica interactiva. Esta lógica puede interactuar con módulos, invocar scripts en PSU o actualizar la interfaz según los datos procesados por el script. ### Devoluciones de llamada de eventos Las devoluciones de llamada de eventos se producen cuando el usuario interactúa con un componente de PSBlazor. Esto puede incluir clics del ratón, envíos de formularios o entradas de teclado. Las devoluciones de llamada de eventos son simplemente funciones de PowerShell. Lo siguiente podría utilizarse para cuando un usuario hace clic en un botón. ```powershell function OnClick { } ``` ### Argumentos La mayoría de las devoluciones de llamada de eventos proporcionan un objeto que contiene información sobre el evento. Por ejemplo, los eventos de ratón incluyen información como las coordenadas del clic. Puede acceder a ellos proporcionando un parámetro `$EventArgs`. ```powershell function OnClick { param($EventArgs) } ``` ### Contexto Algunos componentes son contextuales. Por ejemplo, una fila de tabla o un elemento de formulario. Los valores de contexto se pasan a la devolución de llamada del evento con un parámetro `$Context`. ```powershell function OnClick { param($Context) } ``` ## Variables Las variables se pueden utilizar para actualizar los componentes de PSBlazor con datos de PowerShell. Utilice el diccionario `$Variables` para obtener y establecer variables. ```powershell $Variables["TestVariable"] = "Not Clicked" function OnClick { $Variables["TestVariable"] = "Clicked" } ``` Dentro de la sintaxis de PSBlazor, puede hacer referencia a las variables de forma similar a como lo haría en PowerShell. ```xml $TestVariable ``` También puede utilizar variables en los atributos. ```xml ``` Las variables también pueden ser objetos complejos como `PSCustomObject` o `Hashtable`. Si tienen propiedades, también puede hacer referencia a ellas en la sintaxis de PSBlazor. ```xml ``` ### Enlace de datos El enlace de datos proporciona un mecanismo para actualizar variables sin tener que llamar a un script de PowerShell. Para definir un enlace entre un atributo de un componente de PSBlazor, utilice la sintaxis `bind-{attribute}`. Por ejemplo, podría enlazar con una variable `$test` para un cuadro de entrada de esta manera. ```xml ``` En su módulo de PowerShell, podría entonces acceder a la variable desde el objeto `$Variables`. ```powershell $Message.Info($Variables["TextValue"]) ``` ### Ciclo de vida Las variables se borran cuando un usuario actualiza la página. No se almacenan en caché más allá de este ámbito. Cada usuario y página de herramienta tendrá un conjunto de variables diferente. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/es/portal/portal-widgets/syntax.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.