OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

office message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [OASIS Issue Tracker] Commented: (OFFICE-3753) 19.380 office:target-frame overlap with 19.381office:target-frame-name


    [ http://tools.oasis-open.org/issues/browse/OFFICE-3753?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=31451#action_31451 ] 

Patrick Durusau commented on OFFICE-3753:
-----------------------------------------

This gets complicated so I composed this elsewhere and pasted it in:

Issue: Are office:target-frame and office:target-frame-name overlapping?

**Values**

The values of both are identical:

_blank: The referenced document is displayed in a new frame.

_parent: The referenced document is displayed in the parent frame of the current frame.

_self: The referenced document replaces the content of the current frame.

_top: The referenced document is displayed in the topmost frame, that is the frame that contains the current frame as a child or descendant but is not contained within another frame.

A frame name : The referenced document is displayed in the named frame. If the named frame does not exist, a new frame with that name is created.


**Data type**

The data type is targetFrameName in both cases, which refers to 6.16 of HTML4 as restricting the name to beginning with an alphabetic character (a-zA-Z). (we modify slightly the other values defined in 6.16, see the full text of 6.16 below.)


**Usage of Attributes**


office:target-frame is used with:

<form:button>, <form:form> and <form:image>


office:target-frame-name is used with:

<draw:a>, <draw:area-circle>, <draw:area-polygon>, <draw:area-rectangle>, <meta:hyperlink-behaviour> and <text:a>.

**Difference - presence/absence of xlink:show**

The difference between the two attributes occurs when office:target-frame-name is used with xlink:show (on <draw:a>, <draw:area-circle>, <draw:area-polygon>, <draw:area-rectangle>, <meta:hyperlink-behaviour> and <text:a>).

We say for office:target-frame-name:

"The office:target-frame-name attribute may be used together with an xlink:show attribute. In that case, if the value of the attribute is _blank, the xlink:show attribute value should be new. If the value of the attribute is any of the other value options, the value of the xlink:show attribute should be replace." 


And at xlink:show we say:

"For <draw:a> 10.4.12, <draw:area-circle> 10.4.13.4, <draw:area-polygon> 10.4.13.5, <draw:area-rectangle> 10.4.13.3, <meta:hyperlink-behaviour> 4.3.2.14, <presentation:sound> 10.8.2 and <text:a> 6.1.8 elements the supported values for this attribute are new or replace."

**Analysis**

In the absence of an xlink:show attribute, the values (and I presume operation of) office:target-frame and office:target-frame-name are identical.

When an xlink:show attribute is present on <draw:a>, <draw:area-circle>, <draw:area-polygon>, <draw:area-rectangle>, <meta:hyperlink-behaviour> or <text:a>, the value of the office:target-frame-name attribute determines the value of the xlink:show attribute. A _blank value for office:target-frame-name means xlink:show should be new. If the office:target-frame-name value is anything other than _blank, then the xlink:show attribute should be replace.

The reason for this indirect control of the values of xlink:show isn't stated and if I ever knew, I don't remember it now. 

Question: Does any implementation rely upon this indirect control of the xlink:show value? 

If not, I would suggest that we collapse the two attribute values into a new: office:target-frame-behavior, so that we can have one attribute going forward and deprecate the two existing attributes (but retain them for the next version only.



**For your reference**

HTML 4.1, 6.16 reads in full:

*********
6.16 Frame target names

Except for the reserved names listed below, frame target names (%FrameTarget; in the DTD) must begin with an alphabetic character (a-zA-Z). User agents should ignore all other target names.

The following target names are reserved and have special meanings.

_blank
    The user agent should load the designated document in a new, unnamed window.
_self
    The user agent should load the document in the same frame as the element that refers to this target.
_parent
    The user agent should load the document into the immediate FRAMESET parent of the current frame. This value is equivalent to _self if the current frame has no parent.
_top
    The user agent should load the document into the full, original window (thus canceling all other frames). This value is equivalent to _self if the current frame has no parent.
*********


> 19.380 office:target-frame overlap with 19.381office:target-frame-name
> ----------------------------------------------------------------------
>
>                 Key: OFFICE-3753
>                 URL: http://tools.oasis-open.org/issues/browse/OFFICE-3753
>             Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
>          Issue Type: Improvement
>    Affects Versions: ODF 1.2
>            Reporter: Bart Hanssens
>            Assignee: Patrick Durusau
>            Priority: Minor
>
> 19.380: "The office:target-frame attribute specifies a target frame."
> 19.381: "The office:target-frame-name attribute specifies the name of a target frame"
> It seems that these attributes are very similar, so perhaps one of them can be dropped in favor of the other. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]