W3C home > Mailing lists > Public > public-webapps@w3.org > October to December 2008

[widgets] URI attribute naming

From: Marcos Caceres <marcosscaceres@gmail.com>
Date: Wed, 3 Dec 2008 14:47:40 +0000
Message-ID: <b21a10670812030647l4f80ad7fs667188981f5c1059@mail.gmail.com>
To: public-webapps <public-webapps@w3.org>, "Kai Hendry" <kai.hendry@gmail.com>

Kai recently raised a question with regards to the naming of
attributes that take either URIs or paths as values (for example,
<content src="some/file.html"). I wanted to clarify the choices I made
here and seek feedback.

In the spec, there are essentially 3 types of "URI" attributes: paths,
hyperlinks, identifiers.

Either absolute or relative paths, for addressing resources inside a
widget package. Any attribute that is a path shall be named "src".

This applies to the following elements:
  * content
  * icon

Technically, paths are not URIs (but they are resolved to URI's at
runtime... well, they will be one we sort out the widget URI mess).

A hyperlink is a URI that points to some resource on the Web that is
either meant to be retrieved by use action (e.g. by clicking), or
retrieved automatically by the UA at its convenience. Any attribute
that is a hyperlink will named "href".

This applies to the following elements:
  * author
  * license
  * update

There are two instances where identifiers are used. For the widget
element's identifier "wid" and for the feature element's name

Kind regards,

Marcos Caceres
Received on Wednesday, 3 December 2008 14:48:28 UTC

This archive was generated by hypermail 2.3.1 : Friday, 27 October 2017 07:26:13 UTC