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

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

    Именном эта часть отвечает за то что увидит пользователь в своем интерфейсе и какие параметры он сможет передавать в виджет. Когда мы говорим о пользовательском интерфейсе, то тут речь идет о том окошке, что отображается когда мы клацаем на синий кружочек с похожий на кнопочку “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)

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

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

    User Feedback

    Recommended Comments

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

    Screenshot_1.png

    Share this comment


    Link to comment
    Share on other sites

    Create an account or sign in to comment

    You need to be a member in order to leave a comment

    Create an account

    Sign up for a new account in our community. It's easy!

    Register a new account

    Sign in

    Already have an account? Sign in here.

    Sign In Now
×