| 
									
										
										
										
											2017-04-02 06:47:25 +00:00
										 |  |  | #### Cell Comments
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Cell comments are objects stored in the `c` array of cell objects.  The actual | 
					
						
							|  |  |  | contents of the comment are split into blocks based on the comment author.  The | 
					
						
							|  |  |  | `a` field of each comment object is the author of the comment and the `t` field | 
					
						
							| 
									
										
										
										
											2017-09-24 23:40:09 +00:00
										 |  |  | is the plain text representation. | 
					
						
							| 
									
										
										
										
											2017-04-02 06:47:25 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | For example, the following snippet appends a cell comment into cell `A1`: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```js | 
					
						
							|  |  |  | if(!ws.A1.c) ws.A1.c = []; | 
					
						
							|  |  |  | ws.A1.c.push({a:"SheetJS", t:"I'm a little comment, short and stout!"}); | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Note: XLSB enforces a 54 character limit on the Author name.  Names longer than | 
					
						
							|  |  |  | 54 characters may cause issues with other formats. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2018-06-01 16:32:08 +00:00
										 |  |  | To mark a comment as normally hidden, set the `hidden` property: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ```js | 
					
						
							|  |  |  | if(!ws.A1.c) ws.A1.c = []; | 
					
						
							|  |  |  | ws.A1.c.push({a:"SheetJS", t:"This comment is visible"}); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | if(!ws.A2.c) ws.A2.c = []; | 
					
						
							|  |  |  | ws.A2.c.hidden = true; | 
					
						
							|  |  |  | ws.A2.c.push({a:"SheetJS", t:"This comment will be hidden"}); | 
					
						
							|  |  |  | ``` | 
					
						
							|  |  |  | 
 |