longdesc1/longdesc.html
author Mark Sadecki <mark@w3.org>
Thu, 19 Jun 2014 17:46:05 -0400
changeset 108 264f89e213bb
parent 107 ac507017569f
child 109 08ac9fad22bd
permissions -rw-r--r--
corrected h2 typo in code example
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     1
<!DOCTYPE html>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     2
<html dir="ltr" lang="en">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     3
  <head>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     4
    <meta content="text/html; charset=UTF-8" http-equiv="content-type">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     5
    <title>HTML5 Image Description Extension (longdesc)</title>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     6
    <style type="text/css">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     7
      .issue {border: dashed red 2px; background-color: #ffd}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
     8
      .example {color: #404; background-color:#eee}
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
     9
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
    10
      span.informative {
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    11
        background-color: white;
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
    12
        display: inline;
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
    13
        border: 1px solid black;
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
    14
        color: #404;
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
    15
        padding: 2px;
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
    16
      }
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
    17
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    18
      .example:first-child {padding-top:1em}
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
    19
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    20
        /* Make these stand-out more... */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    21
        .externalDFN {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    22
            font-style: italic;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    23
            background-color: #fff9d6;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    24
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    25
        /* Switch statement */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    26
        dl.switch dt::before {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    27
            content: "↪ ";
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    28
            margin-left: 1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    29
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    30
        /* Better spacing around various lists (implied paragraph children) */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    31
        ol > li, section:not(#toc) ul > li, section dl > dt {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    32
            margin: 1em 0;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    33
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    34
        /* domintro styling */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    35
        dl.domintro {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    36
            background-color: rgb(221, 255, 221);
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    37
            padding: 1em 0.5em 1em 2em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    38
            clear: both;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    39
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    40
        dl.domintro dt {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    41
            color: black;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    42
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    43
        dl.domintro > dd {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    44
            color: green;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    45
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    46
        dl.domintro::before {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    47
            float: right;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    48
            background-color: white;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    49
            display: block;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    50
            border: 2px solid black;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    51
            color: green;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    52
            margin-top: -20px;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    53
            padding: 2px;
71
b47874bf45dd changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
Mark Sadecki <mark@w3.org>
parents: 70
diff changeset
    54
            content: "This box is informative.";
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    55
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    56
        /* Fancy table stuff */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    57
        table {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    58
            border-collapse: collapse;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    59
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    60
        thead tr {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    61
            border-bottom: 2px solid black;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    62
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    63
        tbody tr:not(:last-child) {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    64
            border-bottom: 1px solid black;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    65
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    66
        td {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    67
            border-left: 1px solid black;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    68
            padding: 4px;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    69
        }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    70
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    71
/*****************************************************************
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    72
 * ReSpec 3 CSS
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    73
 * Robin Berjon - http://berjon.com/
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    74
 *****************************************************************/
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    75
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    76
/* --- INLINES --- */
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
    77
em.rfc2119 {
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    78
    text-transform:     lowercase;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    79
    font-variant:       small-caps;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    80
    font-style:         normal;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    81
    color:              #900;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    82
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    83
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    84
h1 acronym, h2 acronym, h3 acronym, h4 acronym, h5 acronym, h6 acronym, a acronym,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    85
h1 abbr, h2 abbr, h3 abbr, h4 abbr, h5 abbr, h6 abbr, a abbr {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    86
    border: none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    87
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    88
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    89
dfn {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    90
    font-weight:    bold;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    91
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    92
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    93
a.internalDFN {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    94
    color:  inherit;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    95
    border-bottom:  1px solid #99c;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    96
    text-decoration:    none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    97
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    98
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
    99
a.externalDFN {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   100
    color:  inherit;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   101
    border-bottom:  1px dotted #ccc;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   102
    text-decoration:    none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   103
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   104
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   105
a.bibref {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   106
    text-decoration:    none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   107
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   108
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   109
cite .bibref {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   110
    font-style: normal;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   111
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   112
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   113
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   114
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   115
/* --- TOC --- */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   116
.toc a, .tof a {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   117
    text-decoration:    none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   118
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   119
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   120
a .secno, a .figno {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   121
    color:  #000;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   122
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   123
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   124
ul.tof, ol.tof {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   125
    list-style: none outside none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   126
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   127
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   128
.caption {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   129
    margin-top: 0.5em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   130
    font-style:   italic;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   131
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   132
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   133
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   134
/* --- DL --- */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   135
.section dd > p:first-child {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   136
    margin-top: 0;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   137
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   138
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   139
.section dd > p:last-child {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   140
    margin-bottom: 0;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   141
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   142
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   143
.section dd {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   144
    margin-bottom:  1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   145
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   146
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   147
.section dl.attrs dd, .section dl.eldef dd {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   148
    margin-bottom:  0;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   149
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   150
/* --- ISSUES/NOTES --- */
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   151
div.note-title {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   152
    padding-right:  1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   153
    min-width: 7.5em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   154
    color: #b9ab2d;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   155
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   156
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   157
div.note-title { color: #52e052; }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   158
div.note-title span {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   159
    text-transform: uppercase;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   160
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   161
div.note {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   162
    margin-top: 1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   163
    margin-bottom: 1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   164
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   165
.note > p:first-child { margin-top: 0 }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   166
.note {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   167
    padding: .5em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   168
    border-left-width: .5em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   169
    border-left-style: solid;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   170
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   171
div.note {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   172
    padding: 0.5em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   173
    margin: 1em 0;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   174
    position: relative;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   175
    clear: both;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   176
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   177
span.note { padding: .1em .5em .15em; }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   178
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   179
.note {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   180
    border-color: #52e052;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   181
    background: #e9fbe9;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   182
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   183
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   184
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   185
pre.idl {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   186
    border-top: 1px solid #90b8de;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   187
    border-bottom: 1px solid #90b8de;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   188
    padding:    1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   189
    line-height:    120%;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   190
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   191
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   192
pre.idl::before {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   193
    content:    "WebIDL";
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   194
    display:    block;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   195
    width:      8ex;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   196
    background: #90b8de;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   197
    color:  #fff;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   198
    font-family:    initial;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   199
    padding:    3px;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   200
    font-weight:    bold;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   201
    margin: -1em 0 1em -1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   202
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   203
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   204
.idlType {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   205
    color:  #ff4500;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   206
    font-weight:    bold;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   207
    text-decoration:    none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   208
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   209
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   210
/*.idlInterface*/
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   211
.idlInterfaceID, .idlDictionaryID, .idlCallbackID, .idlEnumID {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   212
    font-weight:    bold;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   213
    color:  #005a9c;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   214
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   215
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   216
.idlSuperclass {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   217
    font-style: italic;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   218
    color:  #005a9c;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   219
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   220
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   221
/*.idlAttribute*/
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   222
.idlAttrType, .idlFieldType, .idlMemberType {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   223
    color:  #005a9c;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   224
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   225
.idlAttrName, .idlFieldName, .idlMemberName {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   226
    color:  #ff4500;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   227
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   228
.idlAttrName a, .idlFieldName a, .idlMemberName a {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   229
    color:  #ff4500;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   230
    border-bottom:  1px dotted #ff4500;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   231
    text-decoration: none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   232
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   233
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   234
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   235
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   236
.extAttr {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   237
    color:  #666;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   238
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   239
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   240
/*.idlConst*/
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   241
.idlConstType {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   242
    color:  #005a9c;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   243
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   244
.idlConstName {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   245
    color:  #ff4500;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   246
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   247
.idlConstName a {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   248
    color:  #ff4500;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   249
    border-bottom:  1px dotted #ff4500;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   250
    text-decoration: none;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   251
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   252
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   253
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   254
.idlImplements a {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   255
    font-weight:    bold;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   256
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   257
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   258
dl.attributes, dl.methods, dl.constants, dl.fields, dl.dictionary-members {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   259
    margin-left:    2em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   260
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   261
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   262
.attributes dt, .methods dt, .constants dt, .fields dt, .dictionary-members dt {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   263
    font-weight:    normal;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   264
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   265
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   266
.attributes dt code, .methods dt code, .constants dt code, .fields dt code, .dictionary-members dt code {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   267
    font-weight:    bold;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   268
    color:  #000;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   269
    font-family:    monospace;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   270
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   271
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   272
.attributes dt code, .fields dt code, .dictionary-members dt code {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   273
    background:  #ffffd2;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   274
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   275
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   276
.attributes dt .idlAttrType code, .fields dt .idlFieldType code, .dictionary-members dt .idlMemberType code {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   277
    color:  #005a9c;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   278
    background:  transparent;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   279
    font-family:    inherit;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   280
    font-weight:    normal;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   281
    font-style: italic;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   282
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   283
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   284
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   285
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   286
.attributes dd, .methods dd, .constants dd, .fields dd, .dictionary-members dd {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   287
    margin-bottom:  1em;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   288
}
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   289
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   290
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   291
88
b5c025619532 makes references to external resouces https
Mark Sadecki <mark@w3.org>
parents: 87
diff changeset
   292
</style> <link href="https://www.w3.org/TR/2013/WD-html-longdesc-20130716/prism.css"
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   293
      rel="stylesheet"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   294
      type="text/css">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   295
    <link href="https://www.w3.org/StyleSheets/TR/W3C-ED" rel="stylesheet">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   296
    <!--[if lt IE 9]><script src='undefined://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]-->
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   297
  </head>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   298
  <body>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   299
    <div class="head">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   300
      <p><a href="http://www.w3.org/"><img alt="W3C" src="http://www.w3.org/Icons/w3c_home"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   301
            height="48"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   302
            width="72"></a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   303
      </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   304
      <h1 class="title" id="title">HTML5 Image Description Extension (<code>longdesc</code>)</h1>
84
06d0047990da updated date
Mark Sadecki <mark@w3.org>
parents: 83
diff changeset
   305
      <h2 id="w3c-working-draft-03-june-2014"><abbr title="World Wide Web Consortium">W3C</abbr>
99
5cc555a97b93 updates date
Mark Sadecki <mark@w3.org>
parents: 98
diff changeset
   306
        Editors' Draft for Candidate Recommendation 13 June 2014</h2>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   307
      <dl>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   308
        <dt>Latest published version:</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   309
        <dd><a href="http://www.w3.org/TR/HTML-longdesc">http://www.w3.org/TR/HTML-longdesc</a></dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   310
        <dt>Latest editor's draft:</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   311
        <dd> <a href="http://dvcs.w3.org/hg/html-proposals/raw-file/default/longdesc1/longdesc.html">http://dvcs.w3.org/hg/html-proposals/raw-file/default/longdesc1/longdesc.html</a></dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   312
        <dt>Editors:</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   313
        <dd><a href="mailto:chaals@yandex-team.ru">Charles (McCathie) Nevile</a>,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   314
          <a href="http://www.yandex.ru">Яндекс</a>—<a href="http://yandex.com">Yandex</a></dd>
59
7e830c96870c added Mark Sadecki as an editor
Mark Sadecki <mark@w3.org>
parents: 58
diff changeset
   315
        <dd><a href="mailto:mark@w3.org">Mark Sadecki</a>, <a href="http://www.w3.org/">W3C</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   316
      </dl>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   317
      <p class="copyright"> <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
90
16b132930901 ported changes from pubrules failures
Mark Sadecki <mark@w3.org>
parents: 89
diff changeset
   318
        © 2012-2014 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   319
        (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   320
        <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   321
        <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>),
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   322
        All Rights Reserved. <abbr title="World Wide Web Consortium">W3C</abbr>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   323
        <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   324
        <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   325
        <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   326
          use</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-software">software
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   327
          licensing</a> rules apply. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   328
      <hr> </div>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   329
    <section class="introductory" id="abstract">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   330
      <h2>Abstract</h2>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   331
      <p>This specification defines a <code>longdesc</code> attribute (based on
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   332
        the <code>longdesc</code> attribute of HTML 4) to link descriptions to
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   333
        images in HTML5 content. </p>
61
f4d139c52636 removed "Note that" text from Abstract and Section 3 per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 60
diff changeset
   334
      <p>By allowing a hyperlink inside another one, this document
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   335
        explicitly redefines the HTML concept of hyperlink in a limited set of
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   336
        circumstances.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   337
    </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   338
    <section class="introductory" id="sotd">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   339
      <h2>Status of This Document</h2>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   340
      <p> <em>This section describes the status of this document at the time of
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   341
          its publication. Other documents may supersede this document. A list
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   342
          of current <abbr title="World Wide Web Consortium">W3C</abbr>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   343
          publications and the latest revision of this technical report can be
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   344
          found in the <a href="http://www.w3.org/TR/"><abbr title="World Wide Web Consortium">W3C</abbr>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   345
            technical reports index</a> at http://www.w3.org/TR/.</em> </p>
106
c06d1db5185c changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 105
diff changeset
   346
      <p> This document is proposed to the
c06d1db5185c changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 105
diff changeset
   347
        HTML Accessibility Task Force for publication as a Candidate Recommendation.
c06d1db5185c changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 105
diff changeset
   348
        If you wish to make comments regarding this document, please send
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   349
        them to <a href="mailto:public-html-a11y@w3.org">public-html-a11y@w3.org</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   350
        (<a href="mailto:public-html-a11y-request@w3.org?subject=subscribe">subscribe</a>,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   351
        <a href="http://lists.w3.org/Archives/Public/public-html-a11y/">archives</a>).
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   352
All
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   353
        feedback is welcome. Bugs can also be filed directly into the <a href="https://www.w3.org/Bugs/Public/buglist.cgi?product=HTML%20WG&amp;amp;component=HTML%20Image%20Description%20Extension">W3C
103
da515e62c001 changes to SOTD
Mark Sadecki <mark@w3.org>
parents: 102
diff changeset
   354
          Bug tracker for this specification</a>. This Candidate
da515e62c001 changes to SOTD
Mark Sadecki <mark@w3.org>
parents: 102
diff changeset
   355
        Recommendation is expected to advance to Proposed Recommendation no earlier
da515e62c001 changes to SOTD
Mark Sadecki <mark@w3.org>
parents: 102
diff changeset
   356
        than 07 August 2014.</p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   357
      <p>Following feedback on the <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130312/">First
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   358
          Public Working Draft</a>, a number of <a href="https://www.w3.org/Bugs/Public/buglist.cgi?product=HTML%20WG&amp;amp;component=HTML%20Image%20Description%20Extension">bugs</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   359
        were raised and resolved and a <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130606/">Second
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   360
          Public Working Draft</a> was published for review. Review of this
105
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   361
        draft did not produce any new substantive issues, and a
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   362
        <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130716/">Last Call Working Draft</a>
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   363
        was published. Comments on that draft
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   364
        <a href="http://www.w3.org/WAI/PF/HTML/longdesc/comment-disposition.html">were resolved</a>,
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   365
        resulting in this draft.</p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   366
      <p>Significant changes between successive public drafts are tracked in the
105
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   367
        <a href="#changes">Change History section</a>. Note that this will become a separate document on publication of a CR</p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   368
      <p>This document is intended to become a <abbr title="World Wide Web Consortium">W3C</abbr>
105
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   369
        Recommendation.
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   370
      </p>
105
54131b53d5f3 changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 104
diff changeset
   371
      <p> Publication as a Candidate Recommendation does not imply endorsement by the <abbr
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   372
          title="World Wide Web Consortium">W3C</abbr>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   373
        Membership. This is a draft document and may be updated, replaced or
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   374
        obsoleted by other documents at any time. It is inappropriate to cite
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   375
        this document as other than work in progress. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   376
      <p> This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   377
          February 2004 <abbr title="World Wide Web Consortium">W3C</abbr>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   378
          Patent Policy</a>. <abbr title="World Wide Web Consortium">W3C</abbr>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   379
        maintains a <a href="http://www.w3.org/2004/01/pp-impl/40318/status" rel="disclosure">public
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   380
          list of any patent disclosures</a> made in connection with the
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   381
        deliverables of the group; that page also includes instructions for
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   382
        disclosing a patent. An individual who has actual knowledge of a patent
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   383
        which the individual believes contains <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   384
          Claim(s)</a> must disclose the information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   385
          6</a> of the <abbr title="World Wide Web Consortium">W3C</abbr>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   386
        Patent Policy. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   387
    </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   388
    <section id="toc">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   389
      <h2 class="introductory">Table of Contents</h2>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   390
      <ul class="toc">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   391
        <li class="tocline"><a class="tocxref" href="#intro"><span class="secno">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   392
            </span>Introduction</a></li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   393
        <li class="tocline"><a class="tocxref" href="#conformance"><span class="secno">1.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   394
              </span>Conformance</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   395
          <ul class="toc">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   396
            <li class="tocline"><a class="tocxref" href="#dependencies"><span class="secno">1.1
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   397
                  </span>Dependencies</a></li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   398
          </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   399
        </li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   400
        <li class="tocline"><a class="tocxref" href="#UCnR"><span class="secno">2.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   401
              </span>Use Cases and Requirements</a></li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   402
        <li class="tocline"><a class="tocxref" href="#longdesc"><span class="secno">3.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   403
              </span>The <code>longdesc</code> Attribute</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   404
          <ul class="toc">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   405
            <li class="tocline"><a class="tocxref" href="#extensions-to-the-element-interface"><span
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   406
                  class="secno">3.1
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   407
                  </span>Extensions to the <code>HTMLImageElement</code>
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   408
                Interface</a>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   409
              <ul class="toc">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   410
                <li class="tocline"><a class="tocxref" href="#attributes"><span
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   411
                      class="secno">3.1.1
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   412
                      </span>Attribute</a></li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   413
              </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   414
            </li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   415
          </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   416
        </li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   417
        <li class="tocline"><a class="tocxref" href="#acknowledgements"><span class="secno">A.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   418
              </span>Acknowledgements</a></li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   419
        <li class="tocline"><a class="tocxref" href="#references"><span class="secno">B.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   420
              </span>References</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   421
          <ul class="toc">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   422
            <li class="tocline"><a class="tocxref" href="#normative-references"><span
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   423
                  class="secno">B.1
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   424
                  </span>Normative References</a></li>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   425
            <li class="tocline"><a class="tocxref" href="#informative-references"><span
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   426
                  class="secno">B.2
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   427
                  </span>Informative References</a></li>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   428
          </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   429
        </li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   430
        <li class="tocline"><a class="tocxref" href="#changes"><span class="secno">C.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   431
              </span>Change History</a></li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   432
      </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   433
    </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   434
    <section id="intro" class="introductory">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   435
      <h1>Introduction</h1>
81
7e746d7c4194 Added text to the Introduction section that more clearly defines the longdesc attribute per EOWG Comments
Mark Sadecki <mark@w3.org>
parents: 80
diff changeset
   436
83
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   437
      <p>Text alternatives are used to make visual information accessible by describing
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   438
        the information or function represented in an image.  The <code>alt</code>
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   439
        attribute is designed to provide a concise description or functional equivalent
84
06d0047990da updated date
Mark Sadecki <mark@w3.org>
parents: 83
diff changeset
   440
        for an image.  For some images and contexts, more detail is required to convey
90
16b132930901 ported changes from pubrules failures
Mark Sadecki <mark@w3.org>
parents: 89
diff changeset
   441
        all the information contained in the image. The <code>longdesc</code> attribute
83
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   442
        is designed as a means to provide this level of detail.</p>
81
7e746d7c4194 Added text to the Introduction section that more clearly defines the longdesc attribute per EOWG Comments
Mark Sadecki <mark@w3.org>
parents: 80
diff changeset
   443
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   444
      <p>HTML 4 provided a <code>longdesc</code> attribute for the <code>img</code>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   445
        element that enabled a machine-discoverable description of an image to
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   446
        be linked to the image. This extension specification defines a <code>longdesc</code>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   447
        attribute to provide that functionality for HTML5.</p>
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   448
      <div class="example" role="region" aria-label="example">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   449
        <pre>
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   450
<span class="informative">Example: (Informative)</span>
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   451
<code class="language-markup">
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   452
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   453
&lt;!-- The description is somewhere on the same page as the image --&gt;
90
16b132930901 ported changes from pubrules failures
Mark Sadecki <mark@w3.org>
parents: 89
diff changeset
   454
&lt;img src="http://example.com/graph1" alt="Drinks are getting sweeter"
62
6ddbb6ab517c removed "title" attribute from example per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 61
diff changeset
   455
    longdesc="#graph1Explained"&gt;
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   456
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   457
&lt;!-- The description is a page on its own --&gt;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   458
&lt;img src="figure1" alt="figure 1" longdesc="http://example.com/desc1"&gt;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   459
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   460
&lt;!-- The description is one of several within an external page --&gt;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   461
&lt;img src="ExampleImage" alt="example" longdesc="http://example.com/descs#item3"&gt;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   462
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   463
&lt;!-- The description is included in a data: URI --&gt;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   464
&lt;img src="logo" alt="W3C" longdesc="data:text/html;charset=utf-8;,%3C!DOCTYPE%20html%3E
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   465
%3Chtml%3E%3Chead%3E%3Ctitle%3EDescription%20of%20the%20W3C%20Logo%3C/title%3E%3C/head%3E
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   466
%3Cbody%3E%3Cp%3EA%20blue%20capital%20letter%20%22W%22%20with%20kerning%20so%20it%20
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   467
touches%20a%20blue%203%2C%20followed%20by%20a%20black%20shadow%20of%20a%20white%20
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   468
capital%20letter%20C%20all%20on%20a%20white%20background%3C/body%3E%3C/html%3E"&gt;</code></pre>
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   469
</div>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   470
    </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   471
    <section id="conformance">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   472
      <h2><span class="secno">1. </span>Conformance</h2>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   473
      <p>All authoring guidelines, diagrams, examples, notes, and sections marked
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   474
        "<a href="http://www.w3.org/TR/qaframe-spec/#informative-def">informative</a>"
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   475
        in this specification are informational. Everything else in this specification is
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   476
        "<a href="http://www.w3.org/TR/qaframe-spec/#normative-def">normative</a>" as described in
71
b47874bf45dd changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
Mark Sadecki <mark@w3.org>
parents: 70
diff changeset
   477
        [<a href="#bib-QAFRAME">QAFRAME</a>]. </p>
66
b7ad741c26e5 editorial changes to Conformance section per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 65
diff changeset
   478
      <p>The key words <em title="must" class="rfc2119">"must"</em>, <em title="should"
96
132340296f3f cleaned up RFC2119 keywords and added should not
Mark Sadecki <mark@w3.org>
parents: 95
diff changeset
   479
        class="rfc2119">"should"</em>, <em title="should not" class="rfc2119">"should not"</em> and
132340296f3f cleaned up RFC2119 keywords and added should not
Mark Sadecki <mark@w3.org>
parents: 95
diff changeset
   480
        <em title="may" class="rfc2119">"may"</em> in this specification are to be interpreted as
132340296f3f cleaned up RFC2119 keywords and added should not
Mark Sadecki <mark@w3.org>
parents: 95
diff changeset
   481
        described in [<cite><a class="bibref" href="#bib-RFC2119">RFC2119</a></cite>].</p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   482
      <section id="dependencies">
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   483
        <h3><span class="secno">1.1 </span>Dependencies and Definitions</h3>
66
b7ad741c26e5 editorial changes to Conformance section per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 65
diff changeset
   484
        <p>The Interface Definition Language (IDL) fragments in this specification <em title="must" class="rfc2119">must</em>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   485
          be interpreted as required for conforming IDL fragments, as described
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   486
          in the Web IDL specification. [<cite><a class="bibref" href="#bib-WEBIDL">WEBIDL</a></cite>]</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   487
        <p>The terms "<a href="http://www.w3.org/TR/html5/infrastructure.html#valid-url-potentially-surrounded-by-spaces">valid
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   488
            non-empty URL potentially surrounded by spaces</a>", "<a href="http://www.w3.org/TR/html5/links.html#hyperlink">hyperlink"</a>,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   489
          and "<a href="http://www.w3.org/TR/html5/infrastructure.html#reflect">reflect</a>",
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   490
          used in this specification are defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>],
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   491
          although this specification modifies the semantics of the term
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   492
          "hyperlink" in allowing hyperlinks to be nested in certain specific
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   493
          circumstances.</p>
107
ac507017569f changes to SOtD
Mark Sadecki <mark@w3.org>
parents: 106
diff changeset
   494
        <p>This document uses the terms <dfn>accessible</dfn> and <dfn>accessibility</dfn> in the sense
101
71bb6770702e added reference to Intro to Web Accessibility
Mark Sadecki <mark@w3.org>
parents: 100
diff changeset
   495
        of ensuring people with disabilities can use the Web. Further information is available, e.g. <a href="http://www.w3.org/WAI/intro/accessibility.php">Introduction to Web Accessibility</a>.</p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   496
      </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   497
    </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   498
    <section id="UCnR">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   499
      <h2><span class="secno">2. </span>Use Cases and Requirements</h2>
83
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   500
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   501
      <p>The <code>longdesc</code> attribute gives authors a mechanism for referencing a long text
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   502
        description for images which cannot be adequately described using shorter description
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   503
        mechanisms, such as in the following use cases.</p>
2658c31cf7bb Swapped Introduction and UCnR intros per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 82
diff changeset
   504
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   505
      <h3 id="use-cases">Use Cases</h3>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   506
      <dl>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   507
        <dt>Identifying a well-known image</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   508
        <dd>Identifying an image is often important context for a discussion.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   509
          There are many well-known images which are widely reproduced and well
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   510
          known. In some cases, such as "Mona Lisa", "Guernica", "A Starry Night",
71
b47874bf45dd changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
Mark Sadecki <mark@w3.org>
parents: 70
diff changeset
   511
          or "The Scream", the most effective way to identify an
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   512
          image is to use its title, creator, and similar information that would
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   513
          be found in a catalog. But different people know images by different
70
ccd4d8ef941e improved examples "Identifying a well known image" use case
Mark Sadecki <mark@w3.org>
parents: 69
diff changeset
   514
          titles, and some titles are not well known. When the image itself
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   515
          cannot be seen, a description can often be used to offer easier
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   516
          recognition than the cataloging information, for example "Washington
78
f44b866c222b further edits to Identifying a well-known image use case
Mark Sadecki <mark@w3.org>
parents: 77
diff changeset
   517
          crossing a river, standing heroically in a boat, while soldiers
f44b866c222b further edits to Identifying a well-known image use case
Mark Sadecki <mark@w3.org>
parents: 77
diff changeset
   518
          do all the paddling", or "the Da Vinci picture of the man in a square and
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   519
          a circle".</dd>
97
a4a851961626 updates to Requires and Helped by in UCnR per UAWG comments
Mark Sadecki <mark@w3.org>
parents: 96
diff changeset
   520
        <dd><em>Requires</em>: <a href="#discoverability">Discoverability</a></dd>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   521
        <dd><em>Helped by</em>: <a href="#inline">Inline</a>,
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   522
          <a href="#optional-consumption">Optional Consumption</a>,
97
a4a851961626 updates to Requires and Helped by in UCnR per UAWG comments
Mark Sadecki <mark@w3.org>
parents: 96
diff changeset
   523
          <a href="#reuse">Reuse</a>,
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   524
          <a href="#simple-return">Simple Return</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   525
        <dt>Describing a complex diagram</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   526
        <dd>In many environments diagrams are used to explain a concept or
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   527
          transmit information efficiently. For a user with a reduced ability to
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   528
          see the image (poor contrast vision and other conditions are as
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   529
          relevant here as a complete lack of vision), a description can enable
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   530
          that user to understand the information being presented.</dd>
97
a4a851961626 updates to Requires and Helped by in UCnR per UAWG comments
Mark Sadecki <mark@w3.org>
parents: 96
diff changeset
   531
        <dd><em>Requires</em>:
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   532
          <a href="#structured-markup">Structured Markup</a></dd>
97
a4a851961626 updates to Requires and Helped by in UCnR per UAWG comments
Mark Sadecki <mark@w3.org>
parents: 96
diff changeset
   533
        <dd><em>Helped by</em>: <a href="#inline">Inline</a>,
a4a851961626 updates to Requires and Helped by in UCnR per UAWG comments
Mark Sadecki <mark@w3.org>
parents: 96
diff changeset
   534
          <a href="#reuse">Reuse</a>,
a4a851961626 updates to Requires and Helped by in UCnR per UAWG comments
Mark Sadecki <mark@w3.org>
parents: 96
diff changeset
   535
          <a href="#simple-return">Simple Return</a></dd>
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   536
        <dt>Teaching accessible development</dt>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   537
        <dd>In many environments producing content that is accessible to users
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   538
          regardless of disability is a legal and/or market requirement. </dd>
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   539
        <dd><em>Requires</em>: <a href="#backwards-compatibility">Backwards Compatibility</a>,
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   540
          <a href="#maintenance">Maintenance</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   541
        <dt>A self-describing artistic work</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   542
        <dd>The visual design of many pages is an important part of the message
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   543
          the author intends to convey to a fully-sighted user. Many authors
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   544
          would like to convey as much of that design as possible to a user with
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   545
          low or no vision. </dd>
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   546
        <dd><em>Requires</em>: <a href="#discoverability">Discoverability</a>,
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   547
          <a href="#no-visual-encumbrance">No Visual Encumbrance</a>,
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   548
          <a href="#structured-markup">Structured Markup</a></dd>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   549
        <dd><em>Helped by</em>: <a href="#reuse">Reuse</a>,
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   550
          <a href="#simple-return">Simple Return</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   551
        <dt>Referring to an existing description</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   552
        <dd>Many well-known images are already described by other sources. The
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   553
          copyright on those sources may not be compatible with re-publishing
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   554
          the description, but there is little value in making a new one. </dd>
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   555
        <dd><em>Requires</em>: <a href="#discoverability">Discoverability</a>,
104
305f613b1aa4 fixes to UCnR
Mark Sadecki <mark@w3.org>
parents: 103
diff changeset
   556
          <a href="#optional-consumption">Optional Consumption</a>,
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   557
          <a href="#reuse">Reuse</a>,
96
132340296f3f cleaned up RFC2119 keywords and added should not
Mark Sadecki <mark@w3.org>
parents: 95
diff changeset
   558
          <a href="#simple-return">Simple Return</a>
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   559
        <dd><em>Helped by</em>: <a href="#no-visual-encumbrance">No Visual Encumbrance</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   560
        <dt>Linking to a description included within a page</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   561
        <dd>If an image already has a description included within a page, making
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   562
          the linkage explicit can provide further clarity for a user who is not
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   563
          able to interpret the default layout. For example this happens when
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   564
          users force a re-layout of the page elements because they have
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   565
          magnified the content, or because they do not see the default visual
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   566
          relationship between the element and its description.</dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   567
        <dd>This practice also enables description to be provided for all users.</dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   568
        <dd>By keeping the association clear the content maintainer can more
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   569
          easily check that the description and link are actually correct.</dd>
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   570
        <dd><em>Requires</em>: <a href="#discoverability">Discoverability</a>,
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   571
          <a href="#inline">Inline</a>,
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   572
          <a href="#optional-consumption">Optional Consumption</a>,
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   573
          <a href="#simple-return">Simple Return</a>,
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   574
          <a href="#structured-markup">Structured Markup</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   575
        <dt>Localizing descriptions</dt>
64
fd6cee5efc3f changed localized to translated per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 63
diff changeset
   576
        <dd>When content is translated to multiple languages, it is important
68
1cc33f01787e changed human consumption to humans per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 67
diff changeset
   577
          that metadata intended for humans, such as image
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   578
          descriptions, can be readily localized.</dd>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   579
        <dd><em>Helped by</em>: <a href="#structured-markup">Structured Markup</a>,
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   580
          <a href="#reuse">Reuse</a>, <a href="#maintenance">Maintenance</a>.</dd>
73
f33a6fab75ed added additional use cases for discoverability per comments from Yandex
Mark Sadecki <mark@w3.org>
parents: 72
diff changeset
   581
        <dt>Image search</dt>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   582
        <dd>Many search engines provide an option to search for images and present
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   583
          the results out of context. The ability to discover and process identified
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   584
          descriptions allows search engines to improve the source material they use
73
f33a6fab75ed added additional use cases for discoverability per comments from Yandex
Mark Sadecki <mark@w3.org>
parents: 72
diff changeset
   585
          to support text-based queries for images.</dd>
f33a6fab75ed added additional use cases for discoverability per comments from Yandex
Mark Sadecki <mark@w3.org>
parents: 72
diff changeset
   586
        <dd><em>Requires</em>: <a href="#discoverability">Discoverability</a></dd>
94
64a9e65cbab3 Suggested changes to Required and Helped by lists for UCnR
Mark Sadecki <mark@w3.org>
parents: 93
diff changeset
   587
        <dd><em>Helped by</em>: <a href="#structured-markup">Structured Markup</a></dd>
73
f33a6fab75ed added additional use cases for discoverability per comments from Yandex
Mark Sadecki <mark@w3.org>
parents: 72
diff changeset
   588
        <dt>Describing images</dt>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   589
        <dd>Image search tools identify multiple copies of the same image. Where a
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   590
          search tool can identify a description of an image, this can be provided
73
f33a6fab75ed added additional use cases for discoverability per comments from Yandex
Mark Sadecki <mark@w3.org>
parents: 72
diff changeset
   591
          to the user as a description for any copies of that image.</dd>
f33a6fab75ed added additional use cases for discoverability per comments from Yandex
Mark Sadecki <mark@w3.org>
parents: 72
diff changeset
   592
        <dd><em>Requires</em>: <a href="#discoverability">Discoverability</a></dd>
80
b63864deb4e5 Added 'Helped by: Reuse' to Describing Images use case
Mark Sadecki <mark@w3.org>
parents: 79
diff changeset
   593
        <dd><em>Helped by</em>: <a href="#reuse">Reuse</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   594
      </dl>
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   595
      <h3 id="requirements">Requirements for an Image Description Functionality</h3>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   596
      <dl>
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   597
        <dt id="backwards-compatibility">Backwards Compatibility </dt>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   598
        <dd>It <em class="rfc2119">should</em> be possible to use existing
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   599
          tools and techniques to associate an image with its description. </dd>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   600
        <dt id="discoverability">Discoverability </dt>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   601
        <dd class="rfc2119">It <em class="rfc2119">must</em> be simple for a
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   602
          user agent to automatically discover a description provided for a
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   603
          given image.</dd>
86
3e6f40eb7895 fixes editing error made when reordering Requirements (Discoverability/Structured Markup)
Mark Sadecki <mark@w3.org>
parents: 85
diff changeset
   604
        <dd>A user <em class="rfc2119">should</em> be able to determine that
3e6f40eb7895 fixes editing error made when reordering Requirements (Discoverability/Structured Markup)
Mark Sadecki <mark@w3.org>
parents: 85
diff changeset
   605
            there is a description available for a given image. </dd>
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   606
        <dt id="inline">Inline</dt>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   607
        <dd>It <em class="rfc2119">must</em> be possible to associate a
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   608
          description in the body of a page with an image in that page. </dd>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   609
        <dt id="maintenance">Maintenance</dt>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   610
        <dd>It <em class="rfc2119">must</em> be simple to maintain a library of
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   611
          images and descriptions for dynamic assembly, or dis-assembly and
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   612
          re-assembly, of content. </dd>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   613
        <dt id="no-visual-encumbrance">No Visual Encumbrance</dt>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   614
        <dd>It <em class="rfc2119">must</em> be possible to provide a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   615
          description for an image without forcing the description to be
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   616
          rendered on the page.</dd>
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   617
        <dt id="optional-consumption">Optional Consumption</dt>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   618
        <dd>A user <em class="rfc2119">must</em> be able to choose not to read
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   619
          the long description of a given image.</dd>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   620
        <dt id="reuse">Reuse</dt>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   621
        <dd>It <em class="rfc2119">must</em> be possible to re-use a single
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   622
          description for multiple occurrences of an image.</dd>
63
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   623
        <dt id="simple-return">Simple Return</dt>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   624
        <dd>A user <em class="rfc2119">must</em> be able to return from the
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   625
          description to the image. </dd>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   626
        <dt id="structured-markup">Structured Markup</dt>
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   627
        <dd>It <em class="rfc2119">must</em> be possible to include rich markup
c8da8ec4a07b linked use case references to definitions, made case consistent and ordered definitions in alpha order per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 62
diff changeset
   628
          (e.g. HTML5) in the description of the image.</dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   629
      </dl>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   630
    </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   631
    <section id="longdesc">
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   632
      <h2><span class="secno"></span>3. The <code>longdesc</code> Attribute</h2>
61
f4d139c52636 removed "Note that" text from Abstract and Section 3 per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 60
diff changeset
   633
      <p>This extension changes the definition of a hyperlink in HTML,
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   634
        by allowing a <code>longdesc</code> attribute to occur inside a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   635
        hyperlink.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   636
      <h3 id="implementation">3.0 Implementation</h3>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   637
      <h4 id="authors-and-conformance-checkers">3.0.1 Authors and Conformance
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   638
        Checkers</h4>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   639
      <section id="parsing">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   640
        <p class="rfc2119">Zero or one <code>longdesc</code> attributes <em class="rfc2119">may</em>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   641
          be added to any <code>img</code> element.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   642
        <p>The <code>longdesc</code> attribute <em class="rfc2119">must</em>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   643
          contain a <a href="http://www.w3.org/TR/html5/infrastructure.html#valid-url-potentially-surrounded-by-spaces">valid
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   644
            non-empty URL potentially surrounded by spaces</a>. The URL is a <a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   645
            href="http://dev.w3.org/html5/spec/links.html#hyperlink">hyperlink</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   646
          to a description of the image that the parent <code>img</code>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   647
          element represents. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   648
        <p>The linked description <em class="rfc2119">should</em> be in a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   649
          broadly accessible format.</p>
87
774d59138b7f fixes errant &gt; after divs
Mark Sadecki <mark@w3.org>
parents: 86
diff changeset
   650
        <div class="note" role="region" aria-label="informative">
72
7fb44d0e1473 changed "not normative" to "informative" - continuation of changeset71
Mark Sadecki <mark@w3.org>
parents: 71
diff changeset
   651
          <p><em>This section is informative</em></p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   652
          <p>Best practices for checking descriptions of images are beyond the
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   653
            scope of this document, but there are many resources available.
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   654
            For further guidance authoring tool developers can consult e.g.
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   655
            <a href="http://www.w3.org/TR/2013/WD-IMPLEMENTING-ATAG20-20131107/#prompt-long-description">Appendix A-3: Long text descriptions</a>
75
145e07b3f468 added more precise references to relevant sections of ATAG in Req for longdesc attr per Jan Richards comment
Mark Sadecki <mark@w3.org>
parents: 74
diff changeset
   656
            of [<a href="#bib-ATAG">ATAG</a>].</p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   657
          <p>High quality implementation in authoring and content management
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   658
            tools is likely to include checking for common errors, such as
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   659
            including a description instead of a URL in the attribute, or
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   660
            pointing to a resource that is an image or plain text, which are
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   661
            often poor choices for a high-quality description.  Additional
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   662
            examples of error checking and repair options can be found in
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   663
            <a href="http://www.w3.org/TR/2013/WD-IMPLEMENTING-ATAG20-20131107/#checking-types">Appendix B: Levels of Checking Automation</a>
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   664
            and <a href="http://www.w3.org/TR/2013/WD-IMPLEMENTING-ATAG20-20131107/#repair-types">Appendix C: Levels of Repair Automation</a>
75
145e07b3f468 added more precise references to relevant sections of ATAG in Req for longdesc attr per Jan Richards comment
Mark Sadecki <mark@w3.org>
parents: 74
diff changeset
   665
            of [<a href="#bib-ATAG">ATAG</a>]</p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   666
        </div>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   667
        <h4 id="authors">3.0.2 Authors</h4>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   668
        <p>When a description is only part of the target document, authors
93
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   669
          <em class="rfc2119">should</em> link to a container element in the target
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   670
          document that contains the entire description.</p>
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   671
          <div class="example" role="region" aria-label="example">
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   672
            <pre>
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   673
<span class="informative">Example: (Informative)</span>
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   674
<code class="language-markup">
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   675
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   676
&lt;!-- Image with description that is only part of target document --&gt;
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   677
&lt;img src=&quot;foo.png&quot; alt=&quot;Example image&quot; longdesc=&quot;example.html#desc2&quot;&gt;
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   678
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   679
&lt;!-- Target document --&gt;
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   680
&lt;section id=&quot;desc2&quot;&gt;
108
264f89e213bb corrected h2 typo in code example
Mark Sadecki <mark@w3.org>
parents: 107
diff changeset
   681
  &lt;h2&gt;Image foo.png&lt;/h2&gt;
93
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   682
  &lt;p&gt;Description of the image...&lt;/p&gt;
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   683
&lt;/section&gt;
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   684
          </code></pre>
30ec78eee32b added a code example for linking to document fragments and clarified how that should happen
Mark Sadecki <mark@w3.org>
parents: 92
diff changeset
   685
        </div>
85
9fdbd44406c2 adds role=region and aria-label=informative to informative sections
Mark Sadecki <mark@w3.org>
parents: 84
diff changeset
   686
        <div class="note" role="region" aria-label="informative">
72
7fb44d0e1473 changed "not normative" to "informative" - continuation of changeset71
Mark Sadecki <mark@w3.org>
parents: 71
diff changeset
   687
          <p><em>This section is informative</em></p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   688
          <p>Best practices for full descriptions of images are beyond the scope
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   689
            of this document, but there are many resources available.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   690
        </div>
92
8bf116468476 moved rfc2119 /span to include not, i.e. should not
Mark Sadecki <mark@w3.org>
parents: 91
diff changeset
   691
        <p>Authors <em class="rfc2119">should not</em> rely solely on longdesc where standards
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   692
          exist to provide direct, structured access.</p>
87
774d59138b7f fixes errant &gt; after divs
Mark Sadecki <mark@w3.org>
parents: 86
diff changeset
   693
        <div class="note" role="region" aria-label="informative">
74
8d7c0e2d97d4 added clarifying text RE: use of modern techniques in conjunction with longdesc where appropriate
Mark Sadecki <mark@w3.org>
parents: 73
diff changeset
   694
          <p><em>This section is informative</em></p>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   695
          <p>For example a MathML version of mathematical content, or an SVG image that
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   696
            uses the accessibility features of SVG, can provide better accessibility to
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   697
            users with appropriate technology. In such cases, it is appropriate to use
74
8d7c0e2d97d4 added clarifying text RE: use of modern techniques in conjunction with longdesc where appropriate
Mark Sadecki <mark@w3.org>
parents: 73
diff changeset
   698
            longdesc as a fallback strategy, in combination with more modern techniques.</p>
8d7c0e2d97d4 added clarifying text RE: use of modern techniques in conjunction with longdesc where appropriate
Mark Sadecki <mark@w3.org>
parents: 73
diff changeset
   699
        </div>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   700
        <h4 id="user-agents">3.0.3 User Agents</h4>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   701
        <p>If the <code>longdesc</code> value is valid, User agents <em class="rfc2119">must</em>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   702
          make the link available to all users through the regular user
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   703
          interface(s).&nbsp; </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   704
        <p>If the <code>longdesc</code> value is valid, User agents <em class="rfc2119">must</em>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   705
          expose the link to relevant APIs, especially accessibility-oriented
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   706
          APIs. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   707
        <p>User agents <em class="rfc2119">should</em> enable users to discover
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   708
          when images in a page contain a long description.</p>
87
774d59138b7f fixes errant &gt; after divs
Mark Sadecki <mark@w3.org>
parents: 86
diff changeset
   709
        <div class="note" role="region" aria-label="informative">
72
7fb44d0e1473 changed "not normative" to "informative" - continuation of changeset71
Mark Sadecki <mark@w3.org>
parents: 71
diff changeset
   710
          <p><em>This section is informative</em></p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   711
          <p><code>longdesc</code> can be present on an image within a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   712
            hyperlink. This does not change the requirements on user agents,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   713
            which must still enable the hyperlink to be followed.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   714
          <p>Complete documentation of best practices for implementation is
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   715
            beyond the scope of this document. These notes are offered to help
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   716
            minimize the impact of common mistakes.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   717
          <p>A common mistake in the past has been to use a description, instead
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   718
            of a URL that links to a description. Converting such values to
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   719
            data: URLs is a repair strategy for user agents that can help users
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   720
            to recover in cases where authors have made this mistake. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   721
          <p>It is usually helpful when the behavior for finding, reading, and
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   722
            returning from a long description to the image described is a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   723
            consistent experience.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   724
          <p>Further information on making user agents accessible can be found
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   725
            in [<a href="#bib-UAAG">UAAG</a>].</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   726
        </div>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   727
      </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   728
      <section id="extensions-to-the-element-interface">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   729
        <h3><span class="secno">3.1 </span>Extension to the <code><a title="element"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   730
              class="externalDFN"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   731
              data-spec="HTML5">HTMLImageElement</a></code>
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   732
          Interface</h3>
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   733
        <pre class="idl">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   734
<span class="idlInterface" id="idl-def-Element">partial interface <span
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   735
class="idlInterfaceID">HTMLImageElement</span> {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   736
<span class="idlAttribute">             attribute <span class="idlAttrType"><a>DOMString</a></span> <span
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   737
class="idlAttrName"><a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   738
href="#widl-Element-longdesc">longdesc</a></span>;</span>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   739
};</span></pre>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   740
        <section id="attributes">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   741
          <h4><span class="secno">3.1.1 </span>Attribute</h4>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   742
          <dl class="attributes">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   743
            <dt id="widl-Element-longdesc"><code>longdesc</code> of type <span
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   744
                class="idlAttrType"><a>DOMString</a></span></dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   745
            <dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   746
              <p class="rfc2119">The <dfn id="dfn-dom-element-longdesc"><code>longdesc</code></dfn>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   747
                IDL attribute <em class="rfc2119">must</em> be a valid
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   748
                non-empty URL potentially surrounded by spaces. It defines a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   749
                hyperlink to a detailed description of the image its parent <code><a
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   750
                    title="element"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   751
                    class="externalDFN"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   752
                    data-spec="DOM4">HTMLImageElement</a></code>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   753
                represents.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   754
            </dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   755
            <dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   756
              <p>The <code>longdesc</code> IDL attribute <em class="rfc2119">must</em>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   757
                <a href="http://www.w3.org/TR/html5/infrastructure.html#reflect">reflect</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   758
                the HTML content attribute <code>longdesc</code>. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   759
            </dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   760
            <dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   761
              <dl class="note">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   762
                <dt>
72
7fb44d0e1473 changed "not normative" to "informative" - continuation of changeset71
Mark Sadecki <mark@w3.org>
parents: 71
diff changeset
   763
                  <p><em>This section is informative</em></p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   764
                  <p><var>image</var>.<code title="dom-Element-innerHTML">longdesc</code>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   765
                    [ = <var>value</var> ]</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   766
                </dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   767
                <dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   768
                  <p>Returns a DOMString that represents the attribute's
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   769
                    contents. </p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   770
                  <p>Can be set, to replace the contents of the attribute with
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   771
                    the given string.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   772
                </dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   773
              </dl>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   774
            </dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   775
          </dl>
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   776
            <div class="example" role="region" aria-label="example">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   777
              <pre class="example">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   778
<span class="informative">Example: (Informative)</span>
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   779
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   780
<code class="language-javascript">/*Make the first internal longdesc reference absolute*/
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   781
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   782
var baseURL = document.location.origin + document.location.pathname
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   783
var someImage = document.querySelector('img[longdesc^=#]');
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   784
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   785
someImage.longdesc = baseURL + someImage.longdesc;</code></pre>
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   786
            </div>
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   787
            <div class="example" role="region" aria-label="example">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   788
              <pre class="example">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   789
<span class="informative">Example: (Informative)</span>
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   790
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   791
<code class="language-javascript">/*Open new windows for each longdesc found*/
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   792
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   793
var describedImages = document.querySelectorAll('img[longdesc]');
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   794
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   795
for (i in describedImages) {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   796
  if (i.longdesc)
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   797
    window.open(i.longdesc);
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   798
}</code></pre>
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   799
            </div>
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   800
            <div class="example" role="region" aria-label="example">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   801
              <pre class="example">
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   802
<span class="informative">Example: (Informative)</span>
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   803
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   804
<code class="language-javascript">/*Tries to repair errors where the longdesc isn't a URI*/
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   805
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   806
var describedImages = document.querySelectorAll('img[longdesc]');
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   807
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   808
for (i in describedImages) {
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   809
  if (i.longdesc &amp;&amp; !(validURL(i.longdesc)) { //assumes some URL validating function
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   810
    var theData = encodeURIComponent(i.longdesc);
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   811
    i.longdesc = "data:text/plain;charset=";
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   812
    i.longdesc += document.charset;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   813
    i.longdesc += theData;
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   814
  }
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   815
}</code></pre>
91
5342031cd82a changed informative notifications for code samples from CSS content to native dom content
Mark Sadecki <mark@w3.org>
parents: 90
diff changeset
   816
</div>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   817
        </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   818
      </section>
85
9fdbd44406c2 adds role=region and aria-label=informative to informative sections
Mark Sadecki <mark@w3.org>
parents: 84
diff changeset
   819
      <section class="appendix" id="acknowledgements" aria-label="informative">
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   820
        <h2><span class="secno">A. </span>Acknowledgements</h2>
72
7fb44d0e1473 changed "not normative" to "informative" - continuation of changeset71
Mark Sadecki <mark@w3.org>
parents: 71
diff changeset
   821
        <p><em>This section is informative</em></p>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   822
        <p>Thanks to the HTML Working Group of the late 1990s for the original
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   823
          specification of longdesc, to those who have implemented it in various
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   824
          kinds of software, and to many many people involved with the
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   825
          development of HTML5 (including but not limited to those who discussed
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   826
          "ISSUE-30" in the HTML Working Group, the Protocols and Formats
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   827
          Working Group, the W3C Advisory Board, and around countless dinner
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   828
          tables, coffee breaks, and elsewhere) for the ideas, discussions and
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   829
          contributions that led to the initial draft of this specification.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   830
          With the exception of Laura Carlson, who did far more very valuable
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   831
          work than it took me to produce this specification, I haven't named
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   832
          them: the list might be larger than the content of the specification.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   833
        <p>For specific comments and suggestions that led to improvements over
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   834
          successive drafts of this specification, thanks to the W3C's HTML
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   835
          Accessibility Task Force, the W3C Internationalization Working Group,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   836
          and to Jonathan Avila, Robin Berjon, James Craig, Paul Cotton, Steve
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   837
          Faulkner, John Foliot, Geoff Freed, Peter Gruzca, Richard Ishida, Anne
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   838
          van Kesteren, David MacDonald, Michelle McManus, Chris Mills, Jay
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   839
          Munro, Devarshi Pant, Marta Pawlowska, Silvia Pfeiffer, Wendy Seltzer,
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   840
          Leif Halvard Silli, Mathew Turvey, Klaas 'Z4us' V, and Boris Zbarsky.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   841
          The code examples are rendered with Lea Verou's prism tools. Any
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   842
          errors are despite, not as a result of, their efforts.</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   843
      </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   844
      <section class="appendix" id="references">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   845
        <h2><span class="secno">B. </span>References</h2>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   846
        <section id="normative-references">
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   847
          <h3><span class="secno">B.1 </span>Normative References</h3>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   848
          <dl class="bibliography">
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   849
            <dt id="bib-HTML5">[HTML5]</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   850
            <dd>Robin Berjon et. al., eds. <a href="http://www.w3.org/TR/html5/"><cite>HTML5.</cite></a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   851
              W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   852
            </dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   853
            <dt id="bib-RFC2119">[RFC2119]</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   854
            <dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   855
                  words for use in RFCs to Indicate Requirement Levels.</cite></a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   856
              March 1997. Internet RFC 2119. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a></dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   857
            <dt id="bib-WEBIDL">[WEBIDL]</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   858
            <dd>Cameron McCormack. <a href="http://www.w3.org/TR/2011/WD-WebIDL-20110927/"><cite>Web
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   859
                  IDL.</cite></a> 27 September 2011. W3C Working Draft. (Work in
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   860
              progress.) URL: <a href="http://www.w3.org/TR/2011/WD-WebIDL-20110927/">http://www.w3.org/TR/2011/WD-WebIDL-20110927/</a></dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   861
          </dl>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   862
        </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   863
        <section id="informative-references">
67
d43c6656524b made capitalization of headings consistent throughout document per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 66
diff changeset
   864
          <h3><span class="secno">B.2 </span>Informative References</h3>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   865
          <dl class="bibliography">
71
b47874bf45dd changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
Mark Sadecki <mark@w3.org>
parents: 70
diff changeset
   866
            <dt id="bib-QAFRAME">[QAFRAME]</dt>
b47874bf45dd changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
Mark Sadecki <mark@w3.org>
parents: 70
diff changeset
   867
            <dd>Karl Dubost et. al., eds. <a href="http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/">
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   868
              <cite>QA Framework: Specification Guidelines.</cite></a>, August 2005. W3C Recommendation.
71
b47874bf45dd changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
Mark Sadecki <mark@w3.org>
parents: 70
diff changeset
   869
              URL: <a href="http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/">http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/</a></dd>
75
145e07b3f468 added more precise references to relevant sections of ATAG in Req for longdesc attr per Jan Richards comment
Mark Sadecki <mark@w3.org>
parents: 74
diff changeset
   870
            <dt id="bib-ATAG">[ATAG]</dt>
90
16b132930901 ported changes from pubrules failures
Mark Sadecki <mark@w3.org>
parents: 89
diff changeset
   871
            <dd>Jutta Treviranus et. al., eds. <cite><a href="http://www.w3.org/TR/2013/WD-IMPLEMENTING-ATAG20-20131107/">Implementing ATAG 2.0</a></cite>,
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   872
              October 2011. W3C Working Draft.
75
145e07b3f468 added more precise references to relevant sections of ATAG in Req for longdesc attr per Jan Richards comment
Mark Sadecki <mark@w3.org>
parents: 74
diff changeset
   873
              URL: <a href="http://www.w3.org/TR/2013/WD-IMPLEMENTING-ATAG20-20131107/">http://www.w3.org/TR/2013/WD-IMPLEMENTING-ATAG20-20131107/</a></dd>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   874
            <dt id="bib-UAAG">[UAAG]</dt>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   875
            <dd>Ian Jacobs et. al., eds. <a href="http://www.w3.org/TR/2002/REC-UAAG10-20021217/"><cite>User
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   876
                  Agent Accessibility Guidelines 1.0</cite></a>, December 2002.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   877
              W3C Recommendation. URL: <a href="http://www.w3.org/TR/2002/REC-UAAG10-20021217/">http://www.w3.org/TR/2002/REC-UAAG10-20021217/</a>.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   878
              A draft for a version 2.0 is available at <a href="http://www.w3.org/TR/UAAG20/">http://www.w3.org/TR/UAAG20/</a></dd>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   879
          </dl>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   880
        </section>
85
9fdbd44406c2 adds role=region and aria-label=informative to informative sections
Mark Sadecki <mark@w3.org>
parents: 84
diff changeset
   881
        <section class="appendix" id="changes" aria-label="informative">
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   882
          <h2><span class="secno">C. </span>Change History</h2>
72
7fb44d0e1473 changed "not normative" to "informative" - continuation of changeset71
Mark Sadecki <mark@w3.org>
parents: 71
diff changeset
   883
          <p><em>This section is informative</em></p>
90
16b132930901 ported changes from pubrules failures
Mark Sadecki <mark@w3.org>
parents: 89
diff changeset
   884
          <h3 id="change-third">Between the current draft and the <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130716/">Last Call Working Draft</a></h3>
76
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   885
          <p>Editorial changes include:</p>
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   886
          <ul>
89
e0fa6f0430c6 updated the change history
Mark Sadecki <mark@w3.org>
parents: 88
diff changeset
   887
            <li>Improved markup used for informative sections for better screen
e0fa6f0430c6 updated the change history
Mark Sadecki <mark@w3.org>
parents: 88
diff changeset
   888
              reader support</li>
e0fa6f0430c6 updated the change history
Mark Sadecki <mark@w3.org>
parents: 88
diff changeset
   889
            <li>Moved introductory text from "Use Cases" to "Introduction" and modified
e0fa6f0430c6 updated the change history
Mark Sadecki <mark@w3.org>
parents: 88
diff changeset
   890
            it to more clearly define the <code>longdesc</code> attribute.</li>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   891
            <li>Added more precise references to relevant sections of ATAG in
76
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   892
              the "Implementation" section.</li>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   893
            <li>Added text to clarify the use of longdesc in conjunction with
76
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   894
              other techniques.</li>
79
c8df8a9638ec clarified the additional Use cases added in the Change history section
Mark Sadecki <mark@w3.org>
parents: 78
diff changeset
   895
            <li>Added the "Image Search" and "Describing images" use case.</li>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   896
            <li>Improved examples in the "Identifying a well known image" use
76
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   897
              case</li>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   898
            <li>Clarified the scope of normative text in the "Conformance"
76
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   899
              section.</li>
82
ec1708dec400 Editorial changes to UCnR introduction per EOWG comments
Mark Sadecki <mark@w3.org>
parents: 81
diff changeset
   900
            <li>Hyperlinked "Use Case" references to their definitions and
76
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   901
              rearranged definitions in alphabetical order.</li>
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   902
            <li>Removed "title" attribute from example.</li>
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   903
            <li>Added Mark Sadecki as an editor.</li>
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   904
            <li>Various changes to improve readability and consistency.</li>
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   905
          </ul>
3d201809bd08 updated Change History Section to bring it current
Mark Sadecki <mark@w3.org>
parents: 75
diff changeset
   906
          <h3 id="change-second">Between the <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130716/">Last Call Working Draft</a> and the <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130606/">Second
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   907
              Public Working Draft</a> </h3>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   908
          <p>Editorial changes include:</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   909
          <ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   910
            <li>Explicitly stating that <code>longdesc</code> makes a limited
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   911
              change to the semantics of the term "hyperlink" in HTML</li>
71
b47874bf45dd changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
Mark Sadecki <mark@w3.org>
parents: 70
diff changeset
   912
            <li>Editing of the informative guidance in various places.</li>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   913
            <li>Explicitly adding a reference to the software license to allow
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   914
              people to re-use the code samples and IDL more easily with fewer
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   915
              restrictions.</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   916
          </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   917
          <h3 id="change-first">Between the <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130606/">Second
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   918
              Public Working Draft</a> and the <a href="http://www.w3.org/TR/2013/WD-html-longdesc-20130312/">First
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   919
              Public Working Draft</a> <br>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   920
          </h3>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   921
          <p>Substantive changes include:</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   922
          <ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   923
            <li>Added a requirement that the destination of a <code>longdesc</code>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   924
              <em class="rfc2119">should</em> be "accessible".</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   925
            <li>The requirement to present content through the standard User
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   926
              Interface was changed from <em class="rfc2119">should</em> to <em
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   927
                class="rfc2119">must</em>.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   928
            </li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   929
            <li>The requirement to present content through the standard User
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   930
              Interface was narrowed to apply only to valid values of <code>longdesc</code>.</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   931
            <li>The requirement to present content through the Accessibility
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   932
              APIs was changed from <em class="rfc2119">should</em> to <em class="rfc2119">must</em>.
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   933
            </li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   934
            <li>The requirement to present content through the Accessibility
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   935
              APIs was narrowed to apply only to valid values of <code>longdesc</code>.</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   936
            <li>The IDL attribute <code>longdesc</code> was changed to <a href="http://www.w3.org/TR/html5/infrastructure.html#reflect">reflect</a>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   937
              the HTML content attribute <code>longdesc</code>.</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   938
          </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   939
          <p>Editorial changes include:</p>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   940
          <ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   941
            <li>Clarifying that the document does not define "accessible",
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   942
              except that it is used in the sense that it is used in [<a href="#bib-WCAG2">WCAG</a>].</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   943
            <li>Sectioning requirements according to whom they apply.</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   944
            <li>Removed the statement that User Agents <em title="may" class="rfc2119">may</em><em
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   945
                title="optional"
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   946
                class="rfc2119"></em>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   947
              present descriptions which are erroneously included in the content
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   948
              instead of a link.</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   949
            <li>Added more examples</li>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   950
          </ul>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   951
        </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   952
      </section>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   953
    </section>
88
b5c025619532 makes references to external resouces https
Mark Sadecki <mark@w3.org>
parents: 87
diff changeset
   954
    <script src="https://www.w3.org/TR/2013/WD-html-longdesc-20130716/prism.js" data-default-language="markup"></script>
58
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   955
  </body>
7659c1f86f77 fix line endings
Mark Sadecki <mark@w3.org>
parents: 57
diff changeset
   956
</html>