0.11.9

Author: yyx990803

source/api/directives.md

@@ -217,7 +217,7 @@ Example inheriting individual properties (using the same data):
 ### v-events
 
 - This directive can only be used with `v-component`.
-- This directive accepts only keypaths, no expressions.
+- This directive accepts either a method name, or a single expression statement.
 
 Allows a parent instance to listen to events on a child instance. The difference from `v-on` is that `v-events` listens to Vue's component system events created via `vm.$emit()` rather than DOM events. This directive allows more decoupled parent-child communication without having to hard-code event listeners into the parent component. Note that it can only be used together with `v-component`, i.e. on the root element of a child component.
 
@@ -237,21 +237,14 @@ When the child component calls `this.$emit('change', ...)`, the parent's `onChil
 ### v-component
 
 - Directive params: [`keep-alive`](/guide/components.html#Dynamic_Components), [`wait-for`](/guide/components.html#wait-for), [`transition-mode`](/guide/components.html#transition-mode), [`inline-template`](/guide/components.html#Inline_Template)
+- Can be made reactive with mustaches
 
 Compile this element as a child ViewModel with a registered component constructor. This can be used with `v-with` to inehrit data from the parent. For more details see [Component System](/guide/components.html).
 
-### v-ref
-
-Register a reference to a child component on its parent for easier access. Only respected when used in combination with `v-component` or `v-repeat`. The component instance will be accessible on its parent's `$` object. For an example, see [child reference](/guide/components.html#Child_Reference).
-
-When used with `v-repeat`, the value will be an Array containing all the child Vue instances corresponding to the Array they are bound to.
-
-### v-el
-
-Register a reference to a DOM element on its owner Vue instance for easier access. e.g. `<div v-el="hi">` will be accessible as `vm.$$.hi`.
-
 ### v-partial
 
+- Can be made reactive with mustaches
+
 Replace the element's innerHTML with a registered partial. Partials can be registered with `Vue.partial()` or passed inside the `partials` option.
 
 Using the mustache tag inside `v-partial` makes it reactive:
@@ -269,10 +262,22 @@ You can also use this syntax (which doesn't support reactivity):
 
 ### v-transition
 
+- Can be made reactive with mustaches
+
 Notify Vue.js to apply transitions to this element. The transition classes are applied when certain transition-triggering directives modify the element, or when the Vue instance's DOM manipulation methods are called.
 
 For details, see [the guide on transitions](/guide/transitions.html).
 
+### v-ref
+
+Register a reference to a child component on its parent for easier access. Only respected when used in combination with `v-component` or `v-repeat`. The component instance will be accessible on its parent's `$` object. For an example, see [child reference](/guide/components.html#Child_Reference).
+
+When used with `v-repeat`, the value will be an Array containing all the child Vue instances corresponding to the Array they are bound to.
+
+### v-el
+
+Register a reference to a DOM element on its owner Vue instance for easier access. e.g. `<div v-el="hi">` will be accessible as `vm.$$.hi`.
+
 ## Empty Directives
 
 > Empty directives do not require and will ignore their attribute value.

source/guide/directives.md

@@ -68,15 +68,15 @@ Some directives don't create data bindings - they simply take the attribute valu
 
 Here `"my-component"` is not a data property - it's a string ID that Vue.js uses to lookup the corresponding Component constructor.
 
-You can also use mustache expressions inside literal directives. For example, the following code allows you to dynamically resolve the type of component you want to use:
+You can also use mustache expressions inside literal directives to make it reactive. For example, the following code allows you to dynamically resolve the type of component you want to use:
 
 ``` html
 <div v-component="{{ isOwner ? 'owner-panel' : 'guest-panel' }}"></div>
 ```
 
 When the expression inside the mustaches change, the rendered component will also change accordingly!
 
-However, note that `v-component` and `v-partial` are the only literal directives that have this kind of reactive behavior. Mustache expressions in other literal directives, e.g. `v-ref`, are evaluated **only once**. After the directive has been compiled, it will no longer react to value changes.
+However, note that not all literal directives can have this kind of reactive behavior. Built-in directives that support this usage include `v-component`, `v-partial` and `v-transition`. Mustache expressions in other literal directives, e.g. `v-ref` and `v-el`, are evaluated **only once**. After the directive has been compiled, it will no longer react to value changes.
 
 A full list of literal directives can be found in the [API reference](/api/directives.html#Literal_Directives).
 

source/guide/faq.md

@@ -15,7 +15,7 @@ order: 15
 
   2. You cannot define your own getter/setters on data objects. This isn't much of a problem because data objects are expected to be obtained from plain JSON and Vue.js provides computed properties.
 
-  3. Vue.js adds a few extra properties/methods to obsesrved objects: `__ob__`, `$add` and `$delete`. These properties are inenumberable so they will not show up in `for ... in ...` loops. However if you overwrite them things will likely break.
+  3. Vue.js adds a few extra properties/methods to obsesrved objects: `__ob__`, `$add`, `$set` and `$delete`. These properties are inenumberable so they will not show up in `for ... in ...` loops. However if you overwrite them things will likely break.
 
   That's pretty much it. Accessing properties on the object is the same as before, `JSON.stringify` and `for ... in ...` loops will work as normal. 99.9% of the time you don't even need to think about it.
 

source/guide/index.md

@@ -53,7 +53,7 @@ Vue instances proxy all properties on data objects they observe. So once an obje
 
 The data objects are mutated in place, so modifying it by reference has the same effects as modifying `vm.$data`. This makes it possible for multiple Vue instances to observe the same piece of data. In larger applications it is also recommended to treat Vue instances as pure views, and externalize the data manipulation logic into a more discrete store layer.
 
-One caveat here is that once the observation has been initiated, Vue.js will not be able to detect newly added or deleted properties. To get around that, observed objects are augmented with `$add` and `$delete` methods.
+One caveat here is that once the observation has been initiated, Vue.js will not be able to detect newly added or deleted properties. To get around that, observed objects are augmented with `$add`, `$set` and `$delete` methods.
 
 ### Directives
 

source/guide/installation.md

@@ -1,10 +1,10 @@
 title: Installation
 type: guide
 order: 1
-vue_version: 0.11.8
-dev_size: 189.56
-min_size: 58.59
-gz_size: 19.20
+vue_version: 0.11.9
+dev_size: 193.93
+min_size: 59.70
+gz_size: 19.52
 ---
 
 > **Compatibility Note:** Vue.js does not support IE8 and below.

source/guide/list.md

@@ -247,7 +247,7 @@ new Vue({
 })
 </script>
 
-<p class="tip">In ECMAScript 5 there is no way to detect when a new property is added to an Object, or when a property is deleted from an Object. To deal with that, observed objects will be augmented with two methods: `$add(key, value)` and `$delete(key)`. These methods can be used to add / delete properties from observed objects while triggering the desired View updates.</p>
+<p class="tip">In ECMAScript 5 there is no way to detect when a new property is added to an Object, or when a property is deleted from an Object. To deal with that, observed objects will be augmented with three methods: `$add(key, value)`, `$set(key, value)` and `$delete(key)`. These methods can be used to add / delete properties from observed objects while triggering the desired View updates. The difference between `$add` and `$set` is that `$add` will return early if the key already exists on the object, so just calling `obj.$add(key)` won't overwrite the existing value with `undefined`.</p>
 
 ## Iterating Over a Range
 

themes/vue/_config.yml

@@ -1,3 +1,3 @@
 google_analytics: UA-46852172-1
 root_domain: vuejs.org
-vue_version: 0.11.8
+vue_version: 0.11.9