{
    "componentChunkName": "component---src-templates-doc-page-jsx",
    "path": "/angular-data-grid/row-ids/",
    "result": {"data":{"markdownRemark":{"htmlAst":{"type":"element","tagName":"div","properties":{},"children":[{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"This section explains how the grid assigns row IDs and shows how applications can supply custom row IDs.  "}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Each grid row has a unique row ID which is used by the grid to identify rows, e.g. for identifying what\nrows are currently selected. These row IDs can be "},{"type":"element","tagName":"a","properties":{"href":"/archive/29.2.0/row-ids/#grid-assigned-ids"},"children":[{"type":"text","value":"Grid Assigned"}]},{"type":"text","value":" or\n"},{"type":"element","tagName":"a","properties":{"href":"/archive/29.2.0/row-ids/#application-assigned-ids"},"children":[{"type":"text","value":"Application Assigned"}]},{"type":"text","value":".   "}]},{"type":"element","tagName":"h2","properties":{"id":"grid-assigned-ids","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#grid-assigned-ids","ariaLabel":"grid assigned ids permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","dataPrefix":"fas","dataIcon":"link","className":["svg-inline--fa","fa-link"],"role":"img","xmlns":"http://www.w3.org/2000/svg","viewBox":"0 0 512 512"},"children":[{"type":"element","tagName":"path","properties":{"fill":"currentColor","d":"M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"},"children":[]}]}]},{"type":"text","value":"Grid Assigned IDs"}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Row IDs are generated by the grid when data is supplied to the grid. The grid uses a sequence starting at 0 and\nincrementing by 1 to assign row IDs, so for example if there are three rows they will have IDs of "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"0"}]},{"type":"text","value":", "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"1"}]},{"type":"text","value":" and "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"2"}]},{"type":"text","value":".\nThe row ID does not change for a row once it is set."}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"If the row data is updated to a new set, the grid will continue with its sequence. For example if 10 rows are initially\nset, IDs [0..9] are used. Then, if the data is set again for another 10 rows, IDs [10..19] are used. This is true even if\nthe second set of rows are logically identical to the first set of rows (i.e. it's a refresh operation)."}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"When "},{"type":"element","tagName":"a","properties":{"href":"/archive/29.2.0/grouping/"},"children":[{"type":"text","value":"Row Grouping"}]},{"type":"text","value":" another zero based sequence is used and prefixed with "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"row-group-"}]},{"type":"text","value":". For example Row Groups\nwill have IDs "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"row-group-0"}]},{"type":"text","value":", "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"row-group-1"}]},{"type":"text","value":" and "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"row-group-2"}]},{"type":"text","value":"."}]},{"type":"element","tagName":"h2","properties":{"id":"application-assigned-ids","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#application-assigned-ids","ariaLabel":"application assigned ids permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","dataPrefix":"fas","dataIcon":"link","className":["svg-inline--fa","fa-link"],"role":"img","xmlns":"http://www.w3.org/2000/svg","viewBox":"0 0 512 512"},"children":[{"type":"element","tagName":"path","properties":{"fill":"currentColor","d":"M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"},"children":[]}]}]},{"type":"text","value":"Application Assigned IDs"}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"When the Application assigns Row IDs, this provides a common Row ID across the grid and the Application. This has advantages such as:"}]},{"type":"element","tagName":"ol","properties":{},"children":[{"type":"text","value":"\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"The grid API "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"getRowNode(id)"}]},{"type":"text","value":" can be called with the Application known ID (eg "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"employeeId"}]},{"type":"text","value":") to get the Row Node for a particular piece of data."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"When updating Row Data (either by updating the "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"rowData"}]},{"type":"text","value":" attribute, or using "},{"type":"element","tagName":"a","properties":{"href":"/archive/29.2.0/data-update-transactions/"},"children":[{"type":"text","value":"Update Transactions"}]},{"type":"text","value":"), the grid uses the Row ID to map old vs new data (e.g. it can work out which Rows to add / remove / update rather than doing a blanket replacement of old vs new data). This allows the grid to keep state such as Row Selection."}]},{"type":"text","value":"\n"}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Setting Row IDs is done using the "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"getRowId()"}]},{"type":"text","value":" grid callback:"}]},{"type":"element","tagName":"div","properties":{},"children":[{"type":"element","tagName":"api-documentation","properties":{"source":"grid-options/properties.json","section":"rowModels","names":"[\"getRowId\"]"},"children":[]}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"When the row data contains a unique row identifier, such as a Database Primary Key, "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"getRowId()"}]},{"type":"text","value":" can be implemented as follows: "}]},{"type":"element","tagName":"snippet","properties":{},"children":[{"type":"text","value":"\nconst gridOptions = {\n    // assumes each data item provided by the application has the ID stored in an attribute called id\n    getRowId: params => params.data.id\n}\n"}]},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"The example below has "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"getRowId()"}]},{"type":"text","value":" implemented to return "},{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"params.data.id"}]},{"type":"text","value":". The Row ID is displayed inside the first Column."}]},{"type":"element","tagName":"div","properties":{},"children":[{"type":"element","tagName":"grid-example","properties":{"title":"Get Row ID","name":"get-row-id","type":"generated","options":" { \"modules\": [\"clientside\"] }"},"children":[]}]}]},"frontmatter":{"title":"Row IDs","version":null,"enterprise":null,"description":null},"headings":[{"id":"grid-assigned-ids","depth":2,"value":"Grid Assigned IDs"},{"id":"application-assigned-ids","depth":2,"value":"Application Assigned IDs"}]}},"pageContext":{"frameworks":["javascript","react","angular","vue"],"framework":"angular","srcPath":"/row-ids","pageName":"row-ids"}},
    "staticQueryHashes": ["1766026005","699667431","940729948"]}