* [doc] finish the difference-with-web doc
Project: http://git-wip-us.apache.org/repos/asf/incubator-weex/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-weex/commit/1a71f13b Tree: http://git-wip-us.apache.org/repos/asf/incubator-weex/tree/1a71f13b Diff: http://git-wip-us.apache.org/repos/asf/incubator-weex/diff/1a71f13b Branch: refs/heads/master Commit: 1a71f13bcc72515f8df00e8a96bf82221705295c Parents: b8c627d Author: Hanks <[email protected]> Authored: Thu Feb 23 16:51:30 2017 +0800 Committer: Hanks <[email protected]> Committed: Thu Feb 23 16:51:30 2017 +0800 ---------------------------------------------------------------------- doc/source/references/platfrom-difference.md | 11 ++++++++++ .../references/vue/difference-with-web.md | 23 ++++++++------------ 2 files changed, 20 insertions(+), 14 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/1a71f13b/doc/source/references/platfrom-difference.md ---------------------------------------------------------------------- diff --git a/doc/source/references/platfrom-difference.md b/doc/source/references/platfrom-difference.md new file mode 100644 index 0000000..0aadfae --- /dev/null +++ b/doc/source/references/platfrom-difference.md @@ -0,0 +1,11 @@ +--- +title: Platform Differences Between Weex and Web +type: references +order: 12 +version: 2.1 +has_chapter_content: true +--- + +# Platform Differences Between Weex and Web + +Work in progresss. http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/1a71f13b/doc/source/references/vue/difference-with-web.md ---------------------------------------------------------------------- diff --git a/doc/source/references/vue/difference-with-web.md b/doc/source/references/vue/difference-with-web.md index b0808f3..ff328f4 100644 --- a/doc/source/references/vue/difference-with-web.md +++ b/doc/source/references/vue/difference-with-web.md @@ -9,10 +9,9 @@ version: 2.1 ## Platform Differences -> TODO -Vue.js was designed for the Web platform at the begining, although it can be based on Weex development of native applications, but Web development and native development, after all, different in the function and development experience there are some differences, these differences are essentially the original development platform and Differences between Web platforms can be found in the [Platform Differences Between Weex and Web](../ platform-difference.html) for more details. +Vue.js was designed for the Web platform at the begining. Although it can be based on Weex to develop native applications, there are still many differences between web and native. See [Platform Differences Between Weex and Web](../ platform-difference.html) for more details. -Due to the differences between Web platform, Weex doesn't support those features in Vue.js (mostly are DOM-related): +Due to those differences, Weex doesn't support those features in Vue.js (mostly are DOM-related): + Event bubbling and capturing are not supported. Event modifiers, such as `.prevent`,` .capture`, `.stop`,` .self` are meaningless in the native environment. + The keyboard event modifiers, like `.{KeyCode | keyAlias}` is also meaningless. (see [docs in Vue.js](https://vuejs.org/v2/guide/events.html#Key-Modifiers)) @@ -35,8 +34,7 @@ The specific differences are: ### Isolate the context of multiple pages -> TODO -Weex in the native use of the "multi-page" implementation, different js bundle will be implemented in different native pages; that is, different js bundles will be shared between different js variables. Even the `Vue` variable, in a different page also corresponds to a different reference. +Weex use the "multiple-pages" concept in native, different js bundle will be run in different native views, there context is isolated. Even the `Vue` variable is not the same instance between js bundles. (However, all the js bundle will share the same Weex runtime.) Based on this feature, the global configurations in `Vue` will only take effect on the current page: @@ -113,12 +111,10 @@ In addition, you should also pay attention to the following points: ## Differences in development -> TODO -Vex.js in Weex, you need to pay attention to the operating platform in addition to the Web and Android and iOS, in the development and compilation environment there are some differences. For the Web and native platform, the Vue project source files compiled into the target file, there are two different ways: +Because of the platform difference, you have to compile your source file in two different ways: -> TODO -+ For the Web platform, as with the regular Vue 2.X project, you can compile source files in any official way, such as Webpack + vue-loader or Browserify + vueify. -+ For the Android and iOS platforms, we've provided the [weex-loader] (https://github.com/weepteam/weep-loader) tool to support the single file component that compiles the `.vue` format; that is, Use the Webpack + weex-loader to generate the js bundle that is available at the native end. ++ For the web, you can compile source files in any official way, such as Webpack + vue-loader or Browserify + vueify. and require the [weex-vue-render](https://www.npmjs.com/package/weex-vue-render), which is a group of Weex build-in components. ++ For Android and iOS, we've provided [weex-loader](https://github.com/weepteam/weep-loader) to compile the `.vue` files. That is, use Webpack + weex-loader to generate the js bundle that is available for the native. ### Use weex-loader @@ -146,9 +142,8 @@ module.exports = { **You don't need to write those additional parameters if you are using `.js` file as entry file.** We recommend using javascript files as the entry file of webpack config. -### Setup native development environment +### Setup native development environments -> TODO -The Weex project generates native applications and learns some of the basics of developing native applications that will help you develop the Weex project. +Since your are using Weex to develop native apps, setup native development environments, both Android and iOS, would be very useful. -Refer to [Integrating Weex to the existing application](../../guide/ integrate-to-your-app.html) for more information. +See [Integrating Weex to the existing application](../../guide/integrate-to-your-app.html) for more information.
