Skip to content

Commit

Permalink
Clarify file_handlers.icons semantics (#87)
Browse files Browse the repository at this point in the history
Rewrote the note to clarify the purpose and intent of file handler icons.

This properly explains that file handler icons should represent the file type, not the application, but that it can include the application logo to imply which app will open the file.

Also makes a minor change to normative text (remove "on a platform").

Closes #86.
  • Loading branch information
mgiuca authored Jan 12, 2024
1 parent 47dbb35 commit 490f4af
Showing 1 changed file with 11 additions and 7 deletions.
18 changes: 11 additions & 7 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -715,15 +715,19 @@ <h3>
<p>
The <a>file handler</a>'s <code><dfn data-dfn-for=
"file handler">icons</dfn></code> member lists icons that serve as
graphical representations of a [=file type=] on a platform. User
agents MAY pass this information to the operating system during
file handler registration.
graphical representations of a [=file type=]. User agents MAY pass
this information to the operating system during file handler
registration.
</p>
<aside class="note">
Semantically, the [=file handler/icons=] are used to convey the
file type itself and also the app. As with [=file handler/name=],
this is typically only displayed when the app has become the
default handler for a file type.
The [=file handler/icons=] member is expected to be an image (or
collection of images at different sizes) that represents all files
that are associated with the handler. This will typically appear
like a document (e.g. a piece of paper) as opposed to an
application logo, but might include elements (such as logos) that
suggest which application the file is associated with. As with
[=file handler/name=], this is typically only displayed when the
app has become the default handler for a file type.
</aside>
</section>
<section>
Expand Down

0 comments on commit 490f4af

Please sign in to comment.