W3C home > Mailing lists > Public > public-webplatform@w3.org > July 2013

Re: Values of CSS properties

From: Julee Burdekin <jburdeki@adobe.com>
Date: Thu, 25 Jul 2013 13:50:12 -0700
To: Mike Sierra <letmespellitoutforyou@gmail.com>, Lea Verou <lea@w3.org>
CC: PhistucK <phistuck@gmail.com>, WebPlatform Community <public-webplatform@w3.org>
Message-ID: <CE16DD77.898A1%jburdeki@adobe.com>
+1 But I don't think we have such a page... J


----------------------------
julee@adobe.com
@adobejulee

From: Mike Sierra <letmespellitoutforyou@gmail.com<mailto:letmespellitoutforyou@gmail.com>>
Date: Thursday, July 25, 2013 1:47 PM
To: Lea Verou <lea@w3.org<mailto:lea@w3.org>>
Cc: PhistucK <phistuck@gmail.com<mailto:phistuck@gmail.com>>, julee <jburdeki@adobe.com<mailto:jburdeki@adobe.com>>, WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
Subject: Re: Values of CSS properties

I prefer <length> with a link to the length page and maybe a brief note about percentages and keywords, but separate lines for 2, 4, and 1-line syntax.   Perhaps "accepts multiple values" should be a flag in the overview table, with a link to discussion of comma-separated syntax?

--Mike S


On Thu, Jul 25, 2013 at 4:40 PM, Lea Verou <lea@w3.org<mailto:lea@w3.org>> wrote:
Isn¡¯t that the purpose of the examples section?

Lea Verou
W3C developer relations
http://w3.org/people/all#lea ? http://lea.verou.me ? @leaverou






On Jul 25, 2013, at 23:39, PhistucK <phistuck@gmail.com<mailto:phistuck@gmail.com>> wrote:

While I understand what <length> means exactly, I am not sure everyone does. In order to be correct and accurate, as well as usable for newcomers, I think we should have <length> as well as one or two quick and short examples to make the newcomers figure out the usage easily and quickly.

So, say -
background-position: <length> <length>;
  background-position: 20px 30px;
  background-position: 15em 5%;

Or something similar.


¡ÙPhistucK


On Thu, Jul 25, 2013 at 11:32 PM, Lea Verou <lea@w3.org<mailto:lea@w3.org>> wrote:
Yes, that¡¯s what I¡¯m talking about. Glad we agree. Anyone else want to chime in?

Lea Verou
W3C developer relations
http://w3.org/people/all#lea ? http://lea.verou.me<http://lea.verou.me/> ? @leaverou






On Jul 25, 2013<tel:2013>, at 23:31, Julee Burdekin <jburdeki@adobe.com<mailto:jburdeki@adobe.com>> wrote:

> Hi, Lea: Are you talking about where it lists the values:
>
> Values
>
> 20px 40px
>     Any standard CSS...
>
> Yes, I agree: <length> is better than some arbitrary example value.
>
> J
>
> ----------------------------
> julee@adobe.com<mailto:julee@adobe.com>
> @adobejulee
>
>
>
>
>
> From:  Lea Verou <lea@w3.org<mailto:lea@w3.org>>
> Date:  Thursday, July 25, 2013<tel:2013> 1:25 PM
> To:  WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
> Subject:  Values of CSS properties
>
>
> I see this pattern in many CSS properties. For example,
> http://docs.webplatform.org/wiki/css/properties/background-positionSome

> have generic data types as values (e.g. length), others try to use
> specific examples.
> What¡¯s the correct way?
> Personally, I think specific examples can be confusing, since the reader
> needs to extrapolate the general rule.
>
> Lea Verou
> W3C developer relations
> http://w3.org/people/all#lea ? http://lea.verou.me<http://lea.verou.me/> ? @leaverou
>
>
>
>
>
>
>
>
>





Received on Thursday, 25 July 2013 20:50:43 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:20:52 UTC