http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/guide/syntax/display-logic.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/guide/syntax/display-logic.md b/doc/source/cn/v-0.10/guide/syntax/display-logic.md deleted file mode 100644 index 9498de2..0000000 --- a/doc/source/cn/v-0.10/guide/syntax/display-logic.md +++ /dev/null @@ -1,252 +0,0 @@ ---- -title: å±ç¤ºé»è¾æ§å¶ -type: guide -order: 3.4 -version: 0.10 ---- - -# å±ç¤ºé»è¾æ§å¶ - -Weex æ¯æéè¿ä¸¤ç§ç¹æ®çç¹æ§ `if` å `repeat` ç¡®å®ç»ä»¶çæ¾ç¤ºé»è¾ï¼è¿ä¼ä½¿å¾æ´ä¸ªçé¢çå±ç¤ºé»è¾æ§å¶æ´å ç®åçµæ´»ã - -## `if` - -éè¿è®¾ç½® `if` ç¹æ§å¼ï¼ä½ å¯ä»¥æ§å¶å½åç»ä»¶æ¯å¦æ¾ç¤ºãå¦æå¼ä¸ºçï¼åå½åç»ä»¶ä¼è¢«æ¸²æåºæ¥ï¼å¦æå¼ä¸ºååä¼è¢«ç§»é¤ãä¾å¦ï¼ - -```html -<template> - <div> - <text onclick="toggle">Toggle Image</text> - <image if="shown" src="{{imageUrl}}" style="width: 512; height: 512;"></image> - </div> -</template> - -<script> -module.exports = { - data: { - imageUrl: 'https://gtms02.alicdn.com/tps/i2/TB1QHKjMXXXXXadXVXX20ySQVXX-512-512.png', - shown: true - }, - methods: { - toggle: function () { - this.shown = !this.shown - } - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/e0999a51fa404f48bbae177f1569cd0e) - -_注æäºé¡¹ï¼`if="condition"` å `if="{% raw %}{{condition}}{% endraw %}"` é½æ¯å¯ä»¥çï¼ä¸¤è ç价使ç¨ã_ - -_注æäºé¡¹ï¼`if` ä¸è½ç¨å¨ `<template>` çæ ¹ç»ä»¶ä¸ï¼å¦åå°æ æ³è¢« Weex æ£å¸¸çè¯å«åå¤çã_ - -### `if` ä¸ä¼é»æåå ç´ çæ°æ®æ´æ° - -ä¸é¢è¿ä¸ªä¾åå¨æ°æ®æ´æ°å `item` æ `item.image` ä¸åå¨çæ åµä¸ä¼æ¥éï¼ - -```html -<template> - <div if="{{(item && item.image)}}" style="width: 200; height: 200;"> - <image style="width: 100; height: 100;" src="{{item.image.url}}"></image> - </div> -</template> -``` - -åå å¨äº Weex æ¬èº«çæºå¶æ¯æ°æ®æ´æ°å¨ DOM æ´æ°ä¹åï¼å æ¤ `if` æ°æ®æ´æ°ä¹åï¼ä¸æ¯æé»æå ¶åå ç´ çæ°æ®æ´æ°ï¼å³ `if` æ°æ®æ´æ°ä¸º `false` ä¹åï¼å é¨çåå ç´ ä»ç¶ä¼è§¦åèªèº«çæ°æ®æ´æ°ï¼æ¾ä¸å°å¯¹åºå段ï¼å¯¼è´æ¥éï¼å¯åèè¿ä¸ª [issue](https://github.com/alibaba/weex/issues/1758)ã - -å æ¤ï¼æ两ç§è§£å³æ¹æ¡ï¼ - -- 为 `img` ç»ä»¶ç `src` ä¹å¢å 容éæ¹æ¡ï¼ - - ```html - <div if="{{(item && item.image)}}" style="width: 200; height: 200;"> - <image style="width: 100; height: 100;" src="{{item && item.image && item.image.url}}"></image> - </div> - ``` - -- å¦ææ¯å¨ `repeat` çå表ä¸ï¼è¿å¯ä»¥ä½¿ç¨ `track-by`强å¶ä¸å¤ç¨åå ç´ è§£å³ã - -## `repeat` - -`repeat` ç¹æ§ç¨äºéå¤æ¸²æä¸ç»ç¸åçç»ä»¶ãå®ç»å®çæ°æ®ç±»åå¿ é¡»ä¸ºæ°ç»ï¼æ°ç»éçæ¯ä¸é¡¹æ°æ®å¯ä»¥ä½ç°å¨ä¸åçç»ä»¶ç¹æ§ãæ ·å¼ãäºä»¶ç»å®çãä¾å¦ï¼ - -``` html -<template> - <div> - <div repeat="person in list" class="{{person.gender}}"> - <text>{{person.nickname}}</text> - </div> - </div> -</template> - -<style> - .male { background-color: #9999ff; } - .female { background-color: #ff9999; } -</style> - -<script> -module.exports = { - data: { - list: [ - { gender: 'male', nickname: 'Li Lei' }, - { gender: 'female', nickname: 'Han Meimei' }, - { gender: 'male', nickname: 'Jim Green' } - ] - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/8c87aac2820531090181c32fca41e913) - -æ¤å¤ï¼`repeat` ç¹æ§è¿æ¯æç»å®æ°ç»ä¸æ°æ®é¡¹ç®çç´¢å¼å¼ãä¾å¦ï¼ - -``` html -<template> - <div> - <div repeat="(index, person) in list" class="{{person.gender}}"> - <text>{{index}} - {{person.nickname}}</text> - </div> - </div> -</template> - -<style> - .male { background-color: #9999ff; } - .female { background-color: #ff9999; } -</style> - -<script> -module.exports = { - data: { - list: [ - { gender: 'male', nickname: 'Li Lei' }, - { gender: 'female', nickname: 'Han Meimei' }, - { gender: 'male', nickname: 'Jim Green' } - ] - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/65d348256ab5c54aa996d3ee6b4ea115) - -æ¯ä¸ä¸ªæµç§°ä¹åé½æ对åºæ°ç»é¡¹ç®çç´¢å¼å¼ã - -_注æäºé¡¹ï¼åæ ·ç `repeat="..."` å `repeat="{% raw %}{{...}}{% endraw %}"` é½æ¯å¯ä»¥çï¼ä¸¤è ç价使ç¨ã_ - -_注æäºé¡¹ï¼`if` ä¸è½ç¨å¨ `<template>` çæ ¹ç»ä»¶ä¸ï¼å¦åå°æ æ³è¢« Weex æ£å¸¸çè¯å«åå¤çã_ - -**注æäºé¡¹: å½ä½ ä¿®æ¹ `repeat` ä¸çæ°ç»æ¶ï¼å¨åæ³ä¸ä¼åå°ä¸å®çéå¶ï¼å ·ä½å¦ä¸ï¼** - -**ç´æ¥éè¿âè§æ âä¿®æ¹æ°ç»çæä¸ªé¡¹ç® (å¦ `this.items[0] = ...`) æ¯ä¸ä¼è§¦åè§å¾èªå¨æ´æ°çãæ们å¨æ°ç»çååä¸æä¾äºä¸ä¸ªé¢å¤çæ¹æ³ï¼`this.items.$set(index, item)` æ¥å®æç¸åçäºæ ã** - -```javascript -// å `this.items[0] = ...` ä½ç¨ç¸åï¼ä½ä¼èªå¨è§¦åè§å¾æ´æ° -this.items.$set(0, { childMsg: 'Changed!'}) -``` - -**ç´æ¥éè¿ä¿®æ¹ `length` æ¥æ¹åæ°ç»é¿åº¦ (å¦ `this.items.length = 0`) ä¹æ¯ä¸ä¼è§¦åè§å¾èªå¨æ´æ°çãæ们æ¨èæ¨ç´æ¥èµå¼ä¸ä¸ªæ°ç空æ°ç»ææ§çæ¿æ¢æã** - -```javascript -// å `this.items.length = 0` ä½ç¨ç¸åï¼ä½ä¼èªå¨è§¦åè§å¾æ´æ° -this.items = [] -``` - -### `repeat` ç¹æ§ä¸ç `$index` å½¢å - -å¨ `repeat` ç¹æ§å¼ä¸ï¼å¦æ没ææå®ç´¢å¼å¼çå½¢åï¼åå¯ä»¥éè¿ç»å®å½¢å `$index` æ¥å±ç¤ºæ°ç»é¡¹ç®çç´¢å¼å¼ãä¾å¦ï¼ - -``` html -<template> - <div> - <div repeat="person in list" class="{{person.gender}}"> - <text>{{$index}} - {{person.nickname}}</text> - </div> - </div> -</template> - -<style> - .male { background-color: #9999ff; } - .female { background-color: #ff9999; } -</style> - -<script> -module.exports = { - data: { - list: [ - { gender: 'male', nickname: 'Li Lei' }, - { gender: 'female', nickname: 'Han Meimei' }, - { gender: 'male', nickname: 'Jim Green' } - ] - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/65d348256ab5c54aa996d3ee6b4ea115) - -渲æææåä¸ä¸ä¸ªä¾ååºè¯¥æ¯ç¸åçã - -### å¨ `repeat` ä¸ä½¿ç¨ `track-by` ç¹æ§è¿½è¸ªåå - -é常æ åµä¸ï¼å½æ´æ° `repeat` ä¸ç»å®çæ°ç»æ¶ï¼æææ°ç»é¡¹ç®å ³èçç»ä»¶é½ä¼è¢«éæ°æ¸²æãå¦æå ¶ä¸é¨åç´¢å¼å¼å¯¹åºçæ°æ®æªåçåæ´ï¼é£ä¹æ好æ¯è®©è¿äºç»ä»¶å¨æ¸²æå±ä¿æåæ ·ï¼ä» æ´æ°æ°æ®æååçèç¹ãWeex æä¾äº `track-by` ç¹æ§æ¥è¾ å©å¤æåªäºæ°ç»é¡¹ç®åçäºæ¹åã - -é¦å `track-by` ç¹æ§çå¼å¿ é¡»æ¯å¨æ¯ä¸æ¡æ°ç»é¡¹ç®ä¸é½æä¸å¼æ²¡æéå¤çä¸ä¸ªå段åï¼ç¨æ¥åºåå追踪æ¯ä¸æ¡æ°æ®é¡¹å¢å ä¸å¦æ次åºååä¸å¦çå ³é®ä¾æ®ãæ¯å½æ°ç»åçååä¹åï¼æ°èæ°ç»æ°æ®ä¼æ ¹æ® `track-by` ç¹æ§å¼æ代表çå段éæ°å¹é ï¼ç¶ååå³å®æ¸²æå±åºè¯¥æ°å»ºæå é¤ä¸ä¸ªç»ä»¶ï¼è¿æ¯ç§»å¨ä¸ä¸ªç»ä»¶ï¼è¿æ¯è®²ç»ä»¶ä¿æåæ¥çä½ç½®ãé»è®¤ç `track-by` çå¼å°±æ¯æ°ç»çç´¢å¼å¼ãä¾å¦ï¼ - -``` html -<template> - <div> - <div repeat="person in list" class="{{person.gender}}"> - <text>{{$index}} - {{person.id}} - {{person.nickname}}</text> - </div> - <text>----</text> - <div repeat="person in list" class="{{person.gender}}" track-by="id"> - <text>{{$index}} - {{person.id}} - {{person.nickname}}</text> - </div> - <text>----</text> - <!-- something wrong here: duplicated track-by value --> - <div repeat="person in list" class="{{person.gender}}" track-by="nickname"> - <text>{{$index}} - {{person.id}} - {{person.nickname}}</text> - </div> - </div> -</template> - -<style> - .male { background-color: #9999ff; } - .female { background-color: #ff9999; } -</style> - -<script> -module.exports = { - data: { - list: [ - { id: 11, gender: 'male', nickname: 'Li Lei' }, - { id: 22, gender: 'female', nickname: 'Han Meimei' }, - { id: 33, gender: 'male', nickname: 'Jim Green' } - ] - }, - ready: function () { - this.list.unshift({ id: 44, gender: 'female', nickname: 'Han Meimei' }) - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/c124bfc21e6d92271356acbea232089b) - -è¿ç§æ åµä¸ï¼ç¬¬ä¸ä¸ªå表çæ´æ°çç¥æ¯ï¼ - -1. æ第ä¸ä¸ª `<text>` èµå¼ä¸º `Han Meimei` -2. 第äºä¸ªèµå¼ä¸º `Li Lei` -3. 第ä¸ä¸ªèµå¼ä¸º `Han Meimei` -4. æåæ°å»ºä¸ä¸ª `<text>` 并èµå¼ä¸º `Jin Green` - -第äºä¸ªå表çæ´æ°çç¥æ¯ï¼ - -1. å¨æåé¢æ°å»ºä¸ä¸ª `<text>` 并èµå¼ä¸º `Han Meimei` - -第ä¸ä¸ªå表çæ´æ°ä¼éå°é®é¢ï¼å 为æ两个æ°ç»é¡¹ç®ç `nickname` å¼é½æ¯ `Han Meimei` æ以é æææä¹å¤ç渲æç»æ (åªæ¸²æäºä¸ä¸ªæ°ç»é¡¹ç®)ã - -ä¸ä¸èï¼[渲æè¿ç¨æ§å¶](./render-logic.html)
http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/guide/syntax/events.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/guide/syntax/events.md b/doc/source/cn/v-0.10/guide/syntax/events.md deleted file mode 100644 index 4898219..0000000 --- a/doc/source/cn/v-0.10/guide/syntax/events.md +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: äºä»¶å¤ç -type: guide -order: 3.3 -version: 0.10 ---- - -# äºä»¶å¤ç - -Weex å 许对 `<template>` ä¸çå ç´ ç»å®äºä»¶å¤çå½æ°ã - -## åºæ¬è¯æ³ - -以 `on...` å¼å¤´çå°±æ¯ç¨äºç»å®äºä»¶çç¹æ§ï¼ç¹æ§åä¸ `on` ä¹åçé¨åå°±æ¯äºä»¶çç±»åï¼ç¹æ§çå¼å°±æ¯å¤ç该äºä»¶çå½æ°åã_å½æ°åå¤ä¸éè¦æ·»å mustache è¯æ³ä¸ç大æ¬å·_ãä¾å¦ï¼ - -```html -<template> - <div> - <text onclick="toggle">Toggle: {{result}}</text> - </div> -</template> - -<script> - module.exports = { - data: { - result: true - }, - methods: { - toggle: function () { - this.result = !this.result - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/2f9f910a60ffc1ed54c797390d6615e1) - -## å èäºä»¶å¤çåæ° - -åæ¶æ们ä¹æ¯æå¨äºä»¶ç»å®çç¹æ§å¼ä¸å èåæè¢«ä¼ å ¥çåæ°ãä¾å¦ï¼ - -```html -<template> - <div> - <text onclick="update(1, 2)">Result: {{result}}</text> - </div> -</template> - -<script> - module.exports = { - data: { - result: '<empty>' - }, - methods: { - update: function (x, y) { - this.result = x + y - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/777056d8985e73567464e2d66cbe73fc) - -## ç¹æ®çå èäºä»¶å¤çåæ° - -é¢å¤çï¼å¨è¿ç§å èçäºä»¶ç»å®åæ³ä¸ï¼ä½ å¯ä»¥ä½¿ç¨ä¸ä¸ªç¹æ®çåæ° `$event`ï¼ä»£è¡¨äºä»¶æ述对象ï¼å³é»è®¤äºä»¶å¤çå½æ°ç第ä¸ä¸ªåæ°ãæ以 `<template>` ä¸ç `onclick="foo"` å `onclick="foo($event)"` æ¯çä»·çï¼`$event` çç¨æ³å¯ä»¥æ´å¤åèä¸é¢çä¾å - -```html -<template> - <div> - <text onclick="update($event, 1, 2)">Result: {{result}}</text> - </div> -</template> - -<script> - module.exports = { - data: { - result: '<empty>' - }, - methods: { - update: function (e, x, y) { - this.result = e.type + (x + y) - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/5e1e7c22f036725e44c3ff492f173400) - -## äºä»¶æ述对象 - -æ¯å½ä¸æ¬¡äºä»¶è¢«è§¦åçæ¶åï¼é½ä¼äº§çä¸ä¸ªäºä»¶æ述对象ï¼è¯¥å¯¹è±¡ä¼é»è®¤ä½ä¸ºç¬¬ä¸ä¸ªåæ°ä¼ éç»äºä»¶å¤çå½æ°ï¼æ以 `$event` å½¢åçæ¹å¼åºç°å¨å èäºä»¶å¤çå½æ°ä¸ã - -æ¯ä¸ªäºä»¶æ述对象è³å°å å«ä»¥ä¸å 个ç¹æ§ï¼ - -- `type` (`string`): äºä»¶å称, å¦: `click` -- `target` (`Element`): ç®æ å ç´ -- `timestamp` (`number`): äºä»¶è§¦åæ¶çæ¶é´æ³æ°å - -ä¸ä¸èï¼[å±ç¤ºé»è¾æ§å¶](./display-logic.html) http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/guide/syntax/id.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/guide/syntax/id.md b/doc/source/cn/v-0.10/guide/syntax/id.md deleted file mode 100644 index 0a204ad..0000000 --- a/doc/source/cn/v-0.10/guide/syntax/id.md +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: æ¾èç¹ -type: guide -order: 3.7 -version: 0.10 ---- - -# æ¾èç¹ - -å¨ Weex ä¸ï¼æ¨å¯ä»¥éè¿å¨ç¹å®çåç»ä»¶ä¸è®¾ç½® `id` ç¹æ§ï¼ä»¥æ¤å¨è¯¥ `<template>` å å¯ä¸æ è¯è¿ä¸ªç»ä»¶ã - -## è·ååç»ä»¶ - -æ¨å¯ä»¥å¨ç¶ç»ä»¶ä¸ä¸æä¸ä½¿ç¨ `this.$el(id)` æ¥æ¾å°è¯¥ç»ä»¶ï¼ä»¥è¿ç¨ `scrollToElement()` 为ä¾ï¼ - -```html -<template> - <div> - <text id="goto-top">Top</text> - <div style="height: 10000; background-color: #999999;"></div> - <text onclick="back2Top">Back to Top</text> - </div> -</template> -<script> - var dom = require('@weex-module/dom') - module.exports = { - methods: { - back2Top: function () { - var el = this.$el('goto-top') - dom.scrollToElement(el, { offset: 10 }) - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/ed07068ef6f038d6c39af6c971ad08a0) - -### `id` å `repeat` ç¹æ§é åä½¿ç¨ - -`id` ä¹å¯ä»¥å `repeat` è¯æ³é å使ç¨ï¼å ³äº `repeat` æ´å¤è¯¦è§ [å±ç¤ºé»è¾æ§å¶](./display-logic.html)ï¼ä½æ¯è¦ç¡®ä¿å¾ªç¯çèç¹éè¦ç¨ä¸åç `id`ï¼æ¯å¦ï¼ - -```html -<template> - <div> - <image - repeat="image in images" - id="img-{{image.id}}" - src="{{image.url}}" - onclick="getImageId"></image> - </div> -</template> -<script> -module.exports = { - data: { - images: [ - {id: 1, url: '...'}, - {id: 2, url: '...'}, - {id: 3, url: '...'}, - ... - ] - }, - methods: { - getImageId: function(e) { - // get e.target.id - } - } -} -</script> -``` - -### è·åèªå®ä¹åç»ä»¶çä¸ä¸æ - -å¦å¤ï¼æ们è¿å¯ä»¥éè¿ `this.$vm(id)` æ¹æ³å¯ä»¥è®¿é®èªå®ä¹åç»ä»¶çä¸ä¸æï¼ - -```html -<element name="foo"> - <template> - <div style="flex-direction: row;"> - <text>{{title}}</text> - </div> - </template> - <script> - module.exports = { - data: { - title: null - }, - methods: { - setTitle: function (text) { - this.title = text - } - } - } - </script> -</element> - -<template> - <div> - <foo id="sub" title="Hello"></foo> - <text onclick="update">Click Me to Update</text> - </div> -</template> -<script> - module.exports = { - methods: { - update: function (e) { - this.$vm('sub').setTitle('Updated') - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/1d332e6c238462e841743035c6bc697e) - -å®é ä¸ï¼å¦ä¸è¿°çä¾åï¼æ们æ¾å°åç»ä»¶ä¸ä¸æä¹åï¼ç´æ¥å¨è¿ä¸ªä¸ä¸æä¸è°ç¨åç»ä»¶æ¹æ³æä¿®æ¹åç»ä»¶çæ°æ®å¹¶ä¸æ¯æ们认为æ好çæ¹å¼ï¼æ们æ´å¾åäºéè¿ä¸å¥ç¡®å®çç»ä»¶é´éä¿¡æºå¶æ¥å®æè¿ä¸å·¥ä½ã - -### è·åç¶çº§ç»ä»¶æå ¶ä¸ä¸æ - -é¤äºå¯ä»¥èªä¸èä¸å¯»æ¾ç»ä»¶æå ¶ä¸ä¸æï¼Weex ä¹æ¯æèªä¸èä¸åç¸åçäºæ ãå½åä¸ä¸æä¸ç `this._parent` å¯ä»¥è·åå ¶ç¶çº§ä¸ä¸æãé¤äºç¶çº§ä¸ä¸æï¼å¯¹äºç¶çº§ç»ä»¶æ¬èº«ï¼ç¸å ³å¤çä¹å¯ä»¥åºäºå è·åç¶çº§ä¸ä¸æï¼ç¶åå¨ç¶çº§ç»ä»¶å é¨å®ææ´å¤æ´ç»è´çå¤çãæ´å¤å 容å¯ä»¥æ·±å ¥äºè§£ç»ä»¶é´éä¿¡çé¨åã - -_注æäºé¡¹ï¼å¨æªæ¥ççæ¬ä¸ `this._parent` å°æ¹ä¸º `this.$parent`ã_ - -ä¸ä¸ç¯ï¼ [ç»ä»¶é´éä¿¡](./comm.html) http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/guide/syntax/index.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/guide/syntax/index.md b/doc/source/cn/v-0.10/guide/syntax/index.md deleted file mode 100644 index df0c33a..0000000 --- a/doc/source/cn/v-0.10/guide/syntax/index.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: è¯æ³ä»ç» -type: guide -order: 3 -has_chapter_content: true -version: 0.10 ---- - -# è¯æ³ç»¼è¿° - -Weex 代ç ç± `<template>`ã`<style>`ã`<script>` ä¸ä¸ªé¨åææã - -- `<template>`ï¼_å¿ é¡»ç_ï¼ä½¿ç¨ HTML è¯æ³æ述页é¢ç»æï¼å 容ç±å¤ä¸ªæ ç¾ç»æï¼ä¸åçæ ç¾ä»£è¡¨ä¸åçç»ä»¶ã -- `<style>`ï¼_å¯éç_ï¼ä½¿ç¨ CSS è¯æ³æ述页é¢çå ·ä½å±ç°å½¢å¼ã -- `<script>`ï¼_å¯éç_ï¼ä½¿ç¨ JavaScript æ述页é¢ä¸çæ°æ®å页é¢çè¡ä¸ºï¼Weex ä¸çæ°æ®å®ä¹ä¹å¨ `<script>` ä¸è¿è¡ã - -```html -<template> - <!-- (required) the structure of page --> -</template> - -<style> - /* (optional) stylesheet */ -</style> - -<script> - /* (optional) the definition of data, methods and life-circle */ -</script> -``` - -è¿æ¯ä¸ä¸ªå ¸åç M-V-VM æ¶æï¼éè¿ ViewModel æ Model å View 建ç«æ´ç´æ¥ææçå ³ç³»ï¼ViewModel çå®ç°ä»¥ `<script>` çå 容为主ã - -## `<template>` æ¨¡æ¿ - -`<template>` ä¸çæ ç¾ç»ç»ç±»ä¼¼å¦ä¸ä»£ç ï¼ - -``` html -<template> - <div> - <image style="width: 200; height: 200;" src="https://gtms02.alicdn.com/tps/i2/TB1QHKjMXXXXXadXVXX20ySQVXX-512-512.png"></image> - <text>Alibaba Weex Team</text> - </div> -</template> -``` - -[ä½éªä¸ä¸](http://dotwe.org/5256e6e610ded330369f2e8010f7f0e6) - -`<div>` æ ç¾æ¯ä¸ä¸ªæ ¹èç¹ï¼éé¢å å«æè¿°å¾çç `<image>` æ ç¾åæè¿°æåç `<text>` æ ç¾ã - -å HTML 类似ï¼ä¸åæ ç¾ä»£è¡¨çç»ä»¶æåèªçç¹æ§ (attribute)ï¼é¨åç»ä»¶å¯ä»¥æ¥æèªå·±çåç»ä»¶ã - -延伸é 读ï¼[å ç½®ç»ä»¶å表](../../references/components/index.html) - -æ ¹èç¹ï¼æ¯ä¸ª Weex 页é¢æ顶å±çèç¹ï¼æä»¬ç§°ä¸ºæ ¹èç¹ãä¸é¢æ¯ç®åæ们æ¯æçä¸ç§æ ¹èç¹ï¼ - -- `<div>`ï¼æ®éæ ¹èç¹ï¼æç¡®å®ç尺寸ï¼ä¸å¯æ»å¨ã -- `<scroller>`ï¼å¯æ»å¨æ ¹èç¹ï¼éç¨äºéè¦å ¨é¡µæ»å¨çåºæ¯ã -- `<list>`ï¼åè¡¨æ ¹èç¹ï¼éç¨äºå ¶ä¸å å«éå¤çåå ç´ çå表åºæ¯ã - -ç®å Weex ä» æ¯æ以ä¸ä¸ç§æ ¹èç¹ã - -_注æäºé¡¹ï¼`<template>` åªæ¯æä¸ä¸ªæ ¹èç¹ï¼å¤ä¸ªæ ¹èç¹å°æ æ³è¢« Weex æ£å¸¸çè¯å«åå¤çã_ - -## `<style>` æ ·å¼ - -æ们å¯ä»¥æ Weex ä¸çæ ·å¼è¯æ³ç解为 CSS çä¸ä¸ªåéï¼ä¸¤è æä¸äºç»å¾®çåºå« - -第ä¸ç§åæ³æ¯ï¼ä½ è½å¨æ ç¾ä¸ï¼ç´æ¥éè¿å è `style` ç¹æ§ç¼åæ ·å¼. 第äºç§åæ³ï¼éè¿æ ç¾ä¸ç `class` ç¹æ§ä¸ `<style>` æ ç¾ä¸å®ä¹çæ ·å¼å»ºç«å¯¹åºå ³ç³»ï¼è®© `<style>` æ ç¾ä¸å®ä¹çæ ·å¼ä½ç¨äºç¹å®æ ç¾ä¹ä¸ã以ä¸æ¯ä¾åï¼ - -```html -<template> - <div> - <text style="font-size: 64;">Alibaba</text> - <text class="large">Weex Team</text> - </div> -</template> - -<style> - .large {font-size: 64;} -</style> -``` - -[ä½éªä¸ä¸](http://dotwe.org/d8af9186bf045df74e7a538d91798db4) - -ä¸é¢ç两个 `<text>` ç»ä»¶é½è¢«è®¾ç½®äºåæ ·çåä½å¤§å°ï¼ä½åå«ç¨äºä¸¤ç§ä¸åçæ¹å¼ã - -延伸é 读ï¼[Weex éç¨æ ·å¼](../references/common-style.html) - -**注æ**ï¼Weex éµå¾ª [HTML ç¹æ§](https://en.wikipedia.org/wiki/HTML_attribute) å½åè§èï¼æ以ç¹æ§å½åæ¶**请ä¸è¦ä½¿ç¨éå³°æ ¼å¼ (CamelCase)**ï¼éç¨ä»¥â-âåå²ç **long-name** å½¢å¼ã - -## `<script>` èæ¬ - -`<script>` æ述页é¢ä¸çæ°æ®å页é¢çè¡ä¸ºï¼ä»£ç éµå¾ª JavaScript (ES5) è¯æ³ (ç®å iOS 端åæµè§å¨ç«¯åå³äºå ç½® JavaScript å¼æ对 ES çæ¬çæ¯ææ åµï¼å®å端è½å¤å®æ´æ¯æ ES5ï¼ä½ä¸åçæ¯æ ES6ï¼éè¦ç¨ç±»ä¼¼ [babel](http://babeljs.io) çå·¥å ·å¯¹æºä»£ç è¿è¡è½¬æ¢)ãä¸é¢æ¯ä¸ä¸ªä¾åï¼ - -``` html -<template> - <div> - <text>The time is {{datetime}}</text> - <text>{{title}}</text> - <text>{{getTitle()}}</text> - </div> -</template> - -<script> - module.exports = { - data: { - title: 'Alibaba', - datetime: null - }, - methods: { - getTitle: function () { - return 'Weex Team' - } - }, - created: function() { - this.datetime = new Date().toLocaleString() - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/8095bed0d9db4299fb39975d4b35b13f) - -ä¸é¢ `<script>` æ ç¾ä¸å®ä¹äºè¢«èµå¼ç» `module.exports` ç对象ï¼è¿ä¸ªå¯¹è±¡å ¶å®å°±æ¯ä¸ä¸ª ViewModel é项ï¼è®©ä¸ä¸ª `<text>` æ ç¾æ¾ç¤ºå½åæ¶é´ãâAlibabaâåæ ·åâWeex Teamâåæ ·ã - -é项ä¸ç `data` ç¨äºåå¨æ°æ®ï¼è¿äºæ°æ®å¯ä»¥éè¿[æ°æ®ç»å®](./data-binding.html)æºå¶å `<template>` æ ç¾ä¸çå 容ç»å®èµ·æ¥ãå½è¿äºæ°æ®åæ´æ¶ï¼è¢«ç»å®ç模æ¿å 容ä¹ä¼èªå¨æ´æ°ãè¿äºæ°æ®å¨ `<script>` ä¸çå个æ¹æ³ä¸å¯ä»¥éè¿ç±»ä¼¼ `this.x` çæ¹å¼è¿è¡è¯»åæä½ã - -èé项ä¸ç `methods` éåååºäºå½åä¸ä¸æå¯æ§è¡çåç§å½æ°ï¼æ¯å¦ `getTitle()`ã - -é项ä¸æåç `created` æ¯çå½å¨æå½æ°ï¼ä¼å¨æ°æ®åå§åä¹åãçé¢è¢«ç»å®æ°æ®å¹¶æ¸²æä¹åæ§è¡ã类似ççå½å¨æå½æ°è¿æ `init`ã`ready` çï¼å¨è¿ä¸ªä¾åä¸ï¼`datetime` ä¼å¨çé¢æ¸²æä¹å被æ´æ°ä¸ºå½åçæ¶é´ã - -延伸é 读ï¼[ViewModel é项](../../references/component-defs.html) - -æ¥ä¸æ¥ï¼æ们æ¥è¯¦ç»ä»ç»[æ°æ®ç»å®](./data-binding.html)çç¸å ³ç¥è¯ã http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/guide/syntax/render-logic.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/guide/syntax/render-logic.md b/doc/source/cn/v-0.10/guide/syntax/render-logic.md deleted file mode 100644 index f516733..0000000 --- a/doc/source/cn/v-0.10/guide/syntax/render-logic.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: 渲æè¿ç¨æ§å¶ -type: guide -order: 3.5 -version: 0.10 ---- - -# 渲æè¿ç¨æ§å¶ - -## `append` - -`append` ç¹æ§å®ä¹äºå½åç»ä»¶çåç»ä»¶ï¼ - -1. 以ä¸æ´æ£µæ çæ¹å¼ä¸æ¬¡æ§æ·»å å°è§å¾ä¸ (`append="tree"`)ï¼è¿æ¯ -2. æ¯ä¸ªåç»ä»¶é½äº§çä¸æ¬¡åç¬çæ·»å å°è§å¾çæ令 (`append="node"`) - -``` html -<template> - <div> - <div> - <text>Hello</text> - <text>Weex</text> - </div> - <div append="node"> - <text>Hello</text> - <text>Weex</text> - </div> - <div append="tree"> - <text>Hello</text> - <text>Weex</text> - </div> - </div> -</template> -``` - -[ä½éªä¸ä¸](http://dotwe.org/417c75415efce66d8e22bf5942b380ee) - -å¨ä¸é¢ç代ç ä¸ï¼ç¬¬ä¸ç»å第äºç» `<div>` ç渲æè¿ç¨ç¸åï¼å³å æ·»å 空çç¶çº§ `<div>`ï¼ç¶åæå ¥ç¬¬ä¸ä¸ª `<text>` Helloï¼ç¶åæå ¥ç¬¬äºä¸ª `<text>` Weexï¼ç¬¬ä¸ç» `<div>` åæ¯è¿å¸¦ä¸¤ä¸ª `<text>` åç»ä»¶ä¸é½ä¼ ç»æ¸²æå±è¿è¡æ¸²æçã - -渲æç»ææ¾èæè§ï¼å两ç»æ¸²ææ¹å¼ä¼ä½¿é¦æ¬¡ç»å¶çååºé度æ¯åè å¿«äºï¼ä½æ¯æ»æ¸²ææ¶é´å¯è½æ¯ç¬¬ä¸ç» `append="tree"` æ´é¿ãå¼åè å¯ä»¥æ ¹æ®å®é çé¢çæ åµèªè¡éæ©åçç渲æè¿ç¨ã - -é»è®¤æ åµä¸ï¼é¤äº `<cell>` ç»ä»¶çé»è®¤æ¸²æè¿ç¨æ¯ `tree` 模å¼ï¼å ¶å®ç»ä»¶é½é»è®¤æç § `node` 模å¼è¿è¡æ¸²æã - -ä¸ä¸èï¼[èªå®ä¹ç»ä»¶](./composed-component.html) http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/guide/syntax/style-n-class.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/guide/syntax/style-n-class.md b/doc/source/cn/v-0.10/guide/syntax/style-n-class.md deleted file mode 100644 index afe2de1..0000000 --- a/doc/source/cn/v-0.10/guide/syntax/style-n-class.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: CSS æ ·å¼åç±» -type: guide -order: 3.2 -version: 0.10 ---- - -# CSS æ ·å¼åç±» - -## åºç¡è¯æ³ - -CSS æ ·å¼å¯ä»¥ç解为ä¸ç³»åçé®å¼å¯¹ï¼å ¶ä¸çæ¯ä¸å¯¹æè¿°äºä¸ä¸ªç¹å®çæ ·å¼ï¼ä¾å¦ç»ä»¶ç宽æè é«ã - -```css -.div { - width: 400; - height: 50; -} -``` - -é®å¼å¯¹çå½¢å¼æ¯ `prop-name: prop-value;`ãé®åæ¯ `prop-name`ï¼é®å¼æ¯ `prop-value`ã ä¸è¬æ åµä¸ï¼é®åæç §è¿æ¥ç¬¦çæ¹å¼è¿è¡å½åï¼é®åå¼ä¹é´ç±åå· `:` è¿è¡åéï¼æ¯å¯¹é®å¼ä¹é´ç±åå· `;` è¿è¡åéã - -å¨ Weex 页é¢ä¸æ ·å¼æ两ç§å½¢å¼ï¼ - -- `<template>` ä¸ç `style` ç¹æ§ -- `<style>` æ ·å¼è¡¨ - -### `<template>` ä¸ç `style` ç¹æ§ - -å¨ `style` ç¹æ§ä¸ç¼åæ ·å¼ï¼ä¾å¦ï¼ - -```html -<template> - <div style="width: 400; height: 50;"> - ... - </div> -</template> -``` - -è¿æ®µä»£ç çæææ¯ `<div>` ç»ä»¶ç宽åé«åå«ä¸º 400 åç´ å 50 åç´ ã - -### `<style>` æ ·å¼è¡¨ - -ä¾å¦: - -```html -<style> - .wrapper { width: 600; } - .title { width: 400; height: 50; } - .highlight { color: #ff0000; } -</style> -``` - -æ ·å¼è¡¨å å«äºå¤ä¸ªæ ·å¼è§åï¼æ¯æ¡è§åæä¸ä¸ªå¯¹åºçç±»ï¼ä»¥åç± `{...}` å æ¬çè¥å¹²æ¡æ ·å¼ãä¾å¦ï¼ - -```css -.title { width: 400; height: 50; } -``` - -### `class` ç¹æ§ - -`<template>` æ ç¾ä¸ç `class` ç¹æ§å¼ç¨æ¥å¹é `<style>` æ ·å¼è¡¨ä¸çä¸ä¸ªæå¤ä¸ª class åï¼å¤ä¸ª class name ä¹é´ç±ç©ºæ ¼åéãä¾å¦ï¼ - -```html -<template> - <div class="wrapper"> - <text class="title">...</text> - <text class="title highlight">...</text> - </div> -</template> -<style> - .wrapper { width: 600; } - .title { width: 400; height: 50; } - .highlight { color: #ff0000; } -</style> -``` - -[ä½éªä¸ä¸](http://dotwe.org/8487e2a33cd051c9adfa887d0bafbb44) - -è¿æ®µä»£ç çå«ä¹æ¯ `<div>` ç»ä»¶çå®½åº¦æ¯ 600 åç´ ï¼ä¸¤ä¸ª `<text>` ç»ä»¶ç尺寸为 400x50ï¼å ¶ä¸ç¬¬äºä¸ªææ¬ç»ä»¶æ¯çº¢è²åã - -**注æäºé¡¹** - -- 为äºç®å页é¢è®¾è®¡åå®ç°ï¼å±å¹ç宽度ç»ä¸ä¸º 750 åç´ ï¼ä¸å设å¤å±å¹é½ä¼æç §æ¯ä¾è½¬å为è¿ä¸å°ºå¯¸è¿è¡é¿åº¦è®¡ç®ã -- æ å CSS æ¯æå¾å¤æ ·å¼éæ©å¨ï¼ä½ Weex ç®ååªæ¯æå个 class name çéæ©å¨ã -- æ å CSS æ¯æå¾å¤çé¿åº¦åä½ï¼ä½ Weex ç®ååªæ¯æåç´ ï¼å¹¶ä¸ `px` åä½å¯ä»¥å¿½ç¥ä¸åï¼ç´æ¥ä½¿ç¨å¯¹åºçæ°å¼ãæ´å¤è¯¦æ 请æ¥ç[éç¨æ ·å¼](../references/common-style.html)ã -- åå ç´ çæ ·å¼ä¸ä¼ç»§æ¿èªç¶å ç´ ï¼è¿ä¸ç¹ä¸æ å CSS ä¸åï¼æ¯å¦ `color` å `font-size` çæ ·å¼ä½ç¨å¨ `<text>` ä¸å±ç `<div>` ä¸æ¯æ æçã -- æ å CSS å å«äºé常å¤çæ ·å¼å±æ§ï¼ä½ Weex åªæ¯æäºå ¶ä¸çä¸é¨åï¼æ¯å¦ç模åãflexboxãposition çå¸å±å±æ§ï¼ä»¥å `font-size`ã`color` çå ¶å®æ ·å¼ã - -## ä¸æ°æ®ç»å®ç»å - -请æ¥é [æ°æ®ç»å®](./data-binding.html)ä¸æå ³ `style` å `class` ç¹æ§çç¸å ³é¨åãè¿éç®å举个ä¾åï¼ - -```html -<template> - <div> - <text style="font-size: {{fontSize}};">Alibaba</text> - <text class="large {{textClass}}">Weex Team</text> - </div> -</template> -<style> - .large {font-size: 32;} - .highlight {color: #ff0000;} -</style> -<script> - module.exports = { - data: { - fontSize: 32, - textClass: 'highlight' - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/440d3318dc7b83e3bb0a110f3b3236ca) - -ä¸ä¸ç¯ï¼[äºä»¶å¤ç](./events.html) http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/index.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/index.md b/doc/source/cn/v-0.10/index.md deleted file mode 100644 index 9e59b8c..0000000 --- a/doc/source/cn/v-0.10/index.md +++ /dev/null @@ -1,5 +0,0 @@ -layout: index -type: index -subtitle: å¿«éãç®æ´ä¸é«æ -version: 0.10 ---- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/api.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/api.md b/doc/source/cn/v-0.10/references/api.md deleted file mode 100644 index e3e5e4b..0000000 --- a/doc/source/cn/v-0.10/references/api.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: ViewModel APIs -type: references -order: 1.3 -version: 0.10 ---- - -# æ¥å£ - -ä½ å¯ä»¥å¨ç»ä»¶çæ¹æ³ä¸éè¿ `this` ï¼Vmï¼ä¸ä¸æ访é®è¿äº APIã - -ä¾åï¼ - -```html -<script> -module.exports = { - methods: { - somemethod: function() { - this.$vm('someId'); - } - } -} -</script> -``` - -## $(id) - -**ä¸å»ºè®®ä½¿ç¨**ï¼è¯·ä½¿ç¨ `$vm` 代æ¿ã -## $el(id) - -è¿åå¯¹åº id çå ç´ å¯¹è±¡çå¼ç¨ã -### Arguments -- `id` _(string)_: å¯ä¸æ è¯ç¬¦ã -### Returns -- _(Element)_: ä¸ä¸ªå ç´ å¯¹è±¡çå¼ç¨ã -### Tips -- id åªè½ä¿è¯æ¯å½åï¼é¡µé¢ï¼ç»ä»¶ä¸æ¯å¯ä¸çï¼å¦æä½ éè¦å¯»æ¾ç¶ç»ä»¶æåç»ä»¶ï¼ä½ å¯ä»¥å©ç¨ç»ä»¶é´çé信模å¼å®ç°ã -- 延伸é è¯»ï¼ [id](../guide/syntax/id.md)ï¼[Communicate Between Components](../guide/syntax/comm.md) -## $vm(id) - -è¿åå¯¹åº id ç vm 对象å¼ç¨ã -### Arguments -- `id` _(String)_: å¯ä¸æ è¯ç¬¦ã -### Returns -- `vm` _(Vm)_: ä¸ä¸ª Vm 对象å¼ç¨ã -### Tips -- id åªè½ä¿è¯æ¯å½åï¼é¡µé¢ï¼ç»ä»¶ä¸æ¯å¯ä¸çï¼å¦æä½ éè¦å¯»æ¾ç¶ç»ä»¶æåç»ä»¶ï¼ä½ å¯ä»¥å©ç¨ç»ä»¶é´çé信模å¼å®ç°ã -- 延伸é è¯»ï¼ [id](../guide/syntax/id.md)ï¼[Communicate Between Components](../guide/syntax/comm.md) -## $getConfig() - -è·åå½åå ¨å±ç¯å¢åéåé 置信æ¯ã -### Returns -- `config` _(object)_: é ç½®å¯¹è±¡ï¼ -- `bundleUrl` _(string)_: bundle ç urlï¼ -- `debug` _(boolean)_: æ¯å¦æ¯è°è¯æ¨¡å¼ï¼ -- `env` _(object)_: ç¯å¢å¯¹è±¡ï¼ - - `weexVersion` _(string)_: Weex sdk çæ¬ï¼ - - `appName` _(string)_: åºç¨ååï¼ - - `appVersion` _(string)_: åºç¨çæ¬ï¼ - - `platform` _(string)_: å¹³å°ä¿¡æ¯ï¼æ¯ `iOS`ã`Android` è¿æ¯ `Web`ï¼ - - `osVersion` _(string)_: ç³»ç»çæ¬ï¼ - - `deviceModel` _(string)_: 设å¤åå· **ï¼ä» åçåºç¨ï¼**ï¼ - - `deviceWidth` _(number)_: 设å¤å®½åº¦ï¼é»è®¤ä¸º `750`ï¼ - - `deviceHeight` _(number)_: 设å¤é«åº¦ã -## $call(module, method, ...args) - -**ä¸å»ºè®®ä½¿ç¨**ï¼è¯·ä½¿ç¨ `require('@weex-module/module')[method](...args)` 代æ¿ãæ¥çæ´å¤ä¿¡æ¯ï¼[modules](./modules/main)ã http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/bubble.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/bubble.md b/doc/source/cn/v-0.10/references/bubble.md deleted file mode 100644 index 74b7e98..0000000 --- a/doc/source/cn/v-0.10/references/bubble.md +++ /dev/null @@ -1,150 +0,0 @@ ---- -title: äºä»¶å泡 -type: references -order: 1.3 -version: 0.10 ---- - -# äºä»¶å泡 <span class="api-version">v0.13+</span> - -Weex 1.0 å®ç°äº W3C æ åçäºä»¶å泡æºå¶ã - -### ä½¿ç¨ - -```html -<template> - <div class="root" onclick="rootClick" bubble="true"> - <div> - <text style="font-size: 40px;">{{rootText}}</text> - </div> - <div class="outer" onclick="parentClick"> - <div> - <text style="font-size: 40px;">{{parentText}}</text> - </div> - <text class="inner" onclick="click">{{innerText}}</text> - </div> - </div> -</template> - -<script> - module.exports = { - data: { - innerText: 'click me', - parentText: '', - rootText: '' - }, - methods: { - click: function(e) { - this.innerText = 'inner bubble' - }, - parentClick: function(e) { - this.parentText = 'parent bubble' - }, - rootClick: function(e) { - this.rootText = 'root bubble' - } - } - } -</script> - -<style> - .inner { - font-size: 40px; - text-align: center; - background-color: #7a9b1b; - padding: 40px; - } - - .outer { - font-size: 40px; - text-align: center; - background-color: #9b7a1b; - padding: 120px; - } - - .root { - font-size: 40px; - text-align: center; - background-color: #7a1b9b; - padding: 80px; - } -</style> -``` - -[try it](http://dotwe.org/weex/dbfeb926e003986e2eea88c8ccdadb92) - -è¿è¡ä»¥ä¸ä»£ç ï¼ç¨å®¢æ·ç«¯æå¼ï¼ç¹å»ä¸é´çå ç´ ï¼å¯ä»¥çå°äºä»¶åä¸ä¼ æï¼ä¾æ¬¡è§¦åã - -### 注æ - -éè¦æ³¨æçæ¯: ** 为äºå ¼å®¹ä¹åççæ¬ï¼Weex é»è®¤ä¸ä¼å¼å¯äºä»¶å泡æºå¶ãéè¦å¨æ ¹å ç´ çå±æ§ä¸ï¼æ·»å `bubble="true"` æ¥å¼å¯å泡æºå¶ãå¦åï¼å°ä¸ä¼åä¸ä¼ æäºä»¶ï¼ä¿æä¸ä¹åçæ¬çææç¸åã ** - -### stopPropagation - -å¨äºä»¶å¤çå½æ°ä¸ï¼å¯ä»¥ä½¿ç¨ `e.stopPropagation()` æ¹æ³ï¼æ¥é»æ¢æ¬æ¬¡äºä»¶åä¸çä¼ éè¿ç¨ã注æï¼`e.stopPropagation()` ä¸ `bubble="true"` ä¸åï¼åè åªä¼å½±åå½åå ç´ ä»¥åç¶å ç´ çä¼ æï¼ä¸ä¼å½±ååå ç´ çä¼ æï¼åè æ¯ä¸ºäºçæ¬å ¼å®¹èå¢å çå¼å ³æºå¶ï¼ä¼å ¨å±å ³éæè å¼å¯å泡æºå¶ï¼ä¸¤è å¯ä»¥å ±ååå¨ä½¿ç¨ï¼å¦ä¸ï¼ - -```html -<template> - <div class="root" onclick="rootClick" bubble="true"> - <div> - <text style="font-size: 40px;">{{rootText}}</text> - </div> - <div class="outer" onclick="parentClick"> - <div> - <text style="font-size: 40px;">{{parentText}}</text> - </div> - <text class="inner" onclick="click">{{innerText}}</text> - </div> - </div> -</template> - -<script> - module.exports = { - data: { - innerText: 'click me', - parentText: '', - rootText: '' - }, - methods: { - click: function(e) { - this.innerText = 'inner bubble' - }, - parentClick: function(e) { - this.parentText = 'parent bubble' - e.stopPropagation() - }, - rootClick: function(e) { - this.rootText = 'root bubble' - // e.stopPropagation() - } - } - } -</script> - -<style> - .inner { - font-size: 40px; - text-align: center; - background-color: #7a9b1b; - padding: 40px; - } - - .outer { - font-size: 40px; - text-align: center; - background-color: #9b7a1b; - padding: 120px; - } - - .root { - font-size: 40px; - text-align: center; - background-color: #7a1b9b; - padding: 80px; - } -</style> -``` - -[try it](http://dotwe.org/weex/0cab45a7c62e8bebedd2ffd83a8e1256) - -è¿è¡ä»¥ä¸ä»£ç ï¼ç¨å®¢æ·ç«¯æå¼ï¼ç¹å»ä¸é´çå ç´ ï¼å¯ä»¥çå°äºä»¶åä¸ä¼ æå°ç¶å ç´ è¢«ç»æ¢ï¼ä¸å继ç»å¾æ ¹å ç´ ä¼ æã http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/cheatsheet.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/cheatsheet.md b/doc/source/cn/v-0.10/references/cheatsheet.md deleted file mode 100644 index 777abf6..0000000 --- a/doc/source/cn/v-0.10/references/cheatsheet.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: Weex å¿«æ¥æå -type: references -order: 6 -version: 0.10 ---- - -# Weex å¤å¿å½ - -## Native ç»ä»¶ -<style> -code { - word-break: break-all; -} -</style> - -| ç»ä»¶ | ç¹æ§ | æ ·å¼ | äºä»¶ | ç¹æ®ç¶ç»ä»¶ | åç»ä»¶ | -| ---- | ---- | ---- | ---- | ---- | ---- | -| `<div>` | - | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear` | - | (any) | -| `<text>` | `value` | **box model**<br>flex<br>`position`<br>`background-color`<br>`opacity`<br>`color`<br>`font-size`<br>`font-style`<br>`font-weight`<br>`text-decoration`<br>`text-align`<br>`text-overflow`<br>`line-height` | `click`<br>`appear`<br>`disappear` | - | text only | -| `<image>` | `src` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity`<br>`resize` | `click`<br>`appear`<br>`disappear` | - | (none) | -| `<scroller>` | `show-scrollbar`<br>`scroll-direction` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear` | - | (any) | -| `<list>` | `loadmoreoffset` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear`<br>`loadmore`<br>`refresh`<br>`loading` | - | `<cell>`<br>`<header>`<br>`<refresh>`<br>`<loading>` | -| `<cell>` | - | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear` | `<list>` | (any) | -| `<slider>` | `auto-play` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear`<br>`change` | - | (any)<br>`<indicator>` | -| `<indicator>` | - | **box model**<br>**flexbox**<br>`position`<br>`item-color`<br>`item-selected-color`<br>`item-size` | `click`<br>`appear`<br>`disappear` | `<slider>` | (none) | -| `<wxc-navpage>` | `height`<br>`background-color`<br>`title`<br>`title-color`<br>`left-item-title`<br>`left-item-color`<br>`right-item-title`<br>`right-item-color`<br>`left-item-src`<br>`right-item-src` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear`<br>`naviBar.leftItem.click`<br>`naviBar.rightItem.click` | - | (any) | -| `<wxc-tabbar>` | `tab-items` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `tabBar.onClick` | - | (none) | -| `<embed>` | `src` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear` | - | (none) | -| `<web>` | `src` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear`<br>`pagestart`<br>`pagefinish`<br>`error` | - | (none) | -| `<video>` | `src`<br>`play-status`<br>`auto-play` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear`<br>`start`<br>`pause`<br>`finish`<br>`fail` | - | (none) | -| `<a>` | `href` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `click`<br>`appear`<br>`disappear` | - | (any) | -| `<input>` | `type`<br>`value`<br>`placeholder`<br>`disabled`<br>`autofocus` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity`<br>`placeholder-color`<br>`color`<br>`font-size`<br>`font-style`<br>`font-weight`<br>`text-align` | `click`<br>`appear`<br>`disappear` | - | (none) | -| `<switch>` | `checked` | **box model**<br>**flexbox**<br>`position`<br>`background-color`<br>`opacity` | `appear`<br>`disappear`<br>`input`<br>`change`<br>`focus`<br>`blur` | - | (none) | - -## Native Modules - -| module | apis | -| ---- | ---- | -| `@weex-module/dom` | `scrollToElement(node, { offset })` | -| `@weex-module/modal` | `toast({ message, duration })`<br>`alert({ message, okTitle }, callback)`<br>`confirm({ message, okTitle, cancelTitle }, callback(result))`<br>`prompt({ message, okTitle, cancelTitle }, callback(result, data))` | -| `@weex-module/stream` | `fetch({ method, url, headers, type, body }, callback({ status, ok, statusText, data, headers }), progressCallback({ readyState, status, length, statusText, headers}))` | -| `@weex-module/webview` | `goBack(ref)`<br>`goForward(ref)`<br>`reload(ref)` | -| `@weex-module/navigator` | `push({ url, animated }, callback)`<br>`pop({ animated }, callback)` | -| `@weex-module/animation` | `transition(node, { styles, duration, timingFunction, delay, transform-origin }, callback)` | - -## ç¹æ®ç模çè¯æ³ - -* `<foo x="abc">` -* `{% raw %}<foo x="{{expr}}">{% endraw %}` -* `<foo style="name1: value1; name2: value2">` -* `{% raw %}<foo style="name1: value1; name2: {{expr}}; name3: ...">{% endraw %}` -* `<foo class="a b c">` -* `{% raw %}<foo class="a {{expr}} c">{% endraw %}` -* `<foo onclick="methodName">` -* `<foo id="abc">` -* `<foo if="expr">` -* `<foo repeat="item in list">` -* `<foo repeat="(key,item) in list">` -* `<component type="foo">` -* `{% raw %}<component type="{{expr}}">{% endraw %}` - -## ViewModel APIs - -* `this.$vm(el)` -* `this.$el(el)` -* `this.$getConfig()` -* `this.$emit(type, data)` -* `this.$dispatch(type, data)` -* `this.$broadcast(type, data)` - -## ViewModel Options - -* `data` -* `methods` -* `computed` -* `init`, `created`, `ready` -* `events` - -**示ä¾ï¼** - -```javascript -module.exports = { - - data: function () { - return { - x: 1, - y: 2 - } - } - - methods: { - foo: function () { - console.log('foo') - } - }, - - computed: { - z: function () { - return this.x + this.y - } - }, - - events: { - custom: function (e) { - console.log(e) - } - }, - - init: function () {}, - created: function () {}, - ready: function () {} -} -``` http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/color-names.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/color-names.md b/doc/source/cn/v-0.10/references/color-names.md deleted file mode 100644 index 1b8a968..0000000 --- a/doc/source/cn/v-0.10/references/color-names.md +++ /dev/null @@ -1,180 +0,0 @@ ---- -title: é¢è²å称å表 -type: references -order: 1.8 -version: 0.10 ---- - -# Weex æ¯æçææé¢è²å称 - -### åºç¡é¢è²å ³é®è¯: - -| é¢è²å | åå è¿å¶RGBå¼ | -| --- | --- | -| black(é») | #000000 | -| silver(é¶) | #C0C0C0 | -| gray(ç°) | #808080 | -| white(ç½) | #FFFFFF | -| maroon(è¤ç´«çº¢) | #800000 | -| red(红) | #FF0000 | -| purple(ç´«) | #800080 | -| fuchsia(æ樱) | #FF00FF | -| green(绿) | #008000 | -| lime(ç³ç°) | #00FF00 | -| olive(æ©æ¦) | #808000 | -| yellow(é») | #FFFF00 | -| navy(æµ·åè) | #000080 | -| blue(è) | #0000FF | -| teal(æ°´é¸) | #008080 | -| aqua(æ°´è) | #00FFFF | -### æ©å±é¢è²å ³é®è¯: - -| é¢è²å | åå è¿å¶RGBå¼ | -| --- | --- | -| aliceblue | #F0F8FF | -| antiquewhite | #FAEBD7 | -| aqua | #00FFFF | -| aquamarine | #7FFFD4 | -| azure | #F0FFFF | -| beige | #F5F5DC | -| bisque | #FFE4C4 | -| black | #000000 | -| blanchedalmond | #FFEBCD | -| blue | #0000FF | -| blueviolet | #8A2BE2 | -| brown | #A52A2A | -| burlywood | #DEB887 | -| cadetblue | #5F9EA0 | -| chartreuse | #7FFF00 | -| chocolate | #D2691E | -| coral | #FF7F50 | -| cornflowerblue | #6495ED | -| cornsilk | #FFF8DC | -| crimson | #DC143C | -| cyan | #00FFFF | -| darkblue | #00008B | -| darkcyan | #008B8B | -| darkgoldenrod | #B8860B | -| darkgray | #A9A9A9 | -| darkgreen | #006400 | -| darkgrey | #A9A9A9 | -| darkkhaki | #BDB76B | -| darkmagenta | #8B008B | -| darkolivegreen | #556B2F | -| darkorange | #FF8C00 | -| darkorchid | #9932CC | -| darkred | #8B0000 | -| darksalmon | #E9967A | -| darkseagreen | #8FBC8F | -| darkslateblue | #483D8B | -| darkslategray | #2F4F4F | -| darkslategrey | #2F4F4F | -| darkturquoise | #00CED1 | -| darkviolet | #9400D3 | -| deeppink | #FF1493 | -| deepskyblue | #00BFFF | -| dimgray | #696969 | -| dimgrey | #696969 | -| dodgerblue | #1E90FF | -| firebrick | #B22222 | -| floralwhite | #FFFAF0 | -| forestgreen | #228B22 | -| fuchsia | #FF00FF | -| gainsboro | #DCDCDC | -| ghostwhite | #F8F8FF | -| gold | #FFD700 | -| goldenrod | #DAA520 | -| gray | #808080 | -| green | #008000 | -| greenyellow | #ADFF2F | -| grey | #808080 | -| honeydew | #F0FFF0 | -| hotpink | #FF69B4 | -| indianred | #CD5C5C | -| indigo | #4B0082 | -| ivory | #FFFFF0 | -| khaki | #F0E68C | -| lavender | #E6E6FA | -| lavenderblush | #FFF0F5 | -| lawngreen | #7CFC00 | -| lemonchiffon | #FFFACD | -| lightblue | #ADD8E6 | -| lightcoral | #F08080 | -| lightcyan | #E0FFFF | -| lightgoldenrodyellow | #FAFAD2 | -| lightgray | #D3D3D3 | -| lightgreen | #90EE90 | -| lightgrey | #D3D3D3 | -| lightpink | #FFB6C1 | -| lightsalmon | #FFA07A | -| lightseagreen | #20B2AA | -| lightskyblue | #87CEFA | -| lightslategray | #778899 | -| lightslategrey | #778899 | -| lightsteelblue | #B0C4DE | -| lightyellow | #FFFFE0 | -| lime | #00FF00 | -| limegreen | #32CD32 | -| linen | #FAF0E6 | -| magenta | #FF00FF | -| maroon | #800000 | -| mediumaquamarine | #66CDAA | -| mediumblue | #0000CD | -| mediumorchid | #BA55D3 | -| mediumpurple | #9370DB | -| mediumseagreen | #3CB371 | -| mediumslateblue | #7B68EE | -| mediumspringgreen | #00FA9A | -| mediumturquoise | #48D1CC | -| mediumvioletred | #C71585 | -| midnightblue | #191970 | -| mintcream | #F5FFFA | -| mistyrose | #FFE4E1 | -| moccasin | #FFE4B5 | -| navajowhite | #FFDEAD | -| navy | #000080 | -| oldlace | #FDF5E6 | -| olive | #808000 | -| olivedrab | #6B8E23 | -| orange | #FFA500 | -| orangered | #FF4500 | -| orchid | #DA70D6 | -| palegoldenrod | #EEE8AA | -| palegreen | #98FB98 | -| paleturquoise | #AFEEEE | -| palevioletred | #DB7093 | -| papayawhip | #FFEFD5 | -| peachpuff | #FFDAB9 | -| peru | #CD853F | -| pink | #FFC0CB | -| plum | #DDA0DD | -| powderblue | #B0E0E6 | -| purple | #800080 | -| red | #FF0000 | -| rosybrown | #BC8F8F | -| royalblue | #4169E1 | -| saddlebrown | #8B4513 | -| salmon | #FA8072 | -| sandybrown | #F4A460 | -| seagreen | #2E8B57 | -| seashell | #FFF5EE | -| sienna | #A0522D | -| silver | #C0C0C0 | -| skyblue | #87CEEB | -| slateblue | #6A5ACD | -| slategray | #708090 | -| slategrey | #708090 | -| snow | #FFFAFA | -| springgreen | #00FF7F | -| steelblue | #4682B4 | -| tan | #D2B48C | -| teal | #008080 | -| thistle | #D8BFD8 | -| tomato | #FF6347 | -| turquoise | #40E0D0 | -| violet | #EE82EE | -| wheat | #F5DEB3 | -| white | #FFFFFF | -| whitesmoke | #F5F5F5 | -| yellow | #FFFF00 | -| yellowgreen | #9ACD32 | http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/common-attrs.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/common-attrs.md b/doc/source/cn/v-0.10/references/common-attrs.md deleted file mode 100644 index 8ac1c0f..0000000 --- a/doc/source/cn/v-0.10/references/common-attrs.md +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: éç¨ç¹æ§ -type: references -order: 1.5 -version: 0.10 ---- - -# éç¨ç¹æ§ - -ç¹æ§ï¼attributeï¼ä¸ HTML ä¸å ç´ ç¹æ§ç±»ä¼¼ï¼æä¾äºä¸ Weex å ç´ æå ³çå ¶ä»éå ä¿¡æ¯ãææçå ç´ é½å¯ä»¥æ¥æç¹æ§, ç¹æ§æ»æ¯å¨ Weex å ç´ çèµ·å§æ ç¾ä¸å®ä¹ï¼å¹¶æ»æ¯ä»¥é®å¼å¯¹çå½¢å¼åºç°ï¼ä¾å¦ï¼`name="value"`ãå¯ä»¥ä½¿ç¨ [Mustache](https://mustache.github.io/) 对ç¹æ§å¼è¿è¡æ°æ®ç»å®ã - -**Notes!** - -Weex éµå¾ª [HTML attribute](https://en.wikipedia.org/wiki/HTML_attribute) å½åè§è, æ以请 **ä¸è¦å¨ç¹æ§ä¸ä½¿ç¨é©¼å³°é£æ ¼ï¼CamelCaseï¼** , 使ç¨`-`è¿æ¥ç¬¦ç**ç¾è串é£æ ¼ï¼kebab-caseï¼** ææ¯æ´å¥½çå½åæ¹å¼ã - -ææ Weex å ç´ é½æ¥æ以ä¸ç¹æ§ï¼ - -## id - -为 `<template>` å å®ä¹çå ç´ æå®ä¸ä¸ªå¯ä¸ç idï¼éè¿ `this.$el(id)` å¯ä»¥å®¹æå°è·åä¸ä¸ª Weex å ç´ çå¼ç¨ãæ´å¤ä¿¡æ¯å¯åè [Instance APIs](./api.html) - -```html -<template> - <div id="wrapper"> - <list class="list"> - <cell class="row" repeat="item in rows" id="item-{{$index}}"> - <text class="item-title">row {{item.id}}</text> - </cell> - </list> - </div> -</template> -<style></style> - -<script> -module.exports = { - data: { - rows:[ - {id: 1}, - {id: 2}, - {id: 3}, - {id: 4}, - {id: 5} - ] - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/b5032fa96e3e657711916148b1978ad3) - -## style - -为å ç´ å®ä¹è¡å æ ·å¼ã - -```html -<div style="width: 200px; height: 200px; color: #ff0000;"></div> -<div style="padding: {{x}}; margin: 0"></div> -``` - -## class - -为å ç´ å®ä¹ä¸ä¸ªæå¤ä¸ªç±»åï¼å¼ç¨æ ·å¼è¡¨ä¸çç±»ï¼ã - -```html -<div class="button"></div> -<div class="button {{btnStatus}}"></div> -``` - -## repeat - -æ们å¯ä»¥éè¿ `repeat` ç¹æ§æ ¹æ®ä¸ä¸ªæ°ç»è¿è¡æ¸²æï¼è¿ä»£å°çæå½åæ ç¾çå 容ã`repeat` ç¹æ§æç `item in items` å½¢å¼çç¹æ®è¯æ³ï¼å ¶ä¸ï¼`items` æ¯æ°ç»æ°æ®ï¼`item` æ¯æ°ç»å ç´ è¿ä»£çå«åã - -```html -<template> - <div> - <list class="list"> - <cell class="row" repeat="item in rows" id="item-{{$index}}"> - <text class="item-title">row {{item.id}}</text> - </cell> - </list> - </div> -</template> - -<style></style> - -<script> -module.exports = { - data: { - rows:[ - {id: 1}, - {id: 2}, - {id: 3}, - {id: 4}, - {id: 5} - ] - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/b5032fa96e3e657711916148b1978ad3) - -## if - -æä¾ä¸ä¸ªå¸å°å¼æ¥å³å®æ¯å¦æ¾ç¤ºå½åæ ç¾ãå½å¼ä¸º `true` æ¶ï¼å ç´ æ¾ç¤ºï¼ä¸º `false` æ¶å ç´ éèã - -```html -<div if="true"></div> -<div if="{{opened}}"></div> -<div if="{{direction === 'row'}}"></div> -``` - -## append - -append ç¹æ§ç¨äºæ§å¶æ¸²æ次åºãå®çå¯éå¼ä¸º `tree` æ `node`ï¼é»è®¤ä¸º `tree`ï¼ä¸æ¯ææ°æ®ç»å®ãä¸åçå¼ä¼æ§è¡ä¸åç渲æè¿ç¨ï¼ - -- `append="tree"` æ¯ä¸æ¬¡æ§æ¸²ææ´ä¸ªèç¹æ ï¼æ¸²ææ´é«æï¼ä½æ¯å¦æ页é¢å¤ªå¤§å®¹æé æè¾é¿æ¶é´çç½å±ã -- `append="node"` ææèç¹é个渲æï¼æ´ä½æ¸²æé度ç¥æ ¢ï¼ä½æ¯ç¨æ·ä½éªå¥½ä¸äºã - -éè¿ `node` å `tree` å¯ä»¥ç²¾ç»åå°æ§å¶é¡µé¢å±ç¤ºçé»è¾åé¢ç²åº¦ï¼ä¸è¬æ¯è¾å¥½çå®è·µä¸ºé¦å±ä»¥å æ `tree` 解æï¼é¦å±ä»¥å¤æ `node` 解æã - -```html -<div append="tree"></div> -<div append="node"></div> -``` - -## äºä»¶å¤ç (on...) - -å¨ Weex æ ç¾ä¸æ³¨åäºä»¶å¤çå¨ã以 `on` å äºä»¶å为 `key`ï¼äºä»¶å¤çå½æ°ä¸º `value`ã - -```html -<template> - <div class="btn" onClick="alertMsg"><text>Click me</text></div> -</template> - -<style> -.btn { - justify-content: center; - align-items: center; - width: 200; - height: 100; - background-color: #ff0000; - border-radius: 5; - color: #ffffff; -} -</style> - -<script> -var modal = require('@weex-module/modal') - -module.exports = { - data: {}, - methods: { - alertMsg: function (e) { - modal.alert({ - message: 'click', - okTitle: 'alert' - }, function() { - }) - } - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/97de59d24d7667aa91187d59123d24a6) http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/common-event.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/common-event.md b/doc/source/cn/v-0.10/references/common-event.md deleted file mode 100644 index 2554fe1..0000000 --- a/doc/source/cn/v-0.10/references/common-event.md +++ /dev/null @@ -1,492 +0,0 @@ ---- -title: éç¨äºä»¶ -type: references -order: 1.10 -version: 0.10 ---- - -# éç¨äºä»¶ - -Weex æä¾äºéè¿äºä»¶è§¦åå¨ä½çè½åï¼ä¾å¦å¨ç¨æ·ç¹å»ç»ä»¶æ¶æ§è¡ JavaScriptãä¸é¢ååºäºå¯è¢«æ·»å å° Weex ç»ä»¶ä¸ä»¥å®ä¹äºä»¶å¨ä½çå±æ§ï¼ - -## `click` - -å½ç»ä»¶ä¸åçç¹å»æå¿æ¶è¢«è§¦åã - -**注æï¼** - -`<input>` å `<switch>` ç»ä»¶ç®åä¸æ¯æ `click` äºä»¶ï¼è¯·ä½¿ç¨ `change` æ `input` äºä»¶æ¥ä»£æ¿ã - -### äºä»¶å¯¹è±¡ - -- `type`: `click` -- `target`: 触åç¹å»äºä»¶çç®æ ç»ä»¶ -- `timestamp`: 触åç¹å»äºä»¶æ¶çæ¶é´æ³ - -### ç¤ºä¾ - -ç¹å»æé®ï¼å°å¼¹åºå¼¹æ¡ï¼åç¹å»å¼¹æ¡ `Ã`ï¼å ³éå¼¹æ¡ã - -```html -<template> - <div> - <div> - <text class="btn" onclick="openDialog">Show Dialog</text> - </div> - - <div id="dialog" class="dialog" if="{{isShowDialog}}"> - <div class="dialog-backdrop"></div> - <div class="dialog-content"> - <div class="dialog-header"> - <text class="dialog-title">{{dialogTitle}}</text> - <text class="close" onclick="closeDialog">Ã</text> - </div> - <div class="dialog-body"> - <text>{{dialogBody}}</text> - </div> - </div> - </div> - </div> -</template> - -<style> -.dialog-backdrop { - opacity: .5; - position: absolute; - top: 0; - right: 0; - bottom: 0; - left: 0; - background-color: #000000; -} -.dialog { - position: fixed; - top: 0; - right: 0; - bottom: 0; - left: 0; - justify-content: center; - align-items: center; -} -.dialog-content { - width: 450; - background-color: #ffffff; -} -.dialog-header { - padding: 20; - border-bottom-width: 1; - border-bottom-style: solid; - border-bottom-color: #efefef; -} -.dialog-body { - padding: 20; -} -.close { - font-size: 50; - position: absolute; - right: 10; - top: 10; -} -.btn { - text-align: center; - color: #ffffff; - padding: 12; - background-color: #3071a9; - border-color: #285e8e; - border-radius: 4; -} -</style> - -<script> - module.exports = { - data: { - isShowDialog: false, - dialogTitle: 'HELLO', - dialogBody: 'Weex is best!' - }, - methods: { - openDialog: function (e) { - this.isShowDialog = true - }, - closeDialog: function (e) { - this.isShowDialog = false - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/6c1dd48b419e614f92581930f42fd366) - -## `longpress` - -å¦æä¸ä¸ªç»ä»¶è¢«ç»å®äº `longpress` äºä»¶ï¼é£ä¹å½ç¨æ·é¿æè¿ä¸ªç»ä»¶æ¶ï¼è¯¥äºä»¶å°ä¼è¢«è§¦åã - -**注æï¼** - -`<input>` å `<switch>` ç»ä»¶ç®åä¸æ¯æ `click` äºä»¶ï¼è¯·ä½¿ç¨ `change` æ `input` äºä»¶æ¥ä»£æ¿ã - -### äºä»¶å¯¹è±¡ -- `type` : `longpress` -- `target` : 触åé¿æäºä»¶çç®æ ç»ä»¶ -- `timestamp` : é¿æäºä»¶è§¦åæ¶çæ¶é´æ³ - -### ç¤ºä¾ - -é¿ææé®ï¼åæ¢èæ¯è²ã - -```html -<template> - <div style="width: 400; height: 200; background-color: {{bg}}; - justify-content: center; align-items: center;" onlongpress="{{update}}"> - <text style="font-size: 60">Press me</text> - </div> -</template> - -<script> - module.exports = { - data: { - bg: '#FF0000' - }, - methods: { - update: function () { - this.bg = this.bg === '#FF0000' ? '#00FF00' : '#FF0000' - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/14a646ea3d7d5e1de5baaca9061a48b3) - -## Appear äºä»¶ - -å¦æä¸ä¸ªä½äºæ个å¯æ»å¨åºåå çç»ä»¶è¢«ç»å®äº `appear` äºä»¶ï¼é£ä¹å½è¿ä¸ªç»ä»¶çç¶æå为å¨å±å¹ä¸å¯è§æ¶ï¼è¯¥äºä»¶å°è¢«è§¦åã - -### äºä»¶å¯¹è±¡ - -- `type` : `appear` -- `target` : 触å Appear äºä»¶çç»ä»¶å¯¹è±¡ -- `timestamp` : äºä»¶è¢«è§¦åæ¶çæ¶é´æ³ -- `direction` : 触åäºä»¶æ¶å±å¹çæ»å¨æ¹åï¼`up` æ `down` - -### ç¤ºä¾ - -å½æ»å°æä¸æ¹æ¶ï¼æåä¸ä¸ª `item` åºç°ï¼å°ä¼å¼¹åºå¼¹æ¡ã - -```html -<template> - <scroller onviewappear="{{viewappear}}" onviewdisappear="{{viewdisappear}}"> - <div class="item"> - <text>scroll 1</text> - </div> - <div class="item"> - <text>scroll 2</text> - </div> - <div class="item"> - <text>scroll 3</text> - </div> - <div class="item"> - <text>scroll 4</text> - </div> - <div class="item"> - <text>scroll 5</text> - </div> - <div class="item"> - <text>scroll 6</text> - </div> - <div class="item"> - <text>scroll 7</text> - </div> - <div class="item"> - <text>scroll 8</text> - </div> - <div class="item"> - <text>scroll 9</text> - </div> - <div class="item"> - <text>scroll 10</text> - </div> - <div class="item" onappear="alertMsg" > - <text>I will alert a message when I appeared.</text> - </div> - </scroller> -</template> - -<style> - .list { - height: 850; - } - - .count { - font-size: 48; - margin: 10; - } - - .indicator { - height: 40; - width: 40; - color: #45b5f0; - } - - .row { - width: 750; - } - - .item { - justify-content: center; - border-bottom-width: 2; - border-bottom-color: #c0c0c0; - height: 200; - padding: 20; - } -</style> - -<script> - var modal = require('@weex-module/modal') - module.exports = { - data: {}, - methods: { - alertMsg: function (e) { - modal.alert({ - message: 'I am appeared.', - okTitle: 'Appear' - }, function() { - }) - }, - viewappear: function () { - nativeLog('>>>>>', 'viewappear') - }, - viewdisappear: function () { - nativeLog('>>>>>', 'viewdisappear') - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/4d5335f086dfc9964caed5b1fe4b1aa7) - -## Disappear äºä»¶ - -å¦æä¸ä¸ªä½äºæ个å¯æ»å¨åºåå çç»ä»¶è¢«ç»å®äº `disappear` äºä»¶ï¼é£ä¹å½è¿ä¸ªç»ä»¶è¢«æ»åºå±å¹å为ä¸å¯è§ç¶ææ¶ï¼è¯¥äºä»¶å°è¢«è§¦åã - -### äºä»¶å¯¹è±¡ - -- `type` : `disappear` -- `target` : 触å Disappear äºä»¶çç»ä»¶å¯¹è±¡ -- `timestamp` : äºä»¶è¢«è§¦åæ¶çæ¶é´æ³ -- `direction` : 触åäºä»¶æ¶å±å¹çæ»å¨æ¹åï¼`up` æ `down` - -### ç¤ºä¾ - -å½åä¸æ»å¨å°ç¬¬ä¸ä¸ª `item` æ¶å¤±åï¼å°ä¼å¼¹åºå¼¹æ¡ã - -```html -<template> - <scroller onviewappear="{{viewappear}}" onviewdisappear="{{viewdisappear}}"> - <div class="item" ondisappear="alertMsg" > - <text>I will alert a message when I disappeared.</text> - </div> - <div class="item"> - <text>scroll 1</text> - </div> - <div class="item"> - <text>scroll 2</text> - </div> - <div class="item"> - <text>scroll 3</text> - </div> - <div class="item"> - <text>scroll 4</text> - </div> - <div class="item"> - <text>scroll 5</text> - </div> - <div class="item"> - <text>scroll 6</text> - </div> - <div class="item"> - <text>scroll 7</text> - </div> - <div class="item"> - <text>scroll 8</text> - </div> - <div class="item"> - <text>scroll 9</text> - </div> - <div class="item"> - <text>scroll 10</text> - </div> - </scroller> -</template> - -<style> - .list { - height: 850; - } - - .count { - font-size: 48; - margin: 10; - } - - .indicator { - height: 40; - width: 40; - color: #45b5f0; - } - - .row { - width: 750; - } - - .item { - justify-content: center; - border-bottom-width: 2; - border-bottom-color: #c0c0c0; - height: 200; - padding: 20; - } -</style> - -<script> - var modal = require('@weex-module/modal') - module.exports = { - data: {}, - methods: { - alertMsg: function (e) { - modal.alert({ - message: 'I am disappeared.', - okTitle: 'Disappear' - }, function() { - }) - }, - viewappear: function () { - nativeLog('>>>>>', 'viewappear') - }, - viewdisappear: function () { - nativeLog('>>>>>', 'viewdisappear') - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/eefa176009207a429bbaf475f6ee92d1) - -## Page äºä»¶ - -*注æï¼ä» æ¯æ iOS å Androidï¼H5 æä¸æ¯æã* - -Weex éè¿ `viewappear` å `viewdisappear` äºä»¶æä¾äºç®åç页é¢ç¶æ管çè½åã - -`viewappear` äºä»¶ä¼å¨é¡µé¢å°±è¦æ¾ç¤ºæé ç½®çä»»ä½é¡µé¢å¨ç»è¢«æ§è¡å触åï¼ä¾å¦ï¼å½è°ç¨ `navigator` 模åç `push` æ¹æ³æ¶ï¼è¯¥äºä»¶å°ä¼å¨æå¼æ°é¡µé¢æ¶è¢«è§¦åã`viewdisappear` äºä»¶ä¼å¨é¡µé¢å°±è¦å ³éæ¶è¢«è§¦åã - -ä¸ç»ä»¶ç `appear` å `disappear` äºä»¶ä¸åçæ¯ï¼`viewappear` å `viewdisappear` äºä»¶å ³æ³¨çæ¯æ´ä¸ªé¡µé¢çç¶æï¼æ以**å®ä»¬å¿ é¡»ç»å®å°é¡µé¢çæ ¹å ç´ ä¸**ã - -ç¹æ®æ åµä¸ï¼è¿ä¸¤ä¸ªäºä»¶ä¹è½è¢«ç»å®å°éæ ¹å ç´ çbodyç»ä»¶ä¸ï¼ä¾å¦`wxc-navpage`ç»ä»¶ã - -### äºä»¶å¯¹è±¡ - -- `type` : `viewappear` æ `viewdisappear` -- `target` : 触åäºä»¶çç»ä»¶å¯¹è±¡ -- `timestamp` : äºä»¶è¢«è§¦åæ¶çæ¶é´æ³ - -### ç¤ºä¾ - -è¿åºé¡µé¢æ¶ï¼é½ä¼å¼¹æ¡æ示ã - -```html -<template> - <scroller onviewappear="{{alertViewappearMsg}}" onviewdisappear="{{alertViewdisappearMsg}}"> - <div class="item"> - <text>scroll 1</text> - </div> - <div class="item"> - <text>scroll 2</text> - </div> - <div class="item"> - <text>scroll 3</text> - </div> - <div class="item"> - <text>scroll 4</text> - </div> - <div class="item"> - <text>scroll 5</text> - </div> - <div class="item"> - <text>scroll 6</text> - </div> - <div class="item"> - <text>scroll 7</text> - </div> - <div class="item"> - <text>scroll 8</text> - </div> - <div class="item"> - <text>scroll 9</text> - </div> - <div class="item"> - <text>scroll 10</text> - </div> - <div class="item" onappear="alertMsg" > - <text>scroll 11</text> - </div> - </scroller> -</template> - -<style> - .list { - height: 850; - } - - .count { - font-size: 48; - margin: 10; - } - - .indicator { - height: 40; - width: 40; - color: #45b5f0; - } - - .row { - width: 750; - } - - .item { - justify-content: center; - border-bottom-width: 2; - border-bottom-color: #c0c0c0; - height: 200; - padding: 20; - } -</style> - -<script> - var modal = require('@weex-module/modal') - module.exports = { - data: {}, - methods: { - alertViewappearMsg: function () { - modal.alert({ - message: 'viewappear.', - okTitle: 'viewappear' - }, function() { - }) - }, - alertViewdisappearMsg: function () { - modal.alert({ - message: 'viewdisappear.', - okTitle: 'viewdisappear' - }, function() { - }) - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/450205a8f8612381422220ce88a562ff) http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/common-style.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/common-style.md b/doc/source/cn/v-0.10/references/common-style.md deleted file mode 100644 index 8a585f2..0000000 --- a/doc/source/cn/v-0.10/references/common-style.md +++ /dev/null @@ -1,322 +0,0 @@ ---- -title: éç¨æ ·å¼ -type: references -order: 1.6 -version: 0.10 ---- - -# éç¨æ ·å¼ - -ææ Weex ç»ä»¶é½æ¯æ以ä¸éç¨æ ·å¼è§åã - -## ç模å - -![box model @300*](http://alibaba.github.io/weex/doc/images/css-boxmodel.png) - -Weex ç模ååºäº [CSS ç模å](https://www.w3.org/TR/css3-box/)ï¼æ¯ä¸ª Weex å ç´ é½å¯è§ä½ä¸ä¸ªçåãæ们ä¸è¬å¨è®¨è®ºè®¾è®¡æå¸å±æ¶ï¼ä¼æå°ãç模åãè¿ä¸ªæ¦å¿µã - -ç模åæè¿°äºä¸ä¸ªå ç´ æå ç¨ç空é´ãæ¯ä¸ä¸ªçåæåæ¡è¾¹çï¼å¤è¾¹è·è¾¹ç margin edge, è¾¹æ¡è¾¹ç border edge, å è¾¹è·è¾¹ç padding edge ä¸å 容边ç content edgeãè¿åå±è¾¹çï¼å½¢æä¸å±å±ççåå 裹起æ¥ï¼è¿å°±æ¯ç模å大ä½ä¸çå«ä¹ã - -**注æï¼** -Weex 对äºé¿åº¦å¼ç®ååªæ¯æ*åç´ *å¼ï¼åä½å¯çç¥ï¼ä¸æ¯æç¸å¯¹åä½ï¼`em`ã`rem`ï¼ã - -- `width {length}`ï¼ï¼é»è®¤å¼ 0 -- `height {length}`ï¼ï¼é»è®¤å¼ 0 -- `padding {length}`ï¼å è¾¹è·ï¼å 容åè¾¹æ¡ä¹é´çè·ç¦»ãé»è®¤å¼ 0 - - å¯æå¦ä¸åæ³ï¼ - - - `padding-left {length}`ï¼ï¼é»è®¤å¼ 0 - - `padding-right {length}`ï¼ï¼é»è®¤å¼ 0 - - `padding-top {length}`ï¼ï¼é»è®¤å¼ 0 - - `padding-bottom {length}`ï¼ï¼é»è®¤å¼ 0 -- `margin`ï¼ - - å¤è¾¹è·ï¼å ç´ åå ç´ ä¹é´ç空ç½è·ç¦»ãå¼ç±»å为 lengthï¼é»è®¤å¼ 0 - - å¯æå¦ä¸åæ³ï¼ - - - `margin-left {length}`ï¼ï¼é»è®¤å¼ 0 - - `margin-right {length}`ï¼ï¼é»è®¤å¼ 0 - - `margin-top {length}`ï¼ï¼é»è®¤å¼ 0 - - `margin-bottom {length}`ï¼ï¼é»è®¤å¼ 0 -- borderï¼ - - 设å®è¾¹æ¡ï¼`border` ç®åä¸æ¯æ类似è¿æ · `border: 1 solid #ff0000;` çç»ååæ³ã - - å¯æå¦ä¸åæ³ï¼ - - - `border-style`ï¼ - - 设å®è¾¹æ¡æ ·å¼ï¼å¼ç±»å为 stringï¼å¯éå¼ä¸º `solid` | `dashed` | `dotted`ï¼é»è®¤å¼ `solid` - - å¯æå¦ä¸åæ³ï¼ - - - `border-left-style {string}`ï¼å¯éå¼ä¸º `solid` | `dashed` | `dotted`ï¼é»è®¤å¼ `solid` - - `border-top-style {string}`ï¼å¯éå¼ä¸º `solid` | `dashed` | `dotted`ï¼é»è®¤å¼ `solid` - - `border-right-style {string}`ï¼å¯éå¼ä¸º `solid` | `dashed` | `dotted`ï¼é»è®¤å¼ `solid` - - `border-bottom-style {string}`ï¼å¯éå¼ä¸º `solid` | `dashed` | `dotted`ï¼é»è®¤å¼ `solid` - - - `border-width {length}`ï¼ - - 设å®è¾¹æ¡å®½åº¦ï¼éè´å¼, é»è®¤å¼ 0 - - å¯æå¦ä¸åæ³ï¼ - - - `border-left-width {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - `border-top-width {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - `border-right-width {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - `border-bottom-width {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - - `border-color {color}`ï¼ - - 设å®è¾¹æ¡é¢è²ï¼é»è®¤å¼ `#000000` - - å¯æå¦ä¸åæ³ï¼ - - - `border-left-color {color}`ï¼ï¼é»è®¤å¼ `#000000` - - `border-top-color {color}`ï¼ï¼é»è®¤å¼ `#000000` - - `border-right-color {color}`ï¼ï¼é»è®¤å¼ `#000000` - - `border-bottom-color {color}`ï¼ï¼é»è®¤å¼ `#000000` - - `border-radius {length}`ï¼ - - 设å®åè§ï¼é»è®¤å¼ 0 - - å¯æå¦ä¸åæ³ï¼ - - - `border-bottom-left-radius {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - `border-bottom-right-radius {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - `border-top-left-radius {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - `border-top-right-radius {length}`ï¼ï¼éè´å¼, é»è®¤å¼ 0 - - -注æï¼ç®åå¨ `<image>` å `<text>` ç»ä»¶ä¸å°æ æ³åªå®ä¹ä¸ä¸ªæå 个è§ç `border-radius`ãæ¯å¦ä½ æ æ³å¨è¿ä¸¤ä¸ªç»ä»¶ä¸ä½¿ç¨ `border-top-left-radius`ã - -Weex ç模åç `box-sizing` é»è®¤ä¸º `border-box`ï¼å³çåç宽é«å å«å 容ãå è¾¹è·åè¾¹æ¡ç宽度ï¼ä¸å å«å¤è¾¹è·ç宽度ã - -### 示ä¾ï¼ - -```html -<template> - <div> - <image style="width: 400; height: 200; margin-left: 20;" src="https://g.alicdn.com/mtb/lab-zikuan/0.0.18/weex/weex_logo_b...@3x.png"></image> - </div> -</template> -``` - -## Flexbox - -Weex å¸å±æ¨¡ååºäº CSS [`Flexbox`](http://www.w3.org/TR/css3-flexbox/)ï¼ä»¥ä¾¿ææ页é¢å ç´ çæçè½å¤ä¸è´å¯é¢æµï¼åæ¶é¡µé¢å¸å±è½éåºåç§è®¾å¤æè å±å¹å°ºå¯¸ã - -Flexbox å å« flex 容å¨å flex æå项ãå¦æä¸ä¸ª Weex å ç´ å¯ä»¥å®¹çº³å ¶ä»å ç´ ï¼é£ä¹å®å°±æ为 flex 容å¨ãéè¦æ³¨æçæ¯ï¼flexbox çèçè§èç¸è¾æ°çæäºåºå ¥ï¼æ¯å¦æ¯å¦è½æ¯æ wrappingãè¿äºé½æè¿°å¨ W3C çå·¥ä½èæ¡ä¸äºï¼ä½ éè¦æ³¨æä¸æ°èçæ¬ä¹é´çä¸åãå¦å¤ï¼èçæ¬åªå¨å®å 4.4 ç以ä¸å¾å°æ¯æã - -### Flex å®¹å¨ - -å¨ Weex ä¸ï¼Flexbox æ¯é»è®¤ä¸å¯ä¸çå¸å±æ¨¡åï¼æä»¥ä½ ä¸éè¦æå¨ä¸ºå ç´ æ·»å `display: flex;` å±æ§ã - -- `flex-direction`ï¼ - - å®ä¹äº flex 容å¨ä¸ flex æå项çæåæ¹åãå¯éå¼ä¸º `row` | `column`ï¼é»è®¤å¼ä¸º `column` - - - `column`ï¼ä»ä¸å°ä¸æåã - - `row`ï¼ä»å·¦å°å³æåã - -- `justify-content`ï¼ - - å®ä¹äº flex 容å¨ä¸ flex æå项å¨ä¸»è½´æ¹åä¸å¦ä½æå以å¤ç空ç½é¨åãå¯éå¼ä¸º `flex-start` | `flex-end` | `center` | `space-between`ï¼é»è®¤å¼ä¸º `flex-start`ã - - - `flex-start`ï¼æ¯é»è®¤å¼ï¼ææç flex æå项é½æåå¨å®¹å¨çåé¨ï¼ - - `flex-end`ï¼åæå³çæå项æåå¨å®¹å¨çåé¨ï¼ - - `center`ï¼å³ä¸é´å¯¹é½ï¼æå项æåå¨å®¹å¨ä¸é´ã两边çç½ï¼ - - `space-between`ï¼è¡¨ç¤ºä¸¤ç«¯å¯¹é½ï¼ç©ºç½ååå°å¡«å å° flex æå项ä¹é´ã - - ![justify-content @400*](http://alibaba.github.io/weex/doc/images/css-flexbox-justify.svg) - -- `align-items`ï¼ - - å®ä¹äº flex 容å¨ä¸ flex æå项å¨çºµè½´æ¹åä¸å¦ä½æå以å¤ç空ç½é¨åãå¯éå¼ä¸º `stretch` | `flex-start` | `center` | `flex-end`ï¼é»è®¤å¼ä¸º `stretch`ã - - - `stretch` æ¯é»è®¤å¼ï¼å³æ伸é«åº¦è³ flex 容å¨ç大å°ï¼ - - `flex-start` åæ¯ä¸å¯¹é½ï¼ææçæå项æåå¨å®¹å¨é¡¶é¨ï¼ - - `flex-end` æ¯ä¸å¯¹é½ï¼ææçæå项æåå¨å®¹å¨åºé¨ï¼ - - `center` æ¯ä¸é´å¯¹é½ï¼æææå项é½åç´å°å± ä¸æ¾ç¤ºã - - ![align-items @400*](http://alibaba.github.io/weex/doc/images/css-flexbox-align.jpg) - -### Flex æå项 - -flex å±æ§å®ä¹äº flex æå项å¯ä»¥å ç¨å®¹å¨ä¸å©ä½ç©ºé´ç大å°ãå¦æææçæå项设置ç¸åçå¼ `flex: 1`ï¼å®ä»¬å°å¹³ååé å©ä½ç©ºé´. å¦æä¸ä¸ªæå项设置çå¼ä¸º `flex: 2`ï¼å ¶å®çæå项设置çå¼ä¸º `flex: 1`ï¼é£ä¹è¿ä¸ªæå项æå ç¨çå©ä½ç©ºé´æ¯å ¶å®æå项ç2åã - -- `flex {number}`ï¼å¼ä¸º number ç±»åã - -### ç¤ºä¾ - -ä¸ä¸ªç®åçç½æ ¼å¸å±ã - -![mobile_preview](images/style_1.jpg) - -```html -<template> - <div> - <div repeat="(i, v) in list" class="row"> - <div repeat="(k, text) in v" class="item"> - <div> - <text>{{text}}</text> - </div> - </div> - </div> - </div> -</template> -<style> - .item{ - flex:1; - justify-content: center; - align-items:center; - border-width:1; - } - .row{ - flex-direction: row; - height:80; - } -</style> -<script> - module.exports = { - data: function () { - return { - list:[ - ['A', 'B', 'C'], - ['D', 'E', 'F'], - ['G', 'H', 'I'] - ] - } - } - } -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/ee6a898fcac2242308c24fe5882c52ac) - -ä¸ä¸ªå¨ç¸å¯¹äºå±å¹æ°´å¹³å± ä¸ï¼å ¨å±å± ä¸ç `<div>`ã - -```html -<template> - <div class="wrapper"> - <div class="box"> - </div> - </div> -</template> - -<style> - .wrapper { - position: absolute; - top: 0; - right: 0; - bottom: 0; - left: 0; - background-color: #cccccc; - justify-content: center; - align-items: center; - } - .box { - width: 200; - height: 200; - background-color: #fc0000; - } -</style> -``` - -[ä½éªä¸ä¸](http://dotwe.org/a76cd89b37c72d308ed576131830e877) - -## å®ä½ - -Weex æ¯æ `position` å®ä½ï¼ç¨æ³ä¸ CSS position 类似ã为å ç´ è®¾ç½® `position` åï¼å¯éè¿ `top`ã`right`ã`bottom`ã`left` å个å±æ§è®¾ç½®å ç´ åæ ã - -- `position {string}`ï¼ - - 设置å®ä½ç±»åãå¯éå¼ä¸º `relative` | `absolute` | `fixed` | `sticky`ï¼é»è®¤å¼ä¸º `relative`ã - - - `relative` æ¯é»è®¤å¼ï¼æçæ¯ç¸å¯¹å®ä½ï¼ - - `absolute` æ¯ç»å¯¹å®ä½ï¼ä»¥å ç´ ç容å¨ä½ä¸ºåèç³»ï¼ - - `fixed` ä¿è¯å ç´ å¨é¡µé¢çªå£ä¸ç对åºä½ç½®æ¾ç¤ºï¼ - - `sticky` æçæ¯ä» å½å ç´ æ»å¨å°é¡µé¢ä¹å¤æ¶ï¼å ç´ ä¼åºå®å¨é¡µé¢çªå£ç顶é¨ã -- `top {number}`ï¼è·ç¦»ä¸æ¹çå移éï¼é»è®¤ä¸º 0ã -- `bottom {number}`ï¼è·ç¦»ä¸æ¹çå移éï¼é»è®¤ä¸º 0ã -- `left {number}`ï¼è·ç¦»å·¦æ¹çå移éï¼é»è®¤ä¸º 0ã -- `right {number}`ï¼è·ç¦»å³æ¹çå移éï¼é»è®¤ä¸º 0ã - -**注æï¼** - -1. Weex ç®åä¸æ¯æ `z-index` 设置å ç´ å±çº§å ³ç³»ï¼ä½é åçå ç´ å±çº§æ´é«ï¼å æ¤ï¼å¯¹äºå±çº§é«çå ç´ ï¼å¯å°å ¶æåå¨åé¢ã -2. å¦æå®ä½å ç´ è¶ è¿å®¹å¨è¾¹çï¼å¨ Android ä¸ï¼è¶ åºé¨åå°**ä¸å¯è§**ï¼åå å¨äº Android 端å ç´ `overflow` é»è®¤å¼ä¸º `hidden`ï¼ä½ç®å Android æä¸æ¯æ设置 `overflow: visible`ã - -### ç¤ºä¾ - -![mobile_preview](images/style_2.jpg) - -```html -<template> - <div class="wrapper"> - <div class="box box1"> - </div> - <div class="box box2"> - </div> - <div class="box box3"> - </div> - </div> -</template> - -<style> - .wrapper { - position: absolute; - top: 0; - right: 0; - bottom: 0; - left: 0; - background-color: #cccccc; - } - .box { - width: 400; - height: 400; - position: absolute; - } - .box1 { - top: 0; - left: 0; - background-color: #ff0000; - } - .box2 { - top: 150; - left: 150; - background-color: #0055dd; - } - .box3 { - top: 300; - left: 300; - background-color: #00ff49; - } -</style> -``` - -[ä½éªä¸ä¸](http://dotwe.org/b04339de27cfabf0710e045c0079e56a) - -## å ¶ä»åºæ¬æ ·å¼ - -- `opacity {number}`ï¼åå¼èå´ä¸º [0, 1] åºé´ãé»è®¤å¼æ¯ 1ï¼å³å®å ¨ä¸éæï¼0 æ¯å®å ¨éæï¼0.5 æ¯ 50% çéæ度ã -- `background-color {color}`ï¼è®¾å®å ç´ çèæ¯è²ï¼å¯éå¼ä¸ºè²å¼ï¼æ¯æRGBï¼ `rgb(255, 0, 0)` ï¼ï¼RGBAï¼ `rgba(255, 0, 0, 0.5)` ï¼ï¼åå è¿å¶ï¼ `#ff0000` ï¼ï¼ç²¾ç®åæ³çåå è¿å¶ï¼ `#f00` ï¼ï¼è²å¼å ³é®åï¼`red`ï¼ï¼é»è®¤å¼æ¯ `transparent` ã - -**注æï¼** [è²å¼çå ³é®åå表](./color-names.md)ã - -## ä¸ææ ·å¼ - -å¦æ对äºæ ·å¼åæ³éè¦æ´å¤ä¸æåèï¼å¯åè - -- [å¦ä½ååºé«æ§è½é¿å表]() -- [å¦ä½å¸å±]() -- 以åæ¯ä¸ªç»ä»¶çææ¡£ä¸ï¼é½æ常è§çä¾åå¯ä¾åèã - -ä½ å¯ä»¥æç §ä»¥ä¸æ¥éª¤æ¥è§å Weex 页é¢çæ ·å¼ã - -1. å ¨å±æ ·å¼è§åï¼å°æ´ä¸ªé¡µé¢åå²æåéç模åã -2. flex å¸å±ï¼æåå对é½é¡µé¢æ¨¡åã -3. å®ä½çåï¼å®ä½å¹¶è®¾ç½®å移éã -4. ç»èæ ·å¼å¤çï¼å¢å ç¹å®çå ·ä½æ ·å¼ã http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/component-defs.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/component-defs.md b/doc/source/cn/v-0.10/references/component-defs.md deleted file mode 100644 index 11e4282..0000000 --- a/doc/source/cn/v-0.10/references/component-defs.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: ViewModel é项 -type: references -order: 1.2 -version: 0.10 ---- - -# ç»ä»¶å®ä¹ - -å®ä¹ç»ä»¶æ¯éè¿ä¸ç»é项æ¥æè¿°ä¸ä¸ªç»ä»¶ãè¿ç»é项æ»æ¯è¢«èµå¼ç» `<script>` æ ç¾ä¸ç `module.exports` ã - -``` javascript -module.exports = { - // a set of options here -} -``` -## æ°æ®åæ¹æ³ - -``` javascript -module.exports = { - data: function () { - return {x: 1, y: 2} - }, - methods: { - doThis: function () {...}, - doThat: function () {...} - }, - ... -} -``` - -`data` é项æ¯ä¸ä¸ªå½æ°ï¼å®è¿åè¿ä¸ªè§å¾æ¨¡åå¯çå¬çæ°æ®å¯¹è±¡ãè `methods` æ¯ä¸ä¸ªæ å°ï¼å ¶ä¸å å«ææè§å¾æ¨¡åçæ¹æ³ã - -æ¯ä¸ª `data` æ `method` å±æ§å°è¢«ä»£çå°è§å¾æ¨¡åå®ä¾ä¸ãæ以ï¼ä½ è½éè¿ `this.x` 读åæ°æ®ï¼æè éè¿ `this.doThis()` è°ç¨æ¹æ³ã - -ä¸ä¸ªå®æ´çä¾åï¼ - -```html -<template> - <div style="width: {{w}}; height: {{h}}; background-color: red;" onclick="update"></div> -</template> -<script> - module.exports = { - data: function () { - return {w: 750, h: 200} - }, - methods: { - update: function (e) { - this.h += 200 - } - } - } -</script> -``` -## äºä»¶ - -``` javascript -module.exports = { - data: ..., - methods: { - foo: function () { - ... - this.$emit('customtype1', data) - } - }, - events: { - customtype1: function (e) { - console.log(e.type, e.detail) - } - }, - ... -} -``` - -`events` é项å è®¸ä½ å¨è§å¾æ¨¡å被å建æ¶æ³¨åèªå®ä¹äºä»¶ãç¶åï¼å®ä¼çå¬è¿äºç±»åçäºä»¶ï¼å¹¶éè¿å½æ°ç±»åçå¼å¤çå®ä»¬ã - -Weex ä¼æä¸ä¸ªäºä»¶å¯¹è±¡ä½ä¸ºç¬¬ä¸ä¸ªåæ°ä¼ éç»å ¶ç»å®çäºä»¶ï¼è¿ä¸ªäºä»¶å¯¹è±¡å¨ `e.detail` ä¸å å«äºä»¶æ°æ®ã -## çå½å¨æ - -``` javascript -module.exports = { - data: ..., - methods: ..., - init: function () { - console.log('ViewModel constructor begins') - }, - created: function () { - console.log('Data observation finished') - }, - ready: function () { - console.log('Virtual DOM finished') - }, - ... -} -``` - -Weex è§å¾æ¨¡åç°å¨æ¯æçå½å¨æå çé©åå½æ°ï¼è¿äºé©åå½æ°è½è¢«å为ç»ä»¶éé¡¹ï¼ -- `init`: å¨è§å¾æ¨¡åçæé å½æ°å¼å§è°ç¨æ¶æ¿æ´»ï¼ -- `created`: å½è§å¾æ¨¡åçå¬é»è®¤æ°æ®ï¼ä½è¿æªç¼è¯æ¨¡æ¿æ¶æ¿æ´»ï¼ -- `ready`: å½è§å¾æ¨¡åçå¬é»è®¤æ°æ®å¹¶ä¸ç¼è¯æ¨¡æ¿çæèæDOMå被æ¿æ´»ã - -**注æï¼å½ `methods`ã`events` æçå½å¨ææ¹æ³ä½ä¸ºåæ°ä¼ éç»å«çå½æ°æ¶ï¼å¡å¿ 确认å½æ°æ§è¡æ¶çä¸ä¸æ符åæ¨çé¢æï¼ä¾å¦ï¼** - -``` javascript -module.exports = { - data: function () { - return {x: 1, y: 2} - }, - ready: function () { - // `undefined` - // å 为ä¸ä¸æåçäºåå - this.foo(this.bar) - // `1` - // æ£ç¡®ç»å®ä¸ä¸æä¹åå¯ä»¥å¾å°é¢æçå¼ - this.foo(this.bar.bind(this)) - }, - methods: { - foo: function (fn) { - return fn() - }, - bar: function () { - return this.x - } - } -} -``` http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/components/a.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/components/a.md b/doc/source/cn/v-0.10/references/components/a.md deleted file mode 100644 index 75bd831..0000000 --- a/doc/source/cn/v-0.10/references/components/a.md +++ /dev/null @@ -1,273 +0,0 @@ ---- -title: <a> -type: references -order: 2.1 -version: 0.10 ---- - -# <a> - -`<a>` ç»ä»¶å®ä¹äºæåæ个页é¢çä¸ä¸ªè¶ é¾æ¥. æ¤ç»ä»¶çä½ç¨åç¨æ³ä¸HTML5ä¸ç [`<a>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a) é常类似ï¼åºå«å¨äº Weex ç `<a>` ç»ä»¶**ä¸è½**ç´æ¥å¨éé¢æ·»å ææ¬ï¼å符串ï¼ï¼å¦æè¦å±ç¤ºææ¬ï¼åºè¯¥æ·»å `<text>` ç»ä»¶ã - -ä¸ä¸ªç®åä¾åï¼ - -```HTML -<template> - <div class="wrapper"> - <a href="http://dotwe.org/raw/dist/a468998152ee680413588c38bd61c29e.js"> - <text>click</text> - </a> - </div> -</template> - -<style> -.wrapper { - text-align: center; -} -</style> -``` - -[ä½éªä¸ä¸](http://dotwe.org/f63c78213ef26c25357ffa851537fff3) - -## åç»ä»¶ - -æ¤ç»ä»¶æ¯æé¤äºèªå·±å¤çææ Weex ç»ä»¶ä½ä¸ºåç»ä»¶ã - -## ç¹æ§ - -- `href {string}`ï¼å®ä¹äºè¶ é¾æ¥ç URLã - -## æ ·å¼ - -`<a>` æ¯æææéç¨æ ·å¼ã - -- ç模å -- `flexbox` å¸å± -- `position` -- `opacity` -- `background-color` - -æ¥ç [ç»ä»¶éç¨æ ·å¼](../common-style.html)ã - -## äºä»¶ - -`<a>` æ¯æææéç¨äºä»¶ã - -- `click` - **注æï¼**æ们ä¸è½ä¿è¯ `click` äºä»¶å `href` 跳转çæ§è¡é¡ºåºã建议ä¸è¦ä½¿ç¨ `click` äºä»¶æ¥å¤ç `href` 跳转åçé»è¾å¤çã -- `longpress` -- `appear` -- `disappear` - -æ¥ç [éç¨äºä»¶](../common-event.html)ã - -## 约æ - -1. **ä¸è½**ç´æ¥å¨ `<a>` ä¸æ·»å ææ¬ã - é误示ä¾ï¼âclickâ æ æ³è¢«æ£å¸¸æ¸²æã - - ```HTML - <template> - <div class="wrapper"> - <a href="http://dotwe.org/raw/dist/a468998152ee680413588c38bd61c29e.js"> - click - </a> - </div> - </template> - - <style> - .wrapper { - text-align: center; - } - </style> - ``` - -[ä½éªä¸ä¸](http://dotwe.org/0a22d65138691a208e3fb1f8f6392b38) - -2. 请ä¸è¦ä¸º `<a>` æ·»å `click` äºä»¶ãæ们ä¸è½ç¡®ä¿ `click` äºä»¶å `href` 跳转çæ§è¡é¡ºåºã - -## ç¤ºä¾ - -```html -<template> - <div> - <list class="list"> - <header class="header"> - <text class="title">Search Results</text> - </header> - <refresh style="width: 750; padding: 30;" onrefresh="refreshData" display="{{refreshDisplay}}"> - <text class="text"> â Pull to refresh </text> - <loading-indicator class="indicator"></loading-indicator> - </refresh> - <cell class="row" repeat="item in items" id="item-{{$index}}"> - <div class="lines"> - <text class="item">Repo name: </text><a href="{{item.repo_url}}"><text class="link">{{item.full_name}}</text></a> - </div> - <div> - <text class="item">Repo star: {{item.stargazers_count}}</text> - </div> - </cell> - <loading onloading="loadingData" style="width: 750; padding: 30;" display="{{loadingDisplay}}"> - <text class="text">{{loadingText}}</text> - </loading> - </list> - <div class="up" onclick="goToTop"> - <img class="img" src="https://img.alicdn.com/tps/TB1ZVOEOpXXXXcQaXXXXXXXXXXX-200-200.png"></img> - </div> - </div> -</template> - -<style> -.header { - padding: 25; - background-color: #efefef; - border-bottom-color: #eeeeee; - border-bottom-width: 2; - border-bottom-style: solid; -} -.title { - text-align: center; -} -.text { - text-align: center; -} -.list { - background-color: #ffffff; -} -.row { - padding: 20; - border-bottom-color: #eeeeee; - border-bottom-width: 2; - border-bottom-style: solid; -} -.up { - width: 70; - height: 70; - position: fixed; - right: 20; - bottom: 20; -} -.img { - width: 70; - height: 70; -} -.lines { - flex-direction: row; -} -.link { - color: #008cff; - text-decoration: underline; -} -</style> - -<script> -var dom = require('@weex-module/dom') || {} -var stream = require('@weex-module/stream') || {} -var modal = require('@weex-module/modal') || {} - -var SEARCH_URL = 'https://api.github.com/search/repositories?q=language:javascript&sort=stars&order=desc', - PAGE_URL = 'http://dotwe.org/raw/dist/f1fa0895d0fa0fd80896e02a589443dd.js' - -module.exports = { - data: { - isLoaded: true, - page: 1, - loadingDisplay: 'hide', - refreshDisplay: 'hide', - loadingText: 'Loading...', - items:[] - }, - created: function () { - var url = SEARCH_URL + '&page=' + this.page - - this.renderData(url) - - this.page++ - }, - methods: { - renderData: function (url) { - var self = this - - stream.fetch({ - method: 'GET', - url: url, - type:'json' - }, function(res) { - try { - var results = res.data.items || [] - - if (Array.isArray(results)) { - for(var i = 0; i < results.length; i++) { - var repo_url = results[i].html_url - if (repo_url) { - results[i].repo_url = self.processUrl(repo_url) - } - self.items.push(results[i]) - } - } - } catch(e) {} - },function(res){ - - }) - }, - loadingData: function (e) { - var url = SEARCH_URL + '&page=' + this.page - var self = this - - if (self.isLoaded === false) return - - self.loadingDisplay = 'show' - - if (self.page <=10 ) { - self.renderData(url) - self.page++ - } else { - self.loadingDisplay = 'hide' - self.loadingText = 'NO MORE!' - } - }, - goToTop: function (e) { - dom.scrollToElement(this.$el('item-0'), { - offset: -100 - }) - }, - refreshData: function (e) { - var url = SEARCH_URL + '&page=1' - - if (this.isLoaded === false) return - - this.refreshDisplay = 'show' - - modal.toast({ - 'message': 'Refreshing...', - 'duration': 1 - }) - - this.items = [] - this.page = 1 - this.renderData(url) - - this.refreshDisplay = 'hide' - }, - processUrl: function (url) { - var platform = this.$getConfig().env.platform.toLowerCase() - - - if (url) { - // iOS do not need encode - if (platform === 'ios') { - return PAGE_URL + '?weburl=' + url - } else if (platform === 'web') { - return url - } else { - var encodeUrl = encodeURIComponent(url) - return PAGE_URL + '?weburl=' + encodeUrl - } - } - } - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/3e8369efb20a169077b5331b45927ed8)ã http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/8162f8c2/doc/source/cn/v-0.10/references/components/cell.md ---------------------------------------------------------------------- diff --git a/doc/source/cn/v-0.10/references/components/cell.md b/doc/source/cn/v-0.10/references/components/cell.md deleted file mode 100644 index e977037..0000000 --- a/doc/source/cn/v-0.10/references/components/cell.md +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: <cell> -type: references -order: 2.5 -version: 0.10 ---- - -# <cell> - -ç¨äºå®ä¹å表ä¸çåå表项ï¼ç±»ä¼¼äº HTML ä¸ç `ul` ä¹äº `li`ãWeex ä¼å¯¹ `<cell>` è¿è¡é«æçå ååæ¶ä»¥è¾¾å°æ´å¥½çæ§è½ï¼è¯¥ç»ä»¶å¿ é¡»ä½ä¸º[`<list>`](./list.html) ç»ä»¶çåç»ä»¶, è¿æ¯ä¸ºäºä¼åæ»å¨æ¶çæ§è½ã - -## åç»ä»¶ - -æ¯æææ Weex çç»ä»¶ä½ä¸ºå®çåç»ä»¶ã - -## æ ·å¼ - -**注æï¼** - -ä½ ä¸è½ç» `<cell>` 设å®`flex`å¼ã `<cell>`ç宽度çäºç¶ç»ä»¶ `<list>` ç宽度ï¼å¹¶ä¸ `<cell>` é«åº¦èªéåºã - -- éç¨æ ·å¼ï¼æ¯æææéç¨æ ·å¼ - - - ç模å - - `flexbox` å¸å± - - `position` - - `opacity` - - `background-color` - - æ¥ç [ç»ä»¶éç¨æ ·å¼](../common-style.html) - -## äºä»¶ - -- éç¨äºä»¶ - - æ¯æææéç¨äºä»¶ï¼ - - - `click` - - `longpress` - - `appear` - - `disappear` - - æ¥ç [éç¨äºä»¶](../common-event.html) - -## ç¤ºä¾ - -![mobile_preview](../images/list_3.jpg) - -```html -<template> - <div> - <list class="list"> - <header class="header"> - <text class="title">Search Results</text> - </header> - <refresh style="width: 750; padding: 30;" onrefresh="refreshData"> - <text class="text"> â Pull to refresh </text> - <loading-indicator class="indicator"></loading-indicator> - </refresh> - <cell class="row" repeat="item in items" id="item-{{$index}}"> - <div> - <text class="item">Repo name: {{item.full_name}}</text> - </div> - <div> - <text class="item">Repo star: {{item.stargazers_count}}</text> - </div> - </cell> - <loading onloading="loadingData" style="width: 750; padding: 30;" display="{{loadingDisplay}}"> - <text class="text">{{loadingText}}</text> - </loading> - </list> - <div class="up" onclick="goToTop"> - <img class="img" src="https://img.alicdn.com/tps/TB1ZVOEOpXXXXcQaXXXXXXXXXXX-200-200.png"></img> - </div> - </div> -</template> - -<style> -.header { - padding: 25; - background-color: #efefef; - border-bottom-color: #eeeeee; - border-bottom-width: 2; - border-bottom-style: solid; -} -.title { - text-align: center; -} -.text { - text-align: center; -} -.list { - background-color: #ffffff; -} -.row { - padding: 20; - border-bottom-color: #eeeeee; - border-bottom-width: 2; - border-bottom-style: solid; -} -.up { - width: 70; - height: 70; - position: fixed; - right: 20; - bottom: 20; -} -.img { - width: 70; - height: 70; -} -</style> - -<script> -var dom = require('@weex-module/dom') || {} -var stream = require('@weex-module/stream') || {} -var modal = require('@weex-module/modal') || {} - -var SEARCH_URL = 'https://api.github.com/search/repositories?q=language:javascript&sort=stars&order=desc' - -module.exports = { - data: { - page: 1, - loadingDisplay: 'show', - loadingText: 'Loading...', - items:[] - }, - created: function () { - var url = SEARCH_URL + '&page=' + this.page - - this.renderData(url) - - this.page++ - }, - methods: { - renderData: function (url) { - var self = this - - stream.fetch({ - method: 'GET', - url: url, - type:'json' - }, function(res) { - try { - var results = res.data.items || [] - - if (Array.isArray(results)) { - for(var i = 0; i < results.length; i++) { - self.items.push(results[i]) - } - } - } catch(e) {} - },function(res){ - - }) - }, - loadingData: function (e) { - var url = SEARCH_URL + '&page=' + this.page - var self = this - - if (self.page <=10 ) { - self.renderData(url) - self.page++ - } else { - self.loadingDisplay = 'hide' - self.loadingText = 'NO MORE!' - } - }, - goToTop: function (e) { - dom.scrollToElement(this.$el('item-0'), { - offset: -100 - }) - }, - refreshData: function (e) { - var url = SEARCH_URL + '&page=1' - - modal.toast({ - 'message': 'Refreshing...', - 'duration': 1 - }) - - this.items = [] - this.page = 1 - this.renderData(url) - } - } -} -</script> -``` - -[ä½éªä¸ä¸](http://dotwe.org/280fa3dc8e793ea8712451ecdf84fb7b) \ No newline at end of file