ODF New Proposal Template

Summary

Proposal owner:

Mingfei Jia

Proposal short name:

Add list level attribute to style:style

Rationale

Use cases:

In current ODF specification(OpenDocument-v1.2-draft7-11.odt), the style:style does not contain the list level value. But the following user scenarios need this:
User often need to apply the specific style which contains the list level value to one or more specific paragraphs according to his/her concrete requirement. For example, user creates paragraphs like para-1, para-2, ...,para-N, as well as creates style ListStyle-1, ListStyle-2. The ListStyle-1 contains the list level value with 1, the ListStyle-2 contains the list level value with 2. Then the user may apply the style ListStyle-1 to para-1 and para-N, also apply the style ListStyle-2 to para-2,...,para-N-1. So para-1 and para-N will be at list level 1, and para-2 to para-N-1 will be at list level 2. Through applying the specific style that contains the list level value to the specific paragraph, user can set the list level to paragraph more conveniently than through pressing tab/shift-tab key. This attribute is valid only if the attribute style:list-style-name exists and is not empty.
Actually the way to change the list level of paragraph through applying the numbering style is used very commonly, not just used to set the initial level of paragraph. User can customize the paragraphy style at any time. For example, whatever OpenOffice3.0 or Symphony 1.2, we can create a paragraph style called "ParaStyle" by style list dialog, set its parent style as "Heading 1", set its Numbering style as "List 1". Then we can apply this "ParaStyle" to some paragraph. The saved XML would be like:
<style:style
        style:name="ParaStyle"
        style:family="paragraph"
        style:parent-style-name="Heading_20_1"
        style:list-style-name="List_20_1"/>.
Now we would like to develop the feature that allow user to customize the list level in the paragraph style. For example, in the paragraph applied the style "ParaStyle", we can edit the paragraph style by popup menu, in the paragraph style dialog, select Numbering tab, we can see "List 1" is selected in the list box. Under the numbering style list box, we would like to add some UI to specify the list level for this paragraph style. Note, this UI is enabled only when Numbering style is not "None". Corresponding XML format, the style:list-level attribute is only valid when the style:list-style-name exists. The saved XML would be like:
<style:style
        style:name="ParaStyle"
        style:family="paragraph"
        style:parent-style-name="Heading_20_1"
        style:list-style-name="List_20_1"
        style:list-level="1"/>.

Another use case is to be interoperable with MS Word. MS Word supports to keep list level value in the specific style, then user can apply this style to the specific paragraph. So when ODF application imports the MS Word file that contains the list level value in some applied style, then if user exports the document to ODF file, ODF application has to loose the list level value since current ODF specification does not support that.

Alternatives considered:

TC member may help work out other better solutions

Requested changes to the ODF Standard

Text changes/additions (please state section numbers):

The following changes are also stated in odt document at the link Add list level attribute to style:style

In OpenDocument-v1.2-draft7-11.odt, section 15.2. <style:style>, add the attribute <style:list-level>:
Change the words:
"The <style:style> element may have the following attributes: style:auto-update 18.681,......,and style:percentage-data-style-name 18.799."
To:
"The <style:style> element may have the following attributes: style:auto-update 18.681, ......, style:percentage-data-style-name 18.799, and style:list-level 18.xxxx. "
"
Here "18.xxxx" depends on the overall attribute sorting done by the specification editor.

Add a section in chapter 18:
18.xxxx style:list-level
The style:list-level attribute specifies the list level value of a list style that may be applied to any paragraph style. It does not directly specify the paragraph's list level value, but applications can change the paragraph's list level value through applying the paragraph style that has it as attribute and changing its value. It is valid only if the attribute style:list-style-name is specified and is not empty.
The style:list-level attribute may be used with the following element: <style:style>15.2 whose style family attribute has the value paragraph.

Schema changes/additions:

Add the following schema:
<define name="style-style-attlist" combine="interleave">
        <optional>
                <attribute name="style:list-level">
                        <choice>
                                <ref name="positiveInteger"/>
                                <empty/>
                        </choice>
                </attribute>
        </optional>
</define>

Impacts

Conformance:

Add a list level attribute to style:style, allow users to set any level to the specific paragraph conveniently.

Backwards compatibility:

No

Accessibility impact:

No

Workflow (to be filled in by TC Chairs)

Category: CategoryIntegratedProposal CategoryODF1.2Proposal

Date Proposal initially made: 2008/11/25

Dates Proposal discussed on TC calls:1/5/2009

Date vote is requested:

Date vote is held: 12 January 2009

Results of vote: Approved

Version in which this proposal has been integrated: ODF 1.2 draft 8

add_list_level_attribute_to_style:style (last edited 2009-08-12 18:04:24 by localhost)