[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]