diff --git a/js-wixcode-sdk/$w/HtmlComponent.service.json b/js-wixcode-sdk/$w/HtmlComponent.service.json index 0a78c52696..74bb5b5c7d 100644 --- a/js-wixcode-sdk/$w/HtmlComponent.service.json +++ b/js-wixcode-sdk/$w/HtmlComponent.service.json @@ -23,15 +23,67 @@ "extra": { } }, "properties": - [ { "name": "scrolling", + [ { "name": "allow", "labels": [], "get": true, "set": true, "type": "string", "locations": - [ { "lineno": 63, + [ { "lineno": 95, "filename": "HtmlComponent.js" }, - { "lineno": 70, + { "lineno": 102, + "filename": "HtmlComponent.js" } ], + "docs": + { "summary": "Sets or gets the browser permissions for the HTML Component.", + "description": + [ "Setting the `allow` property controls which browser features and APIs", + " the HTML Component can access. This helps secure a site by restricting", + " what embedded content can do.", + "", + " The `allow` property accepts a string of permission names", + " separated by semicolons. The possible permissions include:", + "", + " + `camera`: Allows access to the camera.", + " + `encrypted-media`: Allows playback of encrypted media content using the Encrypted Media Extensions API. Required for DRM-protected content like premium video streaming services.", + " + `fullscreen`: Allows the HTML Component content to request fullscreen mode. By default, fullscreen isn't allowed unless explicitly permitted.", + "", + " For example: `\"camera; encrypted-media; fullscreen\"`", + "", + " Getting the `allow` property returns the current permissions", + " for the HTML Component.", + "", + "> **Note:** You can also set the `fullscreen` permission by calling the [`allowFullScreen()`](#allowFullScreen) function, ", + "> which automatically adds `fullscreen` to the existing `allow` property value." ], + "links": [], + "examples": + [ { "title": "Set permissions for encrypted media and fullscreen", + "body": + [ "$w(\"#videoPlayer\").allow = \"encrypted-media; fullscreen\";" ], + "extra": + { } }, + { "title": "Get current permissions and check if camera is allowed", + "body": + [ "let permissions = $w(\"#myHtmlComponent\").allow;", + "console.log(\"Current permissions:\", permissions);", + "", + "if (permissions.includes(\"camera\")) {", + " console.log(\"Camera access is allowed\");", + "}" ], + "extra": + { } } ], + "extra": + { } }, + "extra": + { } }, + { "name": "scrolling", + "labels": [], + "get": true, + "set": true, + "type": "string", + "locations": + [ { "lineno": 62, + "filename": "HtmlComponent.js" }, + { "lineno": 69, "filename": "HtmlComponent.js" } ], "docs": { "summary": "Sets or gets whether the HTML Component displays scrollbars.", @@ -110,13 +162,17 @@ "ret": { "type": "$w.HtmlComponent" }, "locations": - [ { "lineno": 222, + [ { "lineno": 257, "filename": "HtmlComponent.js" } ], "docs": { "summary": "Allows the HTML Component to be put into full screen mode.", "description": - [ "By default, users cannot place the HTML Component in full screen mode. Calling", - " this function allows a user to place the HTML Component in full screen mode." ], + [ "By default, code can't place the HTML Component in full screen mode. Calling", + " this function allows code to place the HTML Component in full screen mode.", + "", + " This function automatically adds the `fullscreen` permission to the HTML Component's", + " [`allow`](#allow) property. You can also set fullscreen permissions directly", + " by including `\"fullscreen\"` in the `allow` property value." ], "links": [], "examples": [ { "title": "Allow an HTML Component to be placed in full screen mode", @@ -139,7 +195,7 @@ { "type": "$w.HtmlComponent", "doc": "The HTML Code element that triggered the event." }, "locations": - [ { "lineno": 169, + [ { "lineno": 204, "filename": "HtmlComponent.js" } ], "docs": { "summary": "Adds an event handler that runs when the HTML Component\n sends a message.", @@ -270,7 +326,7 @@ "ret": { "type": "void" }, "locations": - [ { "lineno": 97, + [ { "lineno": 132, "filename": "HtmlComponent.js" } ], "docs": { "summary": "Sends a message to the HTML Component.", diff --git a/js-wixcode-sdk/$w/SearchButton.service.json b/js-wixcode-sdk/$w/SearchButton.service.json index b9701817dd..259d105648 100644 --- a/js-wixcode-sdk/$w/SearchButton.service.json +++ b/js-wixcode-sdk/$w/SearchButton.service.json @@ -72,12 +72,13 @@ "extra": { } }, { "name": "customClassList", - "labels": [], + "labels": + [ "new" ], "get": true, "set": false, "type": "$w.CustomClassList", "locations": - [ { "lineno": 280, + [ { "lineno": 281, "filename": "SearchButton.js" } ], "docs": { "summary": "A property that represents an element's custom CSS classes.", diff --git a/js-wixcode-sdk/wix-window-frontend.service.json b/js-wixcode-sdk/wix-window-frontend.service.json index 3c584b856e..371e9d8ea4 100644 --- a/js-wixcode-sdk/wix-window-frontend.service.json +++ b/js-wixcode-sdk/wix-window-frontend.service.json @@ -2560,4 +2560,4 @@ "labels": [] } ], "extra": { "scopes": - [ "frontend" ] } } + [ "frontend" ] } } \ No newline at end of file