Saltar para o conteúdo
Verificado

Alerta

Uma mensagem reutilizável, título, corpo, gravidade e superfície de apresentação, chamada por id de qualquer ponto do projeto.

Um Alerta é uma notificação reutilizável: um título, um corpo, uma gravidade e o local onde aparece, definido uma só vez e levantado da mesma forma a partir de qualquer Componente, fluxo de trabalho ou programa JavaScript com call_alert. Mantém uma mensagem como "perfil guardado" ou "ficheiro não encontrado" coerente em todo o lado onde é mostrada, em vez de reescrita em cada ponto de chamada.

Propriedades

alertData

progFields

Parâmetros opcionais que quem chama substitui no título ou no corpo, a forma de campo virtual padrão, referenciados dentro de alertTitle / alertBody como @field_id.

Chamar um Alerta

json
{
  "id": "1", "data": {
    "action": "call_alert",
    "name": { "prog": "5b1_alr_…", "properties": {}, "parameters": { "file_name": { "fx": "@document_name" } } },
    "enabled": true
  }, "props": {}
}

Um alerta em linha dispensa por completo o programa reutilizável, a ação alert leva alertTitle, alertBody, alertType, alertDisplay e createLog diretamente no passo do fluxo de trabalho.

Evite xu.alert nas pré-visualizações do Studio

Uma apresentação modal, toast ou browser pode surgir como um alert() nativo do navegador, bloqueante, dentro de uma sessão de pré-visualização em direto, congelando todo o JavaScript até ser dispensado. Comunique o estado através de um campo enquanto testa na pré-visualização e confirme a superfície de apresentação real numa aplicação implementada.

Exemplo prático

Escreva a mensagem uma só vez

Título, corpo, gravidade e superfície, em alertData.

Parametrize-a

Adicione um campo virtual para tudo o que quem chama deva preencher e referencie-o como @field_id dentro do corpo.

Levante-a de qualquer lado

call_alert com o id deste programa, a partir do xu-on:click de um Componente, do after_record de um programa set_data, de um passo de Lote.

Crie um nó Alerta em Programas, preencha o título, o corpo, o tipo e a apresentação no seu separador Alerta e adicione parâmetros na grelha de Campos se a mensagem precisar deles.

xml
<meta lang="json5">
{
  id: "student_saved",
  menuTitle: "Student Profile Saved"
}
</meta>

<alert lang="json5">
{
  alertDisplay: "toast",
  alertType: "success",
  alertTitle: "Profile saved",
  alertBody: "The student profile was saved through the DBS-backed student table.",
  createLog: false
}
</alert>
json
{
  "properties": { "menuType": "alert", "menuName": "File Not Found" },
  "alertData": {
    "alertType": "error", "alertDisplay": "modal",
    "alertTitle": "File not found", "alertBody": "The file \"@file_name\" could not be located."
  },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "file_name", "type": "virtual" }, "props": { "fieldType": "string" } }
  ]
}