docs(externals): improve template.md

This commit is contained in:
Albus Dumbledore 2020-03-10 12:58:43 +05:30 committed by GitHub
parent c7a5138eb5
commit d9bd8f8307
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 5 deletions

View File

@ -1,17 +1,17 @@
This example demonstrates how to build a library with webpack that has dependencies to other libraries which should not be included in the compiled version.
This example demonstrates how to build a library with webpack that has dependencies on other libraries which should not be included in the compiled version.
We use the `libraryTarget: "umd"` option to build a UMD module that is consumable in CommonJs, AMD and with script tags. We don't specify the `library` option so the library is exported to the root namespace.
We use the `libraryTarget: "umd"` option to build a UMD module that is consumable in CommonJS, AMD and with script tags. We don't specify the `library` option so the library is exported to the root namespace.
We use the `externals` option to define dependencies that should be resolved in the target environment.
In the simple case we just need to specify a string (`"add"`). Then it's resolved as `"add"` module in CommonJs and AMD, and as global `add` when used with script tag.
In the simple case we just need to specify a string (`"add"`). Then it's resolved as `"add"` module in CommonJS and AMD, and as global `add` when used with the script tag.
In the complex case we specify different values for each environment:
| environment | config value | resolved as |
| ------------------ | ------------------------ | ---------------------------- |
| CommonJs (strict) | `["./math", "subtract"]` | `require("./math").subtract` |
| CommonJs (node.js) | `"./subtract"` | `require("./subtract")` |
| CommonJS (strict) | `["./math", "subtract"]` | `require("./math").subtract` |
| CommonJS (node.js) | `"./subtract"` | `require("./subtract")` |
| AMD | `"subtract"` | `define(["subtract"], ...)` |
| script tag | `"subtract"` | `this.subtract` |