Перейти к содержимому
  • Урок третий. Пользовательские параметры (Часть первая)

    Это самая интересная часть (на мой взгляд) написания виджета и как результат множества вариаций настроек она будет сама длинная и будет разбита на две части.

    Именном эта часть отвечает за то что увидит пользователь в своем интерфейсе и какие параметры он сможет передавать в виджет. Когда мы говорим о пользовательском интерфейсе, то тут речь идет о том окошке, что отображается когда мы клацаем на синий кружочек с похожий на кнопочку “Play”.

    Огромный спектр возможностей настроек позволяет сделать Ваш виджет действительно не только полезным а и очень удобным и простым в понимании для Вашего клиента.

    Для начала разберёмся в структуре и основных параметрах общих аттребутов для всей этой группы, а в следующей части уже поговорим более подробно о каждом элементе.

    Все элементы этой группы помещаются внутрь блока <parameters>. Он начинается строкой <parameters> и заканчивается </parameters>

    Как уже писалось ранее в прошлой статье. Параметры можно условно поделить на три группы:
    Основные параметры:

    • Текст ( <text> ) - позволяет пользователю вписать необходимый текст;
    • Список ( <list> ) – позволяет выбрать одно из значений из выпадающего списка;
    • Значение ( <value>) – значения, доступные для выбора в выпадающем списке;
    • Число ( <number>) - Позволяет пользователю задавать число. При этом есть удобные стрелочки вверх и в низ;
    • Ссылка ( <url> ) – Позволяет пользователю задать локальную (в рамках сайта), или полную ссылку (с полным указанием адреса);
    • Да/Нет ( <bool> ) – Опция, позволяющая передавать в виджет значение Да, или Нет, а также включать или выключать другие функции. Отображается в виде галочки в интерфейсе пользователя.
    • Что если Да? ( <trueVal> ) – Какой параметр будет передан в виджет и какие функции будут отключены, если галочка будет нажата.
    • Что если Нет? ( <falseVal> ) - Какой параметр будет передан в виджет и какие функции будут отключены, если поле галочки будет пустым.

    Общие атрибутов:

    • Наименование параметра ( name ) – Уникальное имя параметра. Такое имя должен носить только один параметр в Вашем виджете. Поле обязательное для заполнения.
    • Значение по умолчанию ( defaultValue ) – то значение, которое отобразится пользователю при первом размещении на рабочую область Adobe Muse. Если он не будет изменено, то именно оно и будет передано на сайт при экспорте в HTML, или при передаче на FTP. Поле обязательное для заполнения.
    • Имя в интерфейсе ( label ) – это то название параметра, которое отобразится пользователю вместо «Наименование параметра ( name )». Этот параметр позволит отобразить пользователю ту информацию, которая будет ему понятна, а не непонятное название что после передается в виджет для обработки.
    • Подсказка ( tooltip ) – Подсказка, которая будет отображена пользователю при наведение на поле для заполнения.

    Вспомогательные параметры (Доступны начиная с 2014 версии):

    • Информация ( < info > ) – Текст который будет отображен пользователю в интерфейсе. Может содержать ссылку.
    • Текст ( value ) – Текст информационного сообщения;
    • Ссылка ( linkURL ) – Ссылка для перехода по клику;
    • Разделитель ( < separator > ) – Черта разделяющая блоки параметров. Позволяет разбить виджет визуально на структурированные блоки.

    Особый параметр builtIn
    Он позволяет получить значения, которые определяется Adobe Muse, речь идет об ID, которые программа присваивает каждому отдельному элементу. Существует несколько типов этого запроса. После этого этими данными можно манипулировать при помощи jQuery. В зависимости от выбора того, или иного типа запросов вы получите тот или иной результат.
    Возможные типы:

    • Ширина ( width ) - ширине элемента;
    • Высота ( height ) - высота элемента;
    • Код элемента ( itemUID ) - уникальное ID которое создано для этой страници
    • Код сайта ( siteUID ) - уникальное ID определяющее сайт Muse
    • Код страны документа ( country ) - код страны для текущего документа Muse (e.g. US, FR, JP)
    • Язык документа ( language ) - кодировка символов для текущего языка документа Muse (e.g. en, fr, es)
    • Язык и код страны ( locale ) - язык и код страны для текущей версии документа Muse (e.g. en_US, fr_FR, es_ES)

    На этом по этой части пока все. 

    Вопросы по этому уроку задавайте в комментариях.

    Отзывы пользователей

    Рекомендуемые комментарии

    Подскажите, как сделать чтобы в настройках виджета можно было открывать и скрывать настройки? Нигде не могу найти, как реализовать подобное.

    Screenshot_1.png

    Поделиться комментарием


    Ссылка на комментарий
    Поделиться на других сайтах

    Оставлять сообщения могут только участники клуба

    Вступите в клуб или войдите под своим аккаунт, чтобы писать сообщения

    Вступить в клуб

    Зарегистрируйтесь для получения аккаунта. Это просто!

    Зарегистрировать аккаунт

    Войти

    Уже зарегистрированы? Войдите здесь.

    Войти сейчас
×