OSCHINA-MIRROR/mirrors-jquerymobile

jQuery Mobile

Примечание: jQuery Mobile больше не поддерживается. Пожалуйста, ознакомьтесь с сообщением в блоге о статусе проекта для получения дополнительной информации.

jQuery Mobile — это унифицированная система пользовательского интерфейса на основе HTML5 для всех популярных платформ мобильных устройств, построенная на надёжном фундаменте jQuery и jQuery UI. Его лёгкий код создан с учётом прогрессивного улучшения и имеет гибкий, легко настраиваемый дизайн.

jQuery Mobile 1.4.x работает с версиями ядра jQuery от 1.8.3 до 1.11.1 / 2.1.1. Вы можете найти более подробную информацию о том, как работает библиотека и на что она способна, прочитав документацию и изучив демоверсии. Кроме того, дополнительную информацию можно найти на сайте jquerymobile.com.

Вклад

Вы можете внести свой вклад в проект, сообщая о проблемах, предлагая новые функции или отправляя запросы на вытягивание. Пожалуйста, ознакомьтесь с нашими рекомендациями по внесению вклада перед отправкой.

Сборка/настройка

В настоящее время библиотека поставляется через CDN jQuery/загружается как единый монолитный файл JavaScript, который зависит от ядра jQuery (не входит в комплект) и аналогично связанного файла CSS. Для пользователей мы поддерживаем следующие цели сборки:

js — разрешение зависимостей, сборка, объединение и минимизация JavaScript, используемого для jQuery Mobile;
css — разрешение зависимостей, сборка, объединение и минимизация всего css, только структуры css и только темы css;
demos — сборка js и css, подготовка документации к статическому использованию;
lint — проверка файлов JavaScript с помощью JSHint.

Скачать Builder

Самый простой способ получить индивидуальную сборку — использовать конструктор загрузок. С его помощью вы можете выбрать нужные части библиотеки, и зависимости CSS и JavaScript будут разрешены для вас в виде упакованного/минифицированного целого.

Требования

node.js;
grunt-cli.

Команды

После установки узла и grunt вы можете запустить цель по умолчанию, просто выполнив следующие действия из корня проекта:

npm install
grunt

JavaScript

Начиная с версии 1.1 библиотека использует управление зависимостями в сборке JavaScript, предоставляя модули AMD, которые можно добавлять или удалять из основного мобильного метамодуля js/jquery.mobile.js.

Например, если пользователь хочет исключить виджеты форм, чтобы уменьшить вес своего включения jQuery Mobile, они сначала удалят их из метамодуля:

diff --git a/js/jquery.mobile.js b/js/jquery.mobile.js
index 6200fe6..3a4625c 100644
--- a/js/jquery.mobile.js
+++ b/js/jquery.mobile.js
@@ -19,12 +19,6 @@ define([
        './jquery.mobile.listview.filter',
        './jquery.mobile.listview.autodividers',
        './jquery.mobile.nojs',
-       './jquery.mobile.forms.checkboxradio',
-       './jquery.mobile.forms.button',
-       './jquery.mobile.forms.slider',
-       './jquery.mobile.forms.textinput',
-       './jquery.mobile.forms.select.custom',
-       './jquery.mobile.forms.select',
        './jquery.mobile.buttonMarkup',
        './jquery.mobile.controlGroup',
        './jquery.mobile.links',

А затем запустите сборку:

grunt build:js

CSS

Чтобы создать новую тему:

Скопируйте папку default из CSS/Themes в новую папку с именем вашей новой темы (например, my-theme).
Добавьте настройки в файл jquery.mobile.theme.css.
Из корня проекта выполните следующую команду grunt:
```
 THEME=my-theme grunt build:css
```
Результат будет доступен в папке dist/css/my-theme. $PROJECT_ROOT/dist

Предполагается, что файлы CSS темы находятся в каталоге css/themes/$THEME/ относительно корня проекта, например, css/themes/my-theme/.

Разработка

Корнем репозитория также является корень документации и, наряду с набором тестов, он служит тестовым стендом для исправлений ошибок и функций. Вам нужно настроить сервер и запустить набор тестов перед тем, как вносить исправления.

Сервер

Большая часть документации и страниц тестирования зависит от PHP 5+, поэтому для разработки требуются Apache и PHP. Вы можете установить их одним из следующих способов:

одним кликом — MAMP для OSX, XAMP для OSX/Windows;
существующий веб-сервер — например, каталог ~/Sites на OSX;
виртуальная машина — если установлен Vagrant, вы можете добавить эту удалённую ветку и выполнить команду vagrant up.

Помимо ванильного Apache требуются следующие модули:

Rewrite (mod_rewrite.so);
Expire (mod_expires.so);
Header (mod_headers.so).

После настройки веб-сервера вы можете указать его на каталог проекта.

Тестирование

Автоматизированное тестирование составляет основу деятельности по обеспечению качества проекта jQuery Mobile. От вас, как участника или отправителя патча, ожидается запуск набора тестов для кода, на который влияют ваши патчи. Наш сервер непрерывной интеграции будет обрабатывать оставшуюся часть набора тестов.

Вы можете запустить все наборы тестов, выполнив следующую команду:

grunt test

Вы также можете выбрать запуск только подмножества тестов, добавив опцию --suites, например:

grunt test --suites=table,slider

запустит тесты в каталогах tests/unit/table/ и tests/unit/slider/.

Вы также можете исключить некоторые тесты, используя !. Например:

grunt test --type=integration --suites=!navigation

запустит все интеграционные тесты, кроме навигационного набора.

Также можно указать, какие версии jQuery вы хотите протестировать с помощью опции --jqueries:

grunt test --jqueries=1.11.1,git

Кроме того, набор тестов jQuery Mobile разделён между интеграционными и модульными тестами. Модульные тесты фокусируются на одном фрагменте библиотеки (например, виджете), а интеграционные требуют функционирования нескольких частей библиотеки. Вы можете настроить таргетинг на любой тип, включив опцию --types при тестировании:

grunt test --types=unit
grunt test --types=integration
grunt test --types=unit,integration # по умолчанию, эквивалентно 'grunt test'