Skip to content

Commit 9ec37a9

Browse files
authored
docs: mention that html include type does not work anymore (#3556)
Also added similar note for `dart` include type. Fixes #3419
1 parent d9ba284 commit 9ec37a9

File tree

1 file changed

+7
-10
lines changed

1 file changed

+7
-10
lines changed

docs/config/02-files.md

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -27,17 +27,14 @@ Each pattern is either a simple string or an object with the following propertie
2727
### `type`
2828
* **Type.** String
2929
* **Default.** Will attempt to determine type based on file extension. If that fails, defaults to `js`.
30-
* **Description.** Choose the type to use when including a file.
3130
* **Possible Values:**
32-
* `css`
33-
* `html`
34-
* `js`
35-
* `dart`
36-
* `module`
37-
* `dom`
38-
* **Description.** The type determines the mechanism for including the file. The `css` and `html` types
39-
create `link` elements; the `js`, `dart`, and `module` elements create `script` elements. The `dom` type
40-
includes the file content in the page, used, for example, to test components combining HTML and JS.
31+
* `css` - Include using `<link rel="stylesheet">` tag.
32+
* `html` - Include using [HTML Imports](https://developer.mozilla.org/en-US/docs/Web/Web_Components/HTML_Imports). Note that this feature is obsolete and does not work in the modern browsers.
33+
* `js` - Include using `<script></script>` tag.
34+
* `dart` - Include using `<script type="application/dart"></script>` tag. Note that this does not work in the modern browsers.
35+
* `module` - Include using `<script type="module"></script>` tag.
36+
* `dom` - Inline content of the file in the page. This can be used, for example, to test components combining HTML and JS.
37+
* **Description.** The type determines the mechanism for including the file.
4138

4239
### `watched`
4340
* **Type.** Boolean

0 commit comments

Comments
 (0)