Перейти к основному содержимому

Link

Общая информация

Редактируемый элемент Link используется для динамического создания ссылок в документах.

Конфигурация

Вы можете передать все допустимые атрибуты, которые может иметь тег <a> (w3.org - Ссылка), такие как: class, target, id, style, accesskey, name, title, data-*, aria-*, а также следующие параметры:

ИмяТипОписание
reloadbooleanУстановите в true, чтобы перезагрузить страницу в режиме редактирования после изменения состояния.
textPrefixstringДобавьте иконку или что-то еще перед текстом.
textSuffixstringДобавьте иконку или что-то еще после текста.
noTextbooleanЕсли вам нужен только тег <a> без текста (или только с textSuffix/textPrefix).
requiredboolean/string(по умолчанию: false) - Установите в true, чтобы сделать ссылку и текст обязательными для публикации, установите в linkonly, чтобы сделать обязательной для публикации только ссылку.
allowedTypesarrayВы можете ограничить доступные типы для этого editable, передав разрешенные типы явно. Если этот параметр не используется, доступны все типы. Допустимые типы: asset, document, object
allowedTargetsarrayВы можете ограничить доступные цели для этого editable, передав разрешенные цели явно. Если этот параметр не используется, доступны все цели. Допустимые цели: (пустая строка), _blank, _self, _top, _parent
disabledFieldsarrayВы можете ограничить доступные поля для этого editable, передав разрешенные поля явно. Если этот параметр не используется, доступны все поля. Допустимые поля: text, target, parameters, anchor, title, accesskey, rel, tabindex, class, attributes

Методы

ИмяВозвращаетОписание
getHref()stringПолучить путь ссылки
getText()stringПолучить текст ссылки
getTarget()stringПолучить цель ссылки
getParameters()stringПолучить параметры запроса ссылки
getAnchor()stringПолучить текст якоря ссылки
getTitle()stringПолучить заголовок ссылки
getRel()stringПолучить текст rel ссылки
getTabindex()stringПолучить tabindex ссылки
getClass()stringПолучить класс ссылки
getAccessKey()stringПолучить клавишу доступа ссылки
isEmpty()stringОпределяет, пусто ли редактируемое поле

Примеры

Основное использование

<p>  
{{ "Visit our" | trans }}
{{ pimcore_link("blogLink") }}
</p>

Вы сможете увидеть предварительный просмотр в бэкенде на картинке ниже.

Link editable - adminitration panel

И на фронтенде:

Link editable - frontend

Использование ссылки в редактируемом элементе Block

Давайте посмотрим, как создать список ссылок с помощью элемента Block.

<h3>{{ "Useful links" | trans }}</h3>  
<ul>
{% for i in pimcore_block("linkblock").iterator %}
<li>{{ pimcore_link("myLink", {"class": "special-link-class"}) }}</li>
{% endfor %}
</ul>

Приведенный выше пример рендерит список ссылок: The links list in the backend

Генераторы ссылок

Пожалуйста, смотрите также раздел о Генераторах ссылок


Вы можете предложить улучшение документации или задать вопрос в комментариях.
Если вам нужна полноценная консультация — вы можете заказать её на нашем сайте.