--- title: Sintaxis de definición de valor slug: Web/CSS/Value_definition_syntax translation_of: Web/CSS/Value_definition_syntax original_slug: Web/CSS/Sintaxis_definición_de_valor ---
{{CSSRef()}}
La sintaxis de definición de valores CSS, una gramática formal, se utiliza para definir el conjunto de valores válidos para una propiedad o función CSS. Además de esta sintaxis, el conjunto de valores válidos puede restringirse aún más mediante restricciones semánticas (por ejemplo, para que un número sea estrictamente positivo).
La sintaxis de definición describe qué valores están permitidos y las interacciones entre ellos. Un componente puede ser una palabra clave, algunos caracteres literales, ó un valor de tipo de dato de CSS o propiedad CSS.
Una palabra clave con significado predefinido aparece literalmente, sin comillas, por ejemplo: auto, smaller or ease-in.
inherit e initialTodas las propiedades CSS aceptan las palabras clave inherit e initial que son definidas vía CSS. Estas no son mostradas en la definición del valor y están implícitamente definidas.
En CSS, unos pocos caracteres pueden aparecer por su cuenta, como la barra ('/') o la coma (','), y son usadas en una propiedad o definición para separar sus partes. La coma es a menudo usada para separar valores en enumeraciones, o parámetros en funciones de tipo matemático; la barra a menudo separa partes de el valor que es semánticamente diferente, pero que tiene una sintaxis común. Típicamente, la barra es usada a veces en propiedades abreviadas para separar componentes que son del mismo tipo, pero pertenecen a diferentes propiedades.
Ambos símbolos aparecen literalmente en una definición de valor.
Un tipo de dato usado vía CSS es definido una sola vez para todos los valores en la especificación. Se llaman tipos de datos básicos, estan representados por su nombre rodeados del símbolo '<' y '>': {{ cssxref("<angle>") }}, {{cssxref("<string>")}}, …
Tipos de dato poco comunes, llamados tipos de datos no terminales, están también rodeados por '<' y '>'.
Los tipos de dato no terminales son de dos tipos::
Corchetes encierran varias entidades, combinadores, y multiplicadores, luego los transforman en un solo componente. Son usados para agrupar componentes para sobreescribir las reglas de precedencia.
bold [ thin && <length> ]
El ejemplo empareja con los siguientes valores:
bold thin 2vhbold 0 thinbold thin 3.5emPero no con:
thin bold 3em, porque bold esta yuxtapuesto con el componente definido por los corchetes, debe aparecer antes de él.Colocar varias palabras clave, literales, o tipos de datos, uno al lado del otro, solo separados por uno o varios espacios se llama yuxtaponer. Todos los componentes yuxtapuestos son obligatorios y deben aparecer en ese orden exacto.
bold <length> , thin
El ejemplo empareja con los siguientes valores:
bold 1em, thinbold 0, thinbold 2.5cm, thinbold 3vh, thinPero no con:
thin 1em, bold porque las entidades deben aparecer en el orden expresadobold 1em thin porque las entidades son obligatorias; la coma que es un literal debe estar presentebold 0.5ms, thin porque los valores ms no son de tipo {{cssxref("<length>")}}Separar dos o mas componentes por un doble ampersand, &&, significa que todas esas entidades son obligatorias pero pueden aparecer en cualquier orden.
bold && <length>
El ejemplo empareja con los siguientes valores:
bold 1embold 02.5cm bold3vh boldPero no con:
bold porque ambos componentes deben aparecer en el valorbold 1em bold porque ambos componentes deben aparecer solo una vezbold thin && <length> es equivalente a [ bold thin ] && <length>. Que describe a bold thin <length> ó <length> bold thin pero no a bold <length> thin.Separar dos o mas componentes por una barra doble, ||, significa que todas las entidades son opcionales: al menos una debe estar presente, y pueden aparecer en cualquier orden. Típicamente ésto es usado para definir los diferentes valores de una propiedad abreviada.
<'border-width'> || <'border-style'> || <'border-color'>
El ejemplo empareja con los siguientes valores:
1em solid blueblue 1emsolid 1px yellowPero no con:
blue yellow porque un componente debe aparecer al menos una vez.bold porque no es una palabra clave permitida como valor de ninguna de las entidades.bold || thin && <length> es equivalente a bold || [ thin && <length> ]. Describe a bold, thin, <length>, bold thin, <length> bold, o thin <length> bold pero no bold <length> bold thin porque bold, si no es omitido debe colocarse antes o después de el componente thin && <length>Separar dos o mas componentes con una barra simple, |, quiere decir que todas las entidades son opciones exclusivas: exactamente una de estas opciones debe estar presente. Esto es tipicamente usado para separar una lista de posibles palabras clave.
<percentage> | <length> | left | center | right | top | bottom
El ejemplo empareja con los siguientes valores:
3%03.5emleftcenterrighttopbottomPero no
center 3% porque solo uno de los componentes debe estar presente3em 4.5em porque un componente debe estar presente máximo una vez.Note: la barra doble tiene precedencia sobre la barra simple, quiere decir que bold | thin || <length> es equivalente a bold | [ thin || <length> ]. Describe bold, thin, <length>, <length> thin, o thin <length> pero no bold <length> porque solo una entidad de cada lado del combinador | puede estar presente.
Un multiplicador es un símbolo que indica cuantas veces una entidad precedente puede ser repetida. Sin un multiplicador, una entidad debe aparecer exactamente una vez.
Note que los multiplicadores no pueden sumarse y tienen precedencia sobre los combinadores.
*)El multiplicador asterisco indica que la entidad puede aparecer cero, una o varias veces.
bold smaller*
El ejemplo empareja con los siguientes valores:
boldbold smallerbold smaller smallerbold smaller smaller smaller y así sucesivamentePero no:
smaller porque bold esta yuxtapuesto y debe aparecer antes de la palabra clave smaller+)El multiplicador suma indica que la entidad puede aparecer una o varias veces.
bold smaller+
El ejemplo empareja con los siguientes valores:
bold smallerbold smaller smallerbold smaller smaller smaller y sucesivamentePero no:
bold porque smaller debe aparecer al menos una vezsmaller porque bold esta yuxtapuesto y debe aparecer antes de cualquier palabra clave smaller?)El multiplicador pregunta indica que la entidad es opcional y debe aparecer cero o una vez
bold smaller?
El ejemplo empareja con los siguientes valores:
boldbold smallerPero no:
bold smaller smaller porque smaller debe aparecer como máximo una vezsmaller bold porque bold esta yuxtapuesto y debe aparecer antes de cualquier palabra clave smaller{ })El multiplicador llaves, encierra a dos enteros A y B separados por una coma, indica que la entidad debe aparecer al menos A veces y como mas B veces
bold smaller{1,3}
El ejemplo empareja con los siguientes valores:
bold smallerbold smaller smallerbold smaller smaller smallerPero no:
bold porque smaller debe aparecer al menos una vezbold smaller smaller smaller smaller porque smaller debe aparecer un máximo de tres veces.smaller bold porque bold esta yuxtapuesto u debe aparecer antes de cualquier palabra clave smaller#)El multiplicador hash indica que la entidad puede repetirse una o mas veces (como con el multiplicador de suma) pero cada ocurrencia se separa por una coma (',').
bold smaller#
El ejemplo empareja con los siguientes valores:
bold smallerbold smaller, smallerbold smaller, smaller, smaller y así sucesivamentePero no:
bold porque smaller debe aparecer al menos una vezbold smaller smaller smaller porque las diferentes ocurrencias de smaller deben estar separadas por comassmaller porque bold esta yuxtapuesto y debe aparecer antes de cualquier palabra clave smaller| Símbolo | Nombre | Descripción | Ejemplo |
|---|---|---|---|
| Combinadores | |||
| Yuxtaposición | Componentes obligatorios que deben aparecer en el mismo orden | solid <length> |
|
&& |
Doble ampersand | Componentes obligatorios pero que pueden aparecer en cualquier orden | length> && <string> |
|| |
Barra doble | Al menos uno de los componentes debe estar presente, y pueden aparecer en cualquier orden | <'border-image-outset'> || <'border-image-slice'> |
| |
Barra simple | Exactamente uno de los componentes debe estar presente | smaller | small | normal | big | bigger |
[ ] |
Corchetes | Agrupa componentes para sobreescribir las reglas de precedencia | bold [ thin && <length> ] |
| Multiplicadores | |||
| Sin multiplicador | Exactamente 1 vez | solid |
|
* |
Asterisco | 0 or more times | bold smaller* |
+ |
Suma | 1 o mas veces | bold smaller+ |
? |
Pregunta | 0 o 1 vez (es opcional) | bold smaller? |
{A,B} |
Llaves | Al menos A veces, como mas B veces |
bold smaller{1,3} |
# |
Hash | 1 o mas veces, pero cada ocurrencia separada por una coma (',') |
bold smaller# |
| Especificación | Estado | Comentario |
|---|---|---|
| {{ SpecName('CSS3 Values', '#value-defs', 'Value definition syntax') }} | {{ Spec2('CSS3 Values') }} | Desde {{ SpecName('CSS2.1', 'about.html#value-defs', 'Value definition syntax') }}, añade el multiplicador hash |
| {{ SpecName('CSS2.1', 'about.html#value-defs', 'Value definition syntax') }} | {{ Spec2('CSS2.1') }} | Desde {{ SpecName('CSS1', '#notation-for-property-values', 'Value definition syntax') }}, añade el combinador doble ampersand |
| {{SpecName('CSS1', '#notation-for-property-values', 'Value definition syntax') }} | {{ Spec2('CSS1') }} | Definición inicial |