Сворачиваемый виджетверсия добавлена: 1.0
Описание: Создаёт сворачиваемый блок содержимого
Сворачиваемое содержимое
Примечание: Сворачиваемый виджет устарел начиная с версии 1.5 и будет удален в версии 1.6. Используйте аккордеон вместо сворачиваемого виджета.Чтобы создать сворачиваемый блок содержимого, создайте контейнер и добавьте атрибут data-role="collapsible". Использование атрибута data-content-theme позволяет установить тему для содержимого сворачиваемого виджета.
Непосредственно внутри этого контейнера добавьте любой заголовок (H1-H6) или элемент legend. Фреймворк стилизует заголовок как нажимаемую кнопку и добавит иконку "+" слева, чтобы указать, что он разворачивается.
После заголовка добавьте любой HTML-разметку, которую вы хотите сделать сворачиваемой. Фреймворк обернёт эту разметку в контейнер, который будет скрываться/отображаться при нажатии на заголовок.
По умолчанию содержимое будет свернуто.
<div data-role="collapsible"> <h3>I'm a header</h3> <p>I'm the collapsible content. By default I'm closed, but you can click the header to open me.</p> </div>
Этот код создаст сворачиваемый виджет так:
Тематическое оформление
Сворачиваемый виджет использует фреймворк jQuery Mobile CSS для стилизации своего внешнего вида. Если требуется специфическое стилизация сворачиваемого виджета, следующие имена классов CSS могут быть использованы для переопределения или в качестве ключей для опции classes:
-
ui-collapsible: Внешний контейнер для сворачиваемого виджета. По умолчанию содержит дополнительные классыui-collapsible-inset,ui-collapsible-themed-contentиui-collapsible-collapsed, если не добавлены опции для их отключения.-
ui-collapsible-heading: Всегда видимая часть сворачиваемого виджета, которая нажимается для его открытия. Дополнительно содержит классui-collapsible-heading-collapsed, когда сворачиваемый виджет закрыт.-
ui-collapsible-heading-toggle: Переключатель для сворачиваемого виджета-
ui-collapsible-heading-status: Текст состояния переключателя
-
-
-
ui-collapsible-content: Содержимое сворачиваемого виджета. Дополнительно содержит классui-collapsible-content-collapsed, если содержимое свернуто.
-
Изначально развернутые сворачиваемые элементы
Когда вы добавляете атрибут data-collapsed="false" к обёртке, сворачиваемый виджет будет изначально развернут.
<div data-role="collapsible" data-collapsed="false">
Этот код создаст сворачиваемый виджет так:
Сворачиваемые элементы без вставки
По умолчанию сворачиваемые элементы имеют вид с вставкой. Чтобы сделать их полноширинными без оформления углов, добавьте атрибут data-inset="false" к элементу.
<div data-role="collapsible" data-inset="false">
Этот код создаст сворачиваемый элемент без вставки:
Мини-сворачиваемые элементы
Для более компактного варианта, полезного в панелях инструментов и ограниченном пространстве, добавьте атрибут data-mini="true" к элементу, чтобы создать мини-версию.
<div data-role="collapsible" data-mini="true">
Этот код создаст мини-сворачиваемый виджет:
Пользовательские иконки
По умолчанию иконка заголовков сворачиваемого виджета может быть переопределена с помощью атрибутов data-collapsed-icon и data-expanded-icon. В примере ниже используются data-collapsed-icon="arrow-r" и data-expanded-icon="arrow-d".
Позиционирование иконок
По умолчанию позиционирование иконок заголовков сворачиваемого виджета может быть переопределено с помощью атрибута data-iconpos. В примере ниже используется data-iconpos="right".
Тематическое оформление содержимого сворачиваемого виджета
Содержимое сворачиваемого виджета минимально стилизовано — мы добавляем только небольшой отступ между панелью и содержимым, а заголовок принимает стили темы контейнера, в котором он находится.
Чтобы обеспечить более сильную визуальную связь между заголовком и содержимым сворачиваемого виджета, добавьте атрибут data-content-theme к обёртке и укажите букву темы. Это применяет цвет границы и фона штриха к блоку содержимого и изменяет скругление углов, чтобы скрыть нижнюю часть заголовка и округлить нижнюю часть блока содержимого вместо этого, чтобы визуально сгруппировать эти элементы.
<div data-role="collapsible" data-content-theme="b"> <h3>Header</h3> <p>I'm the collapsible content with a themed content block set to "b".</p> </div>
Тематическое оформление заголовков сворачиваемого виджета
Чтобы установить тему для кнопки заголовка сворачиваемого виджета, добавьте атрибут data-theme к обёртке и укажите букву штриха. Обратите внимание, что вы можете смешивать и сопоставлять буквы штриха между заголовком и содержимым с помощью этих атрибутов темы.
<div data-role="collapsible" data-theme="b" data-content-theme="b"> <h3>Header swatch B</h3> <p>I'm the collapsible content with a themed content block set to "b".</p> </div>
Вложенные сворачиваемые элементы
Сворачиваемые элементы могут быть вложены друг в друга по мере необходимости. В этом примере мы устанавливаем тему содержимого, чтобы обеспечить более чёткую визуальную связь между уровнями.
Наборы сворачиваемых элементов (аккордеоны)
Можно объединить несколько сворачиваемых элементов в группу, которая работает как виджет аккордеон.
Предоставление предварительно рендерной разметки
Вы можете улучшить время загрузки страницы, предоставив разметку, которую виджет сворачивания обычно создаёт во время своей инициализации.
Предоставив эту разметку самостоятельно и указав это, установив атрибут data-enhanced="true", вы указываете виджету сворачивания пропустить эти манипуляции с DOM во время инициализации и предположить, что необходимая структура DOM уже присутствует.
Когда вы предоставляете такую предварительно рендерную разметку, вы также должны установить все классы, которые фреймворк обычно устанавливает, и вы также должны установить все атрибуты данных, значения которых отличаются от значений по умолчанию, чтобы указать, что предварительно рендерная разметка отражает значения параметров виджета, отличные от значений по умолчанию.
Сворачиваемый виджет создаёт ссылку из элемента заголовка и оборачивает остальные дочерние элементы внешнего виджета в div, который будет служить контейнером для содержимого сворачиваемого элемента.
В примере ниже предоставлена предварительно рендерная разметка для сворачиваемого элемента. Атрибут data-collapsed-icon="arrow-r" явно указан, так как использование класса ui-icon-arrow-r в элементе ссылки указывает, что значение параметра виджета "collapsedIcon" должно быть "arrow-r".
<div data-role="collapsible" data-enhanced="true" class="ui-collapsible ui-collapsible-inset ui-corner-all ui-collapsible-collapsed" data-collapsed-icon="arrow-r">
<h2 class="ui-collapsible-heading ui-collapsible-heading-collapsed">
<a href="#" class="ui-collapsible-heading-toggle ui-btn ui-btn-icon-left ui-icon-arrow-r">
Pre-rendered collapsible
<span class="ui-collapsible-heading-status"> click to expand contents</span>
</a>
</h2>
<div class="ui-collapsible-content ui-collapsible-content-collapsed" aria-hidden="true">
<p>This is the collapsible-content</p>
</div>
</div>