From a113bd2b7f0775daa1e4c4138154e20bbb763020 Mon Sep 17 00:00:00 2001 From: Tan Zhen Yong Date: Mon, 4 Jan 2021 17:08:38 +0800 Subject: [PATCH] feat: add note on isCustomElement in runtime-only builds The isCustomElement config option only applies when using the runtime compiler. Since most users will be using the runtime-only compiler (eg. via vue-loader or @vue/cli), we should add a note that they may need to configure vue-loader instead. --- src/api/application-config.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/api/application-config.md b/src/api/application-config.md index f08321ce90..bcb26d5a6c 100644 --- a/src/api/application-config.md +++ b/src/api/application-config.md @@ -94,6 +94,10 @@ Specifies a method to recognize custom elements defined outside of Vue (e.g., us > Note that all native HTML and SVG tags don't need to be matched in this function - Vue parser performs this check automatically +::: tip Important +This config option is only respected when using the runtime compiler. If you are using the runtime-only build, `isCustomElement` must be passed to `@vue/compiler-dom` in the build setup instead - for example, via the [`compilerOptions` option in vue-loader](https://vue-loader.vuejs.org/options.html#compileroptions). +::: + ## optionMergeStrategies - **Type:** `{ [key: string]: Function }`