Descriptores del objeto


Los descriptores (handles) se utilizan para acceder a los objetos de Liquid. Por defecto, el descriptor es el nombre del objeto, presentado en minúsculas con espacios y otros símbolos reemplazados por guiones (-).

Por ejemplo, una página con el título "О нас" puede ser obtenida en un archivo Liquid usando el descriptor "о-нас", como se muestra a continuación:

<!-- contenido de la página "О нас"  -->
{{ pages['о-нас'].content }}

 En este artículo

Cómo se crean los descriptores

A una página con el título "Camisa" se le asignará automáticamente el descriptor "camisa". Si anteriormente otra página ya tenía asignado el descriptor "camisa", para la nueva se usará un incremento automático. En otras palabras, a las nuevas páginas con el título "Camisa" se les asignará el descriptor "camisa-1" o "camisa-2", etc.

Al crear un descriptor, el espacio en el nombre de la página se reemplaza por un guion. Por ejemplo, a una página con el título "Nombre de la nueva camiseta" se le asignará automáticamente el descriptor "nombre-de-la-nueva-camiseta".

Además, el descriptor define la URL de la página. Por ejemplo, una página con el descriptor "camisa-blanca" tendrá la URL https://my-shop.myshopify.com/pages/camisa-blanca.

En los temas de Shopify, los desarrolladores suelen usar descriptores estáticos para páginas, productos o menús. Para mantener la funcionalidad del elemento y las funciones de diseño, Shopify no cambia el descriptor al modificar el nombre del objeto (página, producto, menú, etc.).

Es decir, si cambias el nombre de la página de "О нас" a "Nuestra empresa", el descriptor permanecerá igual - "о-нас". Si es necesario, puedes cambiar el descriptor manualmente.

Acceso a los atributos del descriptor

En muchos casos sabes el nombre del descriptor del objeto al que quieres acceder. Para usarlo, puedes aplicar una de las formas de acceder al objeto: usando corchetes (["descriptor"]) o usando notación de punto (.descriptor).

{{ pages['о-нас'].title }}
{{ pages.о-нас.title }}

En ambos casos, el código mostrará el título de la página:

О нас
О нас

Ten en cuenta que el descriptor se solicita del objeto pages, no de page.

En lugar de especificar directamente el descriptor, también puedes establecer un objeto desde el editor de temas. Esta opción es útil para desarrolladores que quieren dar a los usuarios de sus temas la posibilidad de elegir qué contenido mostrar en su tema.

{% for product in collections[settings.home_featured_collection].products %}
{{ product.title }}
{% endfor %}