English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método prop() de jQuery

jQuery HTML/Métodos CSS

El método prop() de jQuery obtiene o establece las propiedades y valores de los elementos seleccionados.

Al usar el método prop()Obteneral establecer el valor de la propiedad, devolveráEl primer elemento seleccionadosu valor.

Usar el método prop()Estableceral establecer el valor de la propiedad, se estableceráTodos los elementos seleccionadosEstablecer una o más propiedades/pares de valores.

Para obtener o establecer atributos HTML, utiliceattr()Método.

Para eliminar un atributo, utiliceremoveProp()Método.

Sintaxis:

Obtener el valor del atributo:

$("selector").prop(property)

Establecer atributo y valor:

$("selector").prop(property, value)

Establecer múltiples atributos y valores:

$("selector").prop({property:value, property:value, ...})

Establecer atributo y valor usando una función

$("selector").prop(property, function(index, currentValue))

Ejemplo

Obtener el valor de la propiedad checked del casillero de verificación:

$("input:checkbox").change(function(){
  $("strong").text($(this).prop("checked"));
});
Prueba y mira‹/›

Establecer el valor de la propiedad seleccionada del casillero de verificación:

$("button").click(function(){
  $("input:checkbox").prop("checked", true);
});
Prueba y mira‹/›

Deshabilitar todos los casilleros de verificación en la página:

$("document").ready(function(){
  $("input:checkbox").prop("disabled", true);
});
Prueba y mira‹/›

prop() y attr()

La diferencia entre prop() y attr() puede ser importante en ciertas circunstancias.

El método prop() proporciona un método explícito para recuperar valores de atributos, mientras que attr() recupera atributos.

El siguiente ejemplo muestra la diferencia entre prop() y attr():

$("input:checkbox").change(function(){
  $(this).prop("checked");
  $(this).attr("checked");
});
Prueba y mira‹/›

Valor del parámetro

ParámetrosDescripción
propertyEspecificar el nombre del atributo
valueEspecificar el valor del atributo
function(index, currentValue)Especificar una función que devuelva el valor del atributo a establecer
  • Índice -Recibir la posición del índice del elemento en el grupo mencionado

  • currentValue-Recibir el valor actual del atributo del elemento seleccionado

jQuery HTML/Métodos CSS