@sankhyalabs/sankhyablocks-docs 8.16.0-dev.4 → 8.16.0-dev.41
Sign up to get free protection for your applications and to get access to all the features.
- package/components/snk-attach/readme.md +1 -1
- package/components/snk-crud/readme.md +12 -7
- package/components/snk-crud/subcomponents/readme.md +4 -1
- package/components/snk-crud/subcomponents/snk-detail-view/readme.md +1 -1
- package/components/snk-data-unit/readme.md +15 -14
- package/components/snk-filter-bar/readme.md +13 -12
- package/components/snk-form-config/readme.md +6 -5
- package/components/snk-grid/readme.md +1 -0
- package/components/snk-simple-crud/readme.md +4 -2
- package/components/snk-taskbar/readme.md +5 -3
- package/package.json +1 -1
@@ -42,8 +42,8 @@
|
|
42
42
|
graph TD;
|
43
43
|
snk-attach --> snk-simple-bar
|
44
44
|
snk-attach --> snk-simple-crud
|
45
|
-
snk-simple-crud --> snk-data-unit
|
46
45
|
snk-simple-crud --> snk-taskbar
|
46
|
+
snk-simple-crud --> snk-data-unit
|
47
47
|
snk-simple-crud --> snk-form-config
|
48
48
|
snk-simple-crud --> snk-configurator
|
49
49
|
snk-simple-crud --> snk-grid-config
|
@@ -14,15 +14,19 @@
|
|
14
14
|
| `autoLoad` | `auto-load` | Define se a carga dos dados será feita assim que o componente for carregado. | `boolean` | `undefined` |
|
15
15
|
| `configName` | `config-name` | Usado para salvar as configurações dos blocos de construção. | `string` | `undefined` |
|
16
16
|
| `disablePersonalizedFilter` | `disable-personalized-filter` | Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados). | `boolean` | `undefined` |
|
17
|
+
| `domainMessagesBuilder` | `domain-messages-builder` | Define a chave customizada para sobrescrever as mensagens (Não pegando pela entidade) | `string` | `undefined` |
|
18
|
+
| `enableGridInsert` | `enable-grid-insert` | Ativa inserção de registros no modo grade. | `boolean` | `false` |
|
17
19
|
| `filterBarLegacyConfigName` | `filter-bar-legacy-config-name` | Chave da configuração legado da barra de filtros. | `string` | `undefined` |
|
18
20
|
| `filterBarTitle` | `filter-bar-title` | Título que será apresentado na barra de filtros | `string` | `undefined` |
|
19
21
|
| `formLegacyConfigName` | `form-legacy-config-name` | Chave da configuração legado do formulário. | `string` | `undefined` |
|
20
22
|
| `gridLegacyConfigName` | `grid-legacy-config-name` | Chave da configuração legado da grade. | `string` | `undefined` |
|
23
|
+
| `ignoreReadOnlyFormFields` | `ignore-read-only-form-fields` | Ignora os campos "somente leitura" no modo de inserção. | `boolean` | `undefined` |
|
21
24
|
| `messagesBuilder` | -- | Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção. | `SnkMessageBuilder` | `undefined` |
|
22
25
|
| `multipleSelection` | `multiple-selection` | Determina se pode haver mais de uma linha selecionada na grade. | `boolean` | `true` |
|
23
26
|
| `presentationMode` | `presentation-mode` | Altera o modo de apresentação dos botões do snk-taskbar. | `PresentationMode.PRIMARY \| PresentationMode.SECONDARY \| PresentationMode.SINGLE_TASKBAR` | `PresentationMode.PRIMARY` |
|
24
27
|
| `recordsValidator` | -- | Validador responsável por checar a integridade das informações do registro. | `IRecordValidator` | `undefined` |
|
25
28
|
| `selectionToastConfig` | -- | Configuração da seleção de grade no toast. | `ISelectionToastConfig` | `undefined` |
|
29
|
+
| `setCustomFormTitle` | -- | Define uma função para configurar um título cusotmizado no modo formulário. | `() => string` | `undefined` |
|
26
30
|
| `showActionButtons` | `show-action-buttons` | Usado para exibir os botões de ação do snk-configurator | `boolean` | `false` |
|
27
31
|
| `statusResolver` | -- | Configuração do valor da coluna de status. Exemplo: { "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } } | `((data: object) => string) \| IStatusResolver` | `undefined` |
|
28
32
|
| `taskbarManager` | -- | Gerenciador das barras de tarefas. É possível determinar botões específicos ou mesmo gerenciar o estado dos botões. | `TaskbarManager` | `undefined` |
|
@@ -31,12 +35,13 @@
|
|
31
35
|
|
32
36
|
## Events
|
33
37
|
|
34
|
-
| Event | Description | Type
|
35
|
-
| -------------------- | ------------------------------------------------------------------------------- |
|
36
|
-
| `actionClick` | Emitido pela taskbar sempre que houver click de botão ou ação. | `CustomEvent<string>`
|
37
|
-
| `configuratorCancel` | Emitido quando cancela o salvamento da configuração no configurator do CRUD. | `CustomEvent<any>`
|
38
|
-
| `configuratorSave` | Emitido quando salva a configuração no configurator do CRUD. | `CustomEvent<any>`
|
39
|
-
| `formItemsReady` | Responsável por notificar quando ocorrer a renderização de itens do formulário. | `CustomEvent<HTMLElement[]>`
|
38
|
+
| Event | Description | Type |
|
39
|
+
| -------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
|
40
|
+
| `actionClick` | Emitido pela taskbar sempre que houver click de botão ou ação. | `CustomEvent<string>` |
|
41
|
+
| `configuratorCancel` | Emitido quando cancela o salvamento da configuração no configurator do CRUD. | `CustomEvent<any>` |
|
42
|
+
| `configuratorSave` | Emitido quando salva a configuração no configurator do CRUD. | `CustomEvent<any>` |
|
43
|
+
| `formItemsReady` | Responsável por notificar quando ocorrer a renderização de itens do formulário. | `CustomEvent<HTMLElement[]>` |
|
44
|
+
| `viewModeChanged` | | `CustomEvent<VIEW_MODE.ATTACHMENT \| VIEW_MODE.FORM \| VIEW_MODE.GRID>` |
|
40
45
|
|
41
46
|
|
42
47
|
## Methods
|
@@ -207,8 +212,8 @@ graph TD;
|
|
207
212
|
snk-detail-view --> taskbar-actions-button
|
208
213
|
snk-attach --> snk-simple-bar
|
209
214
|
snk-attach --> snk-simple-crud
|
210
|
-
snk-simple-crud --> snk-data-unit
|
211
215
|
snk-simple-crud --> snk-taskbar
|
216
|
+
snk-simple-crud --> snk-data-unit
|
212
217
|
snk-simple-crud --> snk-form-config
|
213
218
|
snk-simple-crud --> snk-configurator
|
214
219
|
snk-simple-crud --> snk-grid-config
|
@@ -15,8 +15,11 @@
|
|
15
15
|
| `dataState` | -- | Representa o estado do dataUnit master. | `DataState` | `undefined` |
|
16
16
|
| `dataUnit` | -- | Instância do DataUnit master. | `DataUnit` | `undefined` |
|
17
17
|
| `detailTaskbarCustomContainerId` | `detail-taskbar-custom-container-id` | Define o identificador do container de elementos customizados da Taskbar da aba de detalhes. | `string` | `undefined` |
|
18
|
+
| `enableGridInsert` | `enable-grid-insert` | Ativa inserção de registros no modo grade. | `boolean` | `false` |
|
18
19
|
| `entityPath` | `entity-path` | Determina todo o caminho de entidades. | `string` | `undefined` |
|
19
20
|
| `formLegacyConfigName` | `form-legacy-config-name` | Chave da configuração legado do formulário. | `string` | `undefined` |
|
21
|
+
| `getCustomTitle` | -- | Fornece uma função para obter um título customizado do formulário. | `() => string` | `undefined` |
|
22
|
+
| `ignoreReadOnlyFormFields` | `ignore-read-only-form-fields` | Ignora os campos "somente leitura" no modo de inserção. | `boolean` | `undefined` |
|
20
23
|
| `masterFormConfig` | -- | Configuração do formulário master. | `IFormConfig` | `undefined` |
|
21
24
|
| `messagesBuilder` | -- | Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção. | `SnkMessageBuilder` | `undefined` |
|
22
25
|
| `presentationMode` | `presentation-mode` | Altera o modo de apresentação dos botões do snk-taskbar. | `PresentationMode.PRIMARY \| PresentationMode.SECONDARY \| PresentationMode.SINGLE_TASKBAR` | `undefined` |
|
@@ -162,8 +165,8 @@ graph TD;
|
|
162
165
|
snk-grid-config --> snk-select-box
|
163
166
|
snk-attach --> snk-simple-bar
|
164
167
|
snk-attach --> snk-simple-crud
|
165
|
-
snk-simple-crud --> snk-data-unit
|
166
168
|
snk-simple-crud --> snk-taskbar
|
169
|
+
snk-simple-crud --> snk-data-unit
|
167
170
|
snk-simple-crud --> snk-form-config
|
168
171
|
snk-simple-crud --> snk-configurator
|
169
172
|
snk-simple-crud --> snk-grid-config
|
@@ -142,8 +142,8 @@ graph TD;
|
|
142
142
|
snk-form-view --> snk-form-summary
|
143
143
|
snk-attach --> snk-simple-bar
|
144
144
|
snk-attach --> snk-simple-crud
|
145
|
-
snk-simple-crud --> snk-data-unit
|
146
145
|
snk-simple-crud --> snk-taskbar
|
146
|
+
snk-simple-crud --> snk-data-unit
|
147
147
|
snk-simple-crud --> snk-form-config
|
148
148
|
snk-simple-crud --> snk-configurator
|
149
149
|
snk-simple-crud --> snk-grid-config
|
@@ -7,20 +7,21 @@
|
|
7
7
|
|
8
8
|
## Properties
|
9
9
|
|
10
|
-
| Property
|
11
|
-
|
|
12
|
-
| `afterSave`
|
13
|
-
| `beforeSave`
|
14
|
-
| `configName`
|
15
|
-
| `dataState`
|
16
|
-
| `dataUnit`
|
17
|
-
| `dataUnitName`
|
18
|
-
| `
|
19
|
-
| `
|
20
|
-
| `
|
21
|
-
| `
|
22
|
-
| `
|
23
|
-
| `
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
11
|
+
| ----------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ----------- |
|
12
|
+
| `afterSave` | -- | Executado após a ação de salvar. | `(dataUnit: DataUnit) => void` | `undefined` |
|
13
|
+
| `beforeSave` | -- | Executado imediatamente antes da ação de salvar as alterações. Útil no caso de validações por exemplo. Caso retorne "false" (ou a promessa se resolva como false), cancela a ação. | `(dataUnit: DataUnit) => boolean \| Promise<boolean>` | `undefined` |
|
14
|
+
| `configName` | `config-name` | Usado para obter configuração de metadados. | `string` | `undefined` |
|
15
|
+
| `dataState` | -- | Controla o estado atual dos dados. | `DataState` | `undefined` |
|
16
|
+
| `dataUnit` | -- | Uma vez instanciado, pode-se obter o dataUnit por esta propriedade. | `DataUnit` | `undefined` |
|
17
|
+
| `dataUnitName` | `data-unit-name` | Usado para criar o dataUnit uma única vez. Se omitido, será usado o próprio nome da entidade. | `string` | `undefined` |
|
18
|
+
| `domainMessagesBuilder` | `domain-messages-builder` | Define a chave customizada para sobrescrever as mensagens (Não pegando pela entidade) | `string` | `undefined` |
|
19
|
+
| `entityName` | `entity-name` | Determina qual a entidade que representa os dados em questão. | `string` | `undefined` |
|
20
|
+
| `ignoreSaveMessage` | `ignore-save-message` | Responsável por evitar a mensagem de sucesso ao salvar. | `boolean` | `undefined` |
|
21
|
+
| `messagesBuilder` | -- | Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção. | `SnkMessageBuilder` | `undefined` |
|
22
|
+
| `pageSize` | `page-size` | Determina quantas linhas são retornadas por página. | `number` | `150` |
|
23
|
+
| `resourceID` | `resource-i-d` | Identificador de recursos como configurações e acesso. | `string` | `undefined` |
|
24
|
+
| `useCancelConfirm` | `use-cancel-confirm` | Determina se será usado mensagem de confirmação padrão na tentativa de cancelar a edição. | `boolean` | `true` |
|
24
25
|
|
25
26
|
|
26
27
|
## Events
|
@@ -7,18 +7,19 @@
|
|
7
7
|
|
8
8
|
## Properties
|
9
9
|
|
10
|
-
| Property | Attribute | Description | Type
|
11
|
-
| --------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
12
|
-
| `autoLoad` | `auto-load` | Define se a carga dos dados será feita assim que o componente for carregado. | `boolean`
|
13
|
-
| `configName` | `config-name` | Eventualmente poderemos ter mais de uma barra de filtros. Essa propriedade serve para separar a configuração de cada uma. | `string`
|
14
|
-
| `
|
15
|
-
| `
|
16
|
-
| `
|
17
|
-
| `
|
18
|
-
| `
|
19
|
-
| `
|
20
|
-
| `
|
21
|
-
| `
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
11
|
+
| --------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ----------- |
|
12
|
+
| `autoLoad` | `auto-load` | Define se a carga dos dados será feita assim que o componente for carregado. | `boolean` | `undefined` |
|
13
|
+
| `configName` | `config-name` | Eventualmente poderemos ter mais de uma barra de filtros. Essa propriedade serve para separar a configuração de cada uma. | `string` | `undefined` |
|
14
|
+
| `customFilterBarConfig` | -- | Loader customizado para carregar as configurações | `(configName: string, resourceId: string, options: any) => Promise<SnkFilterItemConfig[]>` | `undefined` |
|
15
|
+
| `dataUnit` | -- | Recebe o DataUnit do ambiente. Se não for informado, procura pela referência do SnkDataUnit. Necessário para se registrar como provedor de filtros. | `DataUnit` | `undefined` |
|
16
|
+
| `disablePersonalizedFilter` | `disable-personalized-filter` | Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados). | `boolean` | `undefined` |
|
17
|
+
| `filterBarLegacyConfigName` | `filter-bar-legacy-config-name` | Chave da configuração legado da barra de filtros. | `string` | `undefined` |
|
18
|
+
| `filterConfig` | -- | Lista todos os filtros disponíveis ao usuário. | `SnkFilterItemConfig[]` | `undefined` |
|
19
|
+
| `messagesBuilder` | -- | Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção. | `SnkMessageBuilder` | `undefined` |
|
20
|
+
| `mode` | `mode` | Modo de apresentação da filterbar. | `"button" \| "hidden" \| "regular"` | `"regular"` |
|
21
|
+
| `resourceID` | `resource-i-d` | Identificador de recursos como configurações e acesso. | `string` | `undefined` |
|
22
|
+
| `title` | `title` | Título que será apresentado na barra de filtros | `string` | `undefined` |
|
22
23
|
|
23
24
|
|
24
25
|
## Events
|
@@ -7,11 +7,12 @@
|
|
7
7
|
|
8
8
|
## Properties
|
9
9
|
|
10
|
-
| Property
|
11
|
-
|
|
12
|
-
| `configManager`
|
13
|
-
| `dataUnit`
|
14
|
-
| `
|
10
|
+
| Property | Attribute | Description | Type | Default |
|
11
|
+
| -------------------------- | ------------------------------ | -------------------------------------------------------------------------------------- | ---------------------- | ----------- |
|
12
|
+
| `configManager` | -- | Campos de configuração de formulário. | `SnkFormConfigManager` | `undefined` |
|
13
|
+
| `dataUnit` | -- | Repositório de dados, controla a manipulação dos dados. | `DataUnit` | `undefined` |
|
14
|
+
| `ignoreReadOnlyFormFields` | `ignore-read-only-form-fields` | Ignora os campos "somente leitura" no modo de inserção. | `boolean` | `undefined` |
|
15
|
+
| `messagesBuilder` | -- | Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção. | `SnkMessageBuilder` | `undefined` |
|
15
16
|
|
16
17
|
|
17
18
|
## Events
|
@@ -16,6 +16,7 @@
|
|
16
16
|
| `columnFilterDataSource` | -- | | `IMultiSelectionListDataSource` | `new SnkMultiSelectionListDataSource()` |
|
17
17
|
| `configName` | `config-name` | Nome usado para salvar/recuperar a configuração. | `string` | `undefined` |
|
18
18
|
| `disablePersonalizedFilter` | `disable-personalized-filter` | Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados). | `boolean` | `undefined` |
|
19
|
+
| `enableGridInsert` | `enable-grid-insert` | Ativa inserção de registros no modo grade. | `boolean` | `false` |
|
19
20
|
| `filterBarLegacyConfigName` | `filter-bar-legacy-config-name` | Chave da configuração legado da barra de filtros. | `string` | `undefined` |
|
20
21
|
| `filterBarTitle` | `filter-bar-title` | Título que será apresentado na barra de filtros | `string` | `undefined` |
|
21
22
|
| `gridHeaderCustomSlotId` | `grid-header-custom-slot-id` | Nome do slot de elementos customizados da Taskbar do cabeçalho da grade. | `string` | `'GRID_HEADER_CUSTOM_ELEMENTS'` |
|
@@ -15,6 +15,8 @@
|
|
15
15
|
| `configName` | `config-name` | Usado para salvar as configurações dos blocos de construção. | `string` | `undefined` |
|
16
16
|
| `dataState` | -- | | `DataState` | `undefined` |
|
17
17
|
| `dataUnit` | -- | | `DataUnit` | `undefined` |
|
18
|
+
| `domainMessagesBuilder` | `domain-messages-builder` | Define a chave customizada para sobrescrever as mensagens (Não pegando pela entidade) | `string` | `undefined` |
|
19
|
+
| `enableGridInsert` | `enable-grid-insert` | Ativa inserção de registros no modo grade. | `boolean` | `false` |
|
18
20
|
| `entityName` | `entity-name` | Define o nome da entidade que o componente vai utilizar para fazer as operações de CRUD | `string` | `undefined` |
|
19
21
|
| `formConfig` | -- | | `IFormConfig` | `undefined` |
|
20
22
|
| `formLegacyConfigName` | `form-legacy-config-name` | Chave da configuração legado do formulário. | `string` | `undefined` |
|
@@ -175,8 +177,8 @@ Type: `Promise<void>`
|
|
175
177
|
|
176
178
|
### Depends on
|
177
179
|
|
178
|
-
- [snk-data-unit](../snk-data-unit)
|
179
180
|
- [snk-taskbar](../snk-taskbar)
|
181
|
+
- [snk-data-unit](../snk-data-unit)
|
180
182
|
- [snk-form-config](../snk-form-config)
|
181
183
|
- [snk-configurator](../snk-configurator)
|
182
184
|
- [snk-grid-config](../snk-grid-config)
|
@@ -187,8 +189,8 @@ Type: `Promise<void>`
|
|
187
189
|
### Graph
|
188
190
|
```mermaid
|
189
191
|
graph TD;
|
190
|
-
snk-simple-crud --> snk-data-unit
|
191
192
|
snk-simple-crud --> snk-taskbar
|
193
|
+
snk-simple-crud --> snk-data-unit
|
192
194
|
snk-simple-crud --> snk-form-config
|
193
195
|
snk-simple-crud --> snk-configurator
|
194
196
|
snk-simple-crud --> snk-grid-config
|
@@ -27,9 +27,11 @@
|
|
27
27
|
|
28
28
|
## Events
|
29
29
|
|
30
|
-
| Event
|
31
|
-
|
|
32
|
-
| `actionClick`
|
30
|
+
| Event | Description | Type |
|
31
|
+
| --------------------- | ------------------------------------------------------------ | --------------------- |
|
32
|
+
| `actionClick` | Emitido sempre que houver click de botão ou ação. | `CustomEvent<string>` |
|
33
|
+
| `taskbarSaveLocker` | Emitido sempre que um save é iniciado pela taskbar. | `CustomEvent<void>` |
|
34
|
+
| `taskbarSaveUnlocker` | Emitido sempre que o ocorre alguma action que libera o save. | `CustomEvent<void>` |
|
33
35
|
|
34
36
|
|
35
37
|
## Dependencies
|