On Fri, May 2, 2014 at 7:12 AM, Ian Hickson <i...@hixie.ch> wrote: > On Thu, 1 May 2014, Rik Cabanier wrote: > > No particular reason. The spec text is identical; just the name of the > > method changed. Roc suggested the new name and people liked it better. I > > believe Ian stated that he would update the WHATWG version when there > > are 2 implementations. > > There's two methods in the HTML spec, drawSystemFocusRing(element) and > drawCustomFocusRing(element). It's not clear to me that the name > "drawFocusIfNeeded()" is an improvement on either. In particular, I can't > tell which it's replacing, nor what the other would be called if we > followed the same naming scheme. > > The WHATWG spec is going to follow browsers, but that doesn't mean that > the new name is necessarily better. If it was, I would have updated the > spec already instead of waiting for multiple UAs to do something else. >
There was an email thread involving several different organizations (IBM, Adobe, Mozilla, Microsoft, Google), but unfortunately it wasn't public and you weren't on it. I apologize for that, that was bad form. drawSystemFocusRing is a rather bad name since most calls to it will draw nothing. drawCustomFocusRing is an even worse name since it will draw nothing approximately always. drawFocusIfNeeded replaces drawSystemFocusRing, which is the method we expect people to need much more than drawCustomFocusRing. drawCustomFocusRing should change, but I'm not sure what to since its name needs to indicate both that it doesn't usually draw anything and its return value must be checked and properly used. I think it makes sense to use the short name for the method that is both simpler and the API most authors should be using. Rob -- Jtehsauts tshaei dS,o n" Wohfy Mdaon yhoaus eanuttehrotraiitny eovni le atrhtohu gthot sf oirng iyvoeu rs ihnesa.r"t sS?o Whhei csha iids teoa stiheer :p atroa lsyazye,d 'mYaonu,r "sGients uapr,e tfaokreg iyvoeunr, 'm aotr atnod sgaoy ,h o'mGee.t" uTph eann dt hwea lmka'n? gBoutt uIp waanndt wyeonut thoo mken.o w _______________________________________________ dev-platform mailing list dev-platform@lists.mozilla.org https://lists.mozilla.org/listinfo/dev-platform
