Changes between Version 9 and Version 10 of programmersguide/architecture/web/core/semantics/Format

Timestamp:

12/07/16 13:37:11 (10 years ago)

Author:

raphael.costa

Comment:

--

programmersguide/architecture/web/core/semantics/Format

@@ -69 +69 @@
       }
   }}}
+  Outras chaves permitidas:
+    * **pattern** Permite especificar uma regex para qual o campo deve atender. Caso o valor informado pelo usuário não confere com a expressão, o campo ficará inválido até que o usuário preencha corretamente.
+    {{{
+      "alias": {
+        "key": "string",
+        "title": "Alias",
+        "pattern": "^[a-zA-Z_][a-zA-Z0-9_]*$" # Somente caracteres alfa-numericos e _ e não pode começar com numero;
+      }
+    }}}
   * **required** Define quais campos serão obrigatórios na interface
 * **form** Define como os elementos serão desenhados na interface, bem como a ordem deles. Este bloco deve ser obrigatoriamente uma cadeia (array) de elementos. Podemos definir das seguintes maneiras:
@@ -93 +102 @@
   }}}
 
+  Cada objeto refere-se a um campo. Podemos também acrescentar novas chaves:
+    * **onChange** Define que toda iteração com o campo na interface será disparado uma função. Por padrão, o framework injeta dois parâmetros: **form** e **modelValue** que define a chave do campo e o valor respectivamente. **Lembre-se** que o TerraMA² disponibilizará funções disponíveis em [TODO]. Use o seguinte prefixo: {{{"onChange": "SemanticsHelpers.methodo(parametros)"}}}
+    {{{
+    "form": [
+      ... campos,
+      {
+        "key": "alias",
+        "htmlClasses": "col-md-6",
+        "onChange": "SemanticsHelpers.only(form.key, modelValue)" # Esse metodo pega o regex definido no campo e limita para somente permitir os valores que condizem com a regex. Qualquer outro valor será removido: "meuAlia's" => "meuAlias"
+      },
+    ] 
+    }}}
+
+    * **notitle** Define se deve esconder o titulo do campo na interface. Default: **false**
+    * **validationMessage** Define mensagens de erros customizadas. Por exemplo, utilizando o **pattern** coloca código **202**. Logo se desejar alterar a mensagem padrão, faça o seguinte:
+    {{{
+    "form": [
+      ... campos,
+      {
+        "key": "alias",
+        "htmlClasses": "col-md-6",
+        "validationMessage": {
+           "202": "Invalid alias value. Only alpha-numeric chars and _ are allowed."
+        }
+      },
+    ] 
+    }}}
+
 
 === Criando uma nova semantica ===