- From: Cameron McCormack <cam@mcc.id.au>
- Date: Mon, 17 Nov 2008 19:16:27 +1100
- To: public-webapps@w3.org
- Cc: public-html@w3.org
Hello WGs. I’ve just committed changes to Web IDL on how it treats index and name getters and setters. Browers don’t agree on some specifics of how the index and name properties on HTMLCollections are handled, so I’ve tried to make some sensible decisions in these cases. Comments welcome! Here’s a summary of changes to Web IDL: * Removed [IndexGetter], [IndexSetter], [NamedGetter] and [NamedSetter]. * Removed the custom [[Get]] behaviour on host objects. * Added [NumberedIndex] and [NamedIndex], which can appear on interfaces. Both of these can take identifier arguments Creatable, Modifiable and/or Deletable, which control how the properties that are placed on host objects can be interacted with. Properties for [NumberedIndex] are enumerable, and those for [NamedIndex] aren’t. * Changed the custom [[Put]] behaviour on host objects so that it only is there to support [PutForwards]. For details see: http://dev.w3.org/2006/webapi/WebIDL/#NamedIndex http://dev.w3.org/2006/webapi/WebIDL/#NumberedIndex http://dev.w3.org/2006/webapi/WebIDL/#index-properties As a consequence, I suggest the following changes in HTML 5. The section describing HTMLCollection would need something like the following (and the other collection interfaces would need something similar): [NumberedIndex, NamedIndex] interface HTMLCollection { readonly attribute unsigned long length; Element item(in unsigned long index); Element namedItem(in DOMString name); }; The numbered index has keys in the range 0 ≤ index < length, which map to the indexth node in the collection. The named index has a key for every string that when passed to namedItem() would return a node, and which maps to that returned node. Storage would need something like: [NumberedIndex, NamedIndex=(Modifiable,Removable)] interface Storage { readonly attribute unsigned long length; DOMString key(in unsigned long index); DOMString getItem(in DOMString key); void setItem(in DOMString key, in DOMString data); void removeItem(in DOMString key); void clear(); }; The numbered index has keys in the range 0 ≤ n < length, which map to the nth key in the list associated with the Storage object. The named index has a key for every key in the list associated with the object, which maps to the corresponding value in the list. When the value of a named index entry is modified, the value of the corresponding entry in the object's key/value pair list is set to the same value. When a named index entry is removed, the corresponding entry in the object's key/value pair list is removed. And for DOMStringMap: [NamedIndex=(Creatable,Modifiable,Removable)] interface DOMStringMap { }; The named index has entries that depend on the algorithms associated with the DOMStringMap object. The keys of the named index are those that would be returned from calling the algorithm for enumerating names. Each key maps to the value that would be returned from calling the algorithm for getting values from names, passing that key as the name. When the value of a named index entry is created or modified, the algorithm for setting names to certain values must be called, passing the entry's key as the name and the entry's value as the value. When the value of a named index entry is removed, the algorithm for deleting names must be called, passing the entry's key as the name. The named index entry removal must return true. This would require adding a fourth algorithm for DOMStringMaps, the “algorithm for enumerating names”. It would just look at the current @data-* attributes on the element. Thanks, Cameron -- Cameron McCormack ≝ http://mcc.id.au/
Received on Monday, 17 November 2008 08:17:10 UTC