Blazor Tree Grid Cell Editing
A Edição de Célula Ignite UI for Blazor em Blazor Grade de Árvore fornece uma grande capacidade de manipulação de dados do conteúdo de células individuais dentro do componente Grade de Árvore Blazor e vem com API poderosa para operações CRUD React. É um recurso fundamental em aplicativos como planilhas, tabelas de dados e grades de dados, permitindo que os usuários adicionem, editem ou atualizem dados em células específicas. Por padrão, a Grade em Ignite UI for Blazor é usada na edição de células. E devido ao modelo de edição de célula padrão, haverá diferentes editores com base no tipo de dados da coluna Top of Form.
Além disso, você pode definir seus próprios modelos personalizados para ações de atualização de dados e substituir o comportamento padrão para confirmar e descartar quaisquer alterações.
Blazor Tree Grid Cell Editing and Edit Templates Example
Edição de células
Editing through UI
Você pode entrar no modo de edição para uma célula específica, quando uma célula editável estiver em foco de uma das seguintes maneiras:
- no clique duplo;
- em clique único - Um clique único entrará no modo de edição somente se a célula selecionada anteriormente estava no modo de edição e a célula selecionada atualmente for editável. Se a célula selecionada anteriormente não estava no modo de edição, um clique único selecionará a célula sem entrar no modo de edição;
- na tecla pressione Enter;
- ao pressionar a tecla F2;
Você pode sair do modo de edição sem confirmar as alterações de uma das seguintes maneiras:
- ao pressionar a tecla Escape;
- quando você executa operações de classificação, filtragem, pesquisa e ocultação;
Você pode sair do modo de edição e confirmar as alterações de uma das seguintes maneiras:
- na tecla pressione Enter;
- ao pressionar a tecla F2;
- ao pressionar a tecla Tab;
- Ao clicar uma vez em outra célula - Quando você clica em outra célula no
IgbTreeGrid, suas alterações serão enviadas. - Operações como paginação, redimensionamento, fixar ou mover sairão do modo de edição e as alterações serão enviadas.
[!Note] The cell remains in edit mode when you scroll vertically or horizontally or click outside the
IgbTreeGrid. This is valid for both cell editing and row editing.
Editing through API
Você também pode modificar o valor da célula por meio da API, mas somente se a IgbTreeGrid chave primária estiver definida:
@code {
this.treeGrid.UpdateCell(newValue, rowID, 'ReorderLevel');
}
Outra maneira de atualizar a célula é diretamente através Update do método de Cell:
@code {
private UpdateCell() {
IgbCell cell = this.treeGrid.GetCellByColumn(rowIndex, "Age");
cell.Update(9999);
}
}
Cell Editing Templates
Você pode ver e aprender mais sobre modelos de edição de células padrão no tópico de edição geral.
Se você quiser fornecer um modelo personalizado que será aplicado a uma célula, você pode passar esse modelo para a própria célula ou para seu cabeçalho. Primeiro crie a coluna como você normalmente faria:
<IgbColumn
Field="Category"
DataType="GridColumnDataType.String"
InlineEditorTemplateScript="WebGridCellEditCellTemplate"
Editable="true"
Name="column1"
@ref="column1">
</IgbColumn>
e passe o template:
*** In JavaScript ***
igRegisterScript("WebGridCellEditCellTemplate", (ctx) => {
let cellValues = [];
let uniqueValues = [];
for(const i of ctx.cell.grid.data){
const field = ctx.cell.column.field;
if(uniqueValues.indexOf(i[field]) === -1 )
{
cellValues.push(html`<igc-select-item value=${i[field]}>${(i[field])}</igc-select-item>`);
uniqueValues.push(i[field]);
}
}
return html`<div>
<igc-select position-strategy="fixed" @igcChange=${ e => ctx.cell.editValue = e.detail.value}>
${cellValues}
</igc-select>
</div>`;
}, false);
Uma amostra funcional do acima pode ser encontrada aqui para referência futura:
CRUD operations
[!Note] Please keep in mind that when you perform some CRUD operation all of the applied pipes like filtering, sorting and grouping will be re-applied and your view will be automatically updated.
The IgbTreeGrid provides a straightforward API for basic CRUD operations.
Adding a new record
O IgbTreeGrid componente expõe o AddRow método que adicionará os dados fornecidos à própria fonte de dados.
//Assuming we have a `GetNewRecord` method returning the new row data.
const record = this.GetNewRecord();
this.TreeGridRef.AddRow(record);
Updating data in the Tree Grid
A atualização de dados na grade de árvore é obtida por meio UpdateRow de métodos e UpdateCell, mas somente se o PrimaryKey para a grade estiver definido. Você também pode atualizar diretamente um valor de célula e/ou linha por meio de seus respectivos métodos de atualização.
@code {
// Updating the whole row
this.treeGrid.UpdateRow(newData, this.selectedCell.cellID.rowID);
// Just a particular cell through the Tree Grid API
this.treeGrid.UpdateCell(newData, this.selectedCell.cellID.rowID, this.selectedCell.column.field);
// Directly using the cell `update` method
this.selectedCell.Update(newData);
// Directly using the row `update` method
IgbRowType row = this.treeGrid.GetRowByKey(rowID);
row.Update(newData);
}
Deleting data from the Tree Grid
Tenha em mente que o método DeleteRow removerá a linha especificada somente se uma PrimaryKey for definida.
@code {
// Delete row through Tree Grid API
this.treeGrid.DeleteRow(this.selectedCell.cellID.rowID);
// Delete row through row object
IgbRowType row = this.treeGrid.GetRowByIndex(rowIndex);
row.Del();
}
Cell Validation on Edit Event
Usando os IgbTreeGrid eventos de edição, podemos alterar a forma como o usuário interage com o IgbTreeGrid.
Neste exemplo, validaremos uma célula com base nos dados inseridos nela vinculando-a ao evento CellEdit. Se o novo valor da célula não atender aos nossos critérios predefinidos, impediremos que ela alcance a fonte de dados cancelando o evento.
A primeira coisa que precisamos fazer é vincular ao evento da grade:
<IgbTreeGrid CellEditScript="HandleCellEdit" />
O CellEdit emite sempre que qualquer valor de célula está prestes a ser confirmado. Em nossa definição de CellEdit, precisamos ter certeza de que verificamos nossa coluna específica antes de tomar qualquer ação:
*** In JavaScript ***
igRegisterScript("HandleCellEdit", (ev) => {
const column = event.detail.column;
if (column.field === 'Age') {
if (event.detail.newValue < 18) {
event.detail.cancel = true;
alert('Employees must be at least 18 years old!');
}
} else if (column.field === 'HireDate') {
if (event.detail.newValue > new Date().getTime()) {
event.detail.cancel = true;
alert('The employee hire date must be in the past!');
}
}
}, false);
Se o valor inserido em uma célula na coluna Idade for inferior a 18 ou o valor na coluna HireDate estiver no futuro, a edição será cancelada e o usuário será alertado sobre o cancelamento.
O resultado da validação acima sendo aplicada ao nosso IgbTreeGrid pode ser visto na demonstração abaixo:
Styling
Além dos temas predefinidos, a grade pode ser ainda mais personalizada ao definir algumas das propriedades CSS disponíveis. Caso você queira alterar algumas das cores, precisa definir uma classe para a grade primeiro:
<IgbTreeGrid Class="treeGrid"></IgbTreeGrid>
Em seguida, defina as propriedades CSS relacionadas para essa classe:
.treeGrid {
--ig-grid-edit-mode-color: orange;
--ig-grid-cell-editing-background: lightblue;
}