[IMP] doc: better xpath example

The xpath syntax `"//selector` is mostly used in Odoo, is clearer on the meaning
and more flexible about view changes.
Give an example with the mostly used syntax.

Add a tip to indicate the shorter xpath syntax
This commit is contained in:
Martin Trigaux 2015-08-09 22:02:56 +01:00
parent 8f2057a1c7
commit b4b373c965
1 changed files with 18 additions and 2 deletions

View File

@ -626,9 +626,9 @@ instead of a single view its ``arch`` field is composed of any number of
<field name="model">idea.category</field> <field name="model">idea.category</field>
<field name="inherit_id" ref="id_category_list"/> <field name="inherit_id" ref="id_category_list"/>
<field name="arch" type="xml"> <field name="arch" type="xml">
<!-- find field description inside tree, and add the field <!-- find field description and add the field
idea_ids after it --> idea_ids after it -->
<xpath expr="/tree/field[@name='description']" position="after"> <xpath expr="//field[@name='description']" position="after">
<field name="idea_ids" string="Number of ideas"/> <field name="idea_ids" string="Number of ideas"/>
</xpath> </xpath>
</field> </field>
@ -652,6 +652,22 @@ instead of a single view its ``arch`` field is composed of any number of
alters the attributes of the matched element using special alters the attributes of the matched element using special
``attribute`` elements in the ``xpath``'s body ``attribute`` elements in the ``xpath``'s body
.. tip::
When matching a single element, the ``position`` attribute can be set directly
on the element to be found. Both inheritances below will give the same result.
.. code-block:: xml
<xpath expr="//field[@name='description']" position="after">
<field name="idea_ids" />
</xpath>
<field name="description" position="after">
<field name="idea_ids" />
</field>
.. exercise:: Alter existing content .. exercise:: Alter existing content
* Using model inheritance, modify the existing *Partner* model to add an * Using model inheritance, modify the existing *Partner* model to add an