Merge pull request #2805 from adumesny/master

doc update

Author: adumesny

angular/README.md

@@ -162,22 +162,23 @@ public identify(index: number, w: GridStackWidget) {
 
 You can see a fuller example at [app.component.ts](projects/demo/src/app/app.component.ts)
 
-to build the demo, go to [angular/projects/demo](projects/demo/) and run `yarn` + `yarn start` and navigate to `http://localhost:4200/`
+to build the demo, go to [angular/projects/demo](projects/demo/) and run `yarn` + `yarn upgrade` (ng18 seem to have introduced some conflicts) + `yarn start` and navigate to `http://localhost:4200/`
 
-Code ship starting with v8.1.2+ in `dist/angular` for people to use directly and is an angular module! (source code under `dist/angular/src`)
+Code started shipping with v8.1.2+ in `dist/angular` for people to use directly and is an angular module! (source code under `dist/angular/src`)
 
 ## Caveats
 
 - This wrapper needs:
   - gridstack v8 to run as it needs the latest changes (use older version that matches GS versions)
-  - Angular 13+ for dynamic createComponent() API
+  - Angular 14+ for dynamic `createComponent()` API
 
-NOTE: if you are on Angular 12 or below: copy the wrapper code over (or patch it - see main page example) and change `createComponent()` calls to use old API instead:
+NOTE: if you are on Angular 13 or below: copy the wrapper code over (or patch it - see main page example) and change `createComponent()` calls to use old API instead:
 ```ts
 protected resolver: ComponentFactoryResolver,
 ...
 const factory = this.resolver.resolveComponentFactory(GridItemComponent);
 const gridItemRef = grid.container.createComponent(factory) as ComponentRef<GridItemComponent>;
+// ...do the same for widget selector...
 ```
 
 ## ngFor Caveats

doc/CHANGES.md

@@ -5,6 +5,7 @@ Change log
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 **Table of Contents**  *generated with [DocToc](http://doctoc.herokuapp.com/)*
 
+- [11.0.0 (TBD)](#1100-tbd)
 - [10.3.1 (2024-07-21)](#1031-2024-07-21)
 - [10.3.0 (2024-06-26)](#1030-2024-06-26)
 - [10.2.1 (2024-06-23)](#1021-2024-06-23)
@@ -113,6 +114,9 @@ Change log
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
+## 11.0.0 (TBD)
+* fix: [#2736](https://github.com/gridstack/gridstack.js/bug/2736) safe practices around GridStackWidget.content no longer setting innerHTML
+
 ## 10.3.1 (2024-07-21)
 * fix: [#2734](https://github.com/gridstack/gridstack.js/bug/2734) rotate() JS error
 * fix: [#2741](https://github.com/gridstack/gridstack.js/pull/2741) resizeToContent JS error with nested grid

doc/README.md

@@ -33,7 +33,7 @@ gridstack.js API
   - [`setupDragIn(dragIn?: string | HTMLElement[], dragInOptions?: DDDragInOpt, root = HTMLElement | Document)`](#setupdragindragin-string--htmlelement-draginoptions-dddraginopt-root--htmlelement--document)
   - [`GridStack.registerEngine(engineClass: typeof GridStackEngine)`](#gridstackregisterengineengineclass-typeof-gridstackengine)
 - [API](#api)
-  - [`addWidget(el?: GridStackWidget | GridStackElement, options?: GridStackWidget)`](#addwidgetel-gridstackwidget--gridstackelement-options-gridstackwidget)
+  - [`addWidget(w: GridStackWidget): GridItemHTMLElement`](#addwidgetw-gridstackwidget-griditemhtmlelement)
   - [`batchUpdate(flag = true)`](#batchupdateflag--true)
   - [`compact(layout: CompactOptions = 'compact', doSort = true)`](#compactlayout-compactoptions--compact-dosort--true)
   - [`cellHeight(val: number, update = true)`](#cellheightval-number-update--true)
@@ -355,23 +355,20 @@ but you will probably also want `helper: 'clone'` or your own callback function)
 * call to specify global custom engine subclass - see instead `GridStackOptions.engineClass` if you only need to replace just one instance.
 ## API
 
-### `addWidget(el?: GridStackWidget | GridStackElement, options?: GridStackWidget)`
+### `addWidget(w: GridStackWidget): GridItemHTMLElement`
 
-Creates new widget and returns it. Options is an object containing the fields x,y,width,height,etc...
+Creates new widget and returns it.
 
 Parameters:
 
-- `el`: GridStackWidget | GridStackElement -  html element, or string definition, or GridStackWidget (which can have content string as well) to add
-- `options`: GridStackWidget - widget position/size options (optional, and ignore if first param is already option) - see GridStackWidget
+- `w`: GridStackWidget - widget position/size options - see GridStackWidget
 
 Widget will be always placed even if result height is more than actual grid height. You need to use `willItFit` method
 before calling `addWidget` for additional check.
 
 ```js
 let grid = GridStack.init();
 grid.addWidget({w: 3, content: 'hello'});
-// or
-grid.addWidget('<div class="grid-stack-item"><div class="grid-stack-item-content">hello</div></div>', {w: 3});
 ```
 
 ### `batchUpdate(flag = true)`