<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>13630</bug_id>
          
          <creation_ts>2011-08-03 20:04:30 +0000</creation_ts>
          <short_desc>Better method for user-friendly help or hints</short_desc>
          <delta_ts>2014-03-12 17:41:58 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>LC1 HTML5 spec</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>NEEDSINFO</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>a11y, a11y_ua</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Greg Lowney">gcl-0039</reporter>
          <assigned_to name="Greg Lowney">gcl-0039</assigned_to>
          <cc>bhawkeslewis</cc>
    
    <cc>cooper</cc>
    
    <cc>ian</cc>
    
    <cc>laura.lee.carlson</cc>
    
    <cc>lwatson</cc>
    
    <cc>mike</cc>
    
    <cc>public-html-a11y</cc>
    
    <cc>public-html-admin</cc>
    
    <cc>public-html-wg-issue-tracking</cc>
          
          <qa_contact name="HTML WG Bugzilla archive list">public-html-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>52225</commentid>
    <comment_count>0</comment_count>
    <who name="Greg Lowney">gcl-0039</who>
    <bug_when>2011-08-03 20:04:30 +0000</bug_when>
    <thetext>HTML5 may need a better way to associate user-friendly help or hints with elements.

There are cases where help text or hints should be available to any user, but are not appropriate to present by default to the average user. In some cases (e.g. the pattern attribute) the spec says that the title attribute should be used for this purpose, but the Accessibility Task Force doesn&apos;t believe the title attribute should be overloaded in this way. Instead, a new global attribute called hint or helptext should be created for this purpose, or a method analogous to the label element could allow identifying content as the help or hint for a specified element.

Issue: How would this be presented to the user? If an element has a title and helptext, do we really want users to have to have two separate mechanisms for getting access to hint and helptext, perhaps two different hotkeys and two different shortcut menu items? This suggests that there&apos;s good reason to leave it mingled in with the content of the title attribute. On the other hand, browsers already handle title badly, and it&apos;s hard to say whether it would be worse to encourage long title text that some browsers will truncate or to have another thing like title text that they may not handle at all.

Issue: Should this be an attribute, and thus limited to a simple text string, or might it be better to define a mechanism that allowed identifying a separate block of content as help for another element, analogous to how the details or label elements already work? That would allow rich, styled content for the help. It would certainly require new UI for displaying and hiding, but that might be no worse than if we merely define a new hint attribute.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>53528</commentid>
    <comment_count>1</comment_count>
    <who name="Michael[tm] Smith">mike</who>
    <bug_when>2011-08-04 05:14:45 +0000</bug_when>
    <thetext>mass-move component to LC1</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54330</commentid>
    <comment_count>2</comment_count>
    <who name="Benjamin Hawkes-Lewis">bhawkeslewis</who>
    <bug_when>2011-08-06 12:09:43 +0000</bug_when>
    <thetext>(In reply to comment #0)
&gt; HTML5 may need a better way to associate user-friendly help or hints with
&gt; elements.
&gt; 
&gt; There are cases where help text or hints should be available to any user, but
&gt; are not appropriate to present by default to the average user. 

What cases? What do you mean by &quot;by default&quot;.

&gt; In some cases
&gt; (e.g. the pattern attribute) the spec says that the title attribute should be
&gt; used for this purpose, but the Accessibility Task Force doesn&apos;t believe the
&gt; title attribute should be overloaded in this way.

Why?

&gt; Instead, a new global
&gt; attribute called hint or helptext should be created for this purpose

The name makes it sound like a text that should be available to any user.

&gt; , or a
&gt; method analogous to the label element could allow identifying content as the
&gt; help or hint for a specified element.

How would that differ from &quot;aria-describedby&quot;?

&gt; Issue: How would this be presented to the user? If an element has a title and
&gt; helptext, do we really want users to have to have two separate mechanisms for
&gt; getting access to hint and helptext, perhaps two different hotkeys and two
&gt; different shortcut menu items? This suggests that there&apos;s good reason to leave
&gt; it mingled in with the content of the title attribute. On the other hand,
&gt; browsers already handle title badly, and it&apos;s hard to say whether it would be
&gt; worse to encourage long title text that some browsers will truncate or to have
&gt; another thing like title text that they may not handle at all.

If implementors are not implementing display of long &quot;title&quot; text, why do you think they would do the same thing for a whole new attribute?

&gt; Issue: Should this be an attribute, and thus limited to a simple text string,
&gt; or might it be better to define a mechanism that allowed identifying a separate
&gt; block of content as help for another element, analogous to how the details or
&gt; label elements already work? That would allow rich, styled content for the
&gt; help. It would certainly require new UI for displaying and hiding, but that
&gt; might be no worse than if we merely define a new hint attribute.

I think this would be better.

Typically, help is given for controls. Can you give an example where some combination of &quot;label&quot;, &quot;details&quot;, and &quot;aria-describedby&quot; would not already address this use-case?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>60200</commentid>
    <comment_count>3</comment_count>
    <who name="Michael[tm] Smith">mike</who>
    <bug_when>2011-11-20 15:13:27 +0000</bug_when>
    <thetext>Greg, this bug is waiting on you to respond to that questions in comment #2</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>60422</commentid>
    <comment_count>4</comment_count>
    <who name="Ian &apos;Hixie&apos; Hickson">ian</who>
    <bug_when>2011-11-24 02:43:29 +0000</bug_when>
    <thetext>EDITOR&apos;S RESPONSE: This is an Editor&apos;s Response to your comment. If you are satisfied with this response, please change the state of this bug to CLOSED. If you have additional information and would like the editor to reconsider, please reopen this bug. If you would like to escalate the issue to the full HTML Working Group, please add the TrackerRequest keyword to this bug, and suggest title and text for the tracker issue; or you may create a tracker issue yourself, if you are able to do so. For more details, see this document:
   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: Did Not Understand Request
Change Description: no spec change
Rationale: see comment 3</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>