Jquery ru docs: Русская документация по API jQuery

15+ полезных документов по jQuery / Хабр

ZaiSL 2 апреля 2010 в 10:57

jQuery *

Как известно, пару месяцев назад свет увидела jQuery 1.4, в которой мы можем наблюдать множество новых функций и возможностей. А значит, стало еще больше информации для изучения и запоминания. И не важно, насколько хорошо вы владеете искусством jQuery — запомнить всё в любом случае не удастся. И вот здесь нам на помощь приходят всевозможные сборники документаций и шпаргалки, которые очень полезно держать под рукой и периодически в них заглядывать).

Итак, ниже представлены ссылочки на самые разнообразные документы по jQuery. Среди них вы найдете документацию по API, jQuery UI, мануалы по jQuery CSS и селекторам, шпаргалку по jQuery-валидатору и еще много других полезностей.
Поехали.

Официальная документация:

• Version 1.4 – jQuery API Changes Documentation »
• jQuery API – Official Documentation »
• jQuery Core API Official Browser »
• Visual jQuery 1.3 Browser »

Альтернативные сборники документации:

jQAPI – Alternative jQuery Documentation (HTML, AIR и ZIP)

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

• Перейти к HTML версии »
• Скачать HTML-версию в ZIP-архиве »
• Скачать  Adobe AIR версию »

jQuery API – Alternative Browser (HTML)

Как и в предыдущем док-браузере, контент полностью дублирует официальную документацию. Особенностью же данного ресурса является его JS-навигация по содержимому, что значительно ускоряет поиск нужной информации.

• Перейти к HTML версии »

Шпаргалки по jQuery

jQuery 1.4 Cheat Sheet – Impulse Studios Labs (PDF)

• Скачать  PDF »

jQuery 1.4 API Cheat Sheet – Future Colors (PDF, HTML, PNG)

• Скачать PDF »
• Скачать  PNG »

jQuery CSS Cheat Sheet (PDF)

• Скачать  PDF »

jQuery Selectors – Refcardz (PDF)

• Скачать  PDF »

jQuery Selectors Cheatsheet (HTML)

• Перейти к HTML версии »

jTouch Cheatsheet – Color Charge (HTML)

• Перейти к HTML версии »

jQuery Validator Cheatsheet – Elegant Code (PDF)

• Скачать  PDF »

jQuery UI 1.7 Cheatsheet (HTML)

• Перейти к HTML версии »

jQuery UI – Effects Cheatsheet (HTML)

• Перейти к HTML версии »

jQuery – YUI3 Rosetta Stone (HTML)

• Перейти к HTML версии »

jQuery 1.

3

jQuery 1.3 Visual Cheat Sheet – Woorkup (PDF, JPEG)

• Скачать  PDF »
• Скачать JPEG »

jQuery 1.3 Cheatsheet – A Coding Fool (PDF)

• Скачать  PDF »

jQuery 1.3 Cheatsheet Wallpaper (1920×1200, 1680×1050, 1440×900)

• 1440×900px»
• 1680×1050px »
• 1920×1200px»

jQuery 1.3 Cheatsheet (HTML)

• Перейти к HTML версии »

jQuery 1.3.2 Cheat Sheet (PDF, PNG, Microsoft XLS)

• Скачать PDF »
• Скачать PNG »
• Скачать в Microsoft XLS »

Источник: тут.

UPD: Ресурсы, предложенные в комментариях:

• VisualjQuery
• Русская документация по jQuery

Теги:

• jquery
• документация
• шпаргалки

Хабы:

• jQuery

Всего голосов 70: ↑59 и ↓11 +48

Просмотры

6. 6K

Комментарии 15

Ирина Сергеевна @ZaiSL

Пользователь

Комментарии Комментарии 15

Документация и интеграция с ФИАС в облаке. Кладр, ФИАС в облаке.

Мы храним базу ФИАС в собственном формате, оптимизированным для быстрого поиска. Для бесперебойной работы используем несколько серверов в облаке Mail.ru.

kladr-api.ru/api.php

После регистрации в личном кабинете вы увидете свой уникальный токен.

Платные сервера

https://kladr-api.com/api.php

Всегда необходимо указывать свой токен в параметре token.

Бесплатные сервера

https://kladr-api.ru/api.php

Токен указывать необязательно.

Документация о настройке плагина находится на его github странице.

По умолчанию плагин настроен на работу с бесплатным сервером. Для работы с платным сервером добавьте свой токен и укажите URL платного сервера следующим образом:

<script type=»text/javascript»>
    $.

fias.token = ‘ваш токен’;
    $.fias.url = ‘https://kladr-api.com/api.php’;
</script>

Скачать плагин

Подключение к серверу (API)

Доступ к API является публичным, без каких-либо ограничений. Бесплатные сервера предоставляются как есть, мы не гарантируем их работоспособность и скорость ответа. Бесплатный API отлично подходит, например, для тестирования сервиса, личного использования, домашних страниц. Доступ к платным серверам возможен только при указании вашего токена, который мы активируем после оплаты.

Параметры запроса

• Адрес страницы для запроса к платным серверам:   

  https://kladr-api.com/api.php

• Адрес страницы для запроса бесплатной версии:

  https://kladr-api.ru/api.php

Плагины

Для облегчнения интеграции сторонними разработчиками созданы плагины под разные плаформы. Обратите внимание, они могут быть платными.

• CMS Amiro
• Drupal
• Yii PHP Framework
• 1С-Битрикс
• Node.
  js
• Java
• 1C:Предприятие (8.2)

Предложить плагин

Тех. поддержка

token

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

regionId

Код региона (области)

districtId

Код района

cityId

Код города (населённого пункта)

streetId

Код улицы

buildingId

Код дома (строения)

query

Строка для поиска по названию

contentType

Тип возвращаемых объектов (region, district, city, street, building)

withParent

Если 1, сервис вернёт объекты вместе с родительскими (для района это регион, для населённого пункта район и регион и т.п.)

limit

Количество возвращаемых объектов

offset

Смещение в выдаче (для организации постраничного вывода)

typeCode

Тип объектов для выдачи:
1 — города
2 — поселки
4 — деревни
Битовые комбинации, например, 3 ( 1 | 2 ) — города и поселки

zip

Почтовый индекс.
Работает только при contentType = building. В этом случае можно не передать parentId. Поиск по почтовому индексу — это поиск по строениям (building), поэтому логично указать withParent = 1 и limit = 1, чтоб выбрать данные о регионе, нас. пункте и т. п.

oneString

Поиск адреса одной строкой в свободной форме. С этим параметром используются:

• query

  Строка поиска

• withParent=1

  Выводить сведения о родителях

• limit

  Кол-во результатов в выдаче

• regionId, districtId, cityId

  Фильтры для ограничения поиск

callback

JavaScript метод которому будет передан ответ базы

Формат ответа сервиса

{
    "searchContext": {                      // Объект с переданными серверу параметрами
    "query": "Арх",
        "contentType": "city",
        "withParent": 1,
        "limit": 2
},
    "result": [                             // Массив полученных объектов заданного типа (населённые пункты)
    {
        "id": "2900000100000",          // КЛАДР Код объекта
        "name": "Архангельск",          // Название объекта
        "zip": null,                    // Почтовый индекс объекта
        "type": "Город",                // Тип объекта полностью
        "typeShort": "г",               // Тип объекта коротко
        "okato": "11401000000",         // Код ОКАТО
        "oktmo": "11701000",            // Код ОКТМО
        "guid": "06814fb6-0dc3-4bec-ba20-11f894a0faf5",             // ФИАС Код объекта,
        "parentGuid": "294277aa-e25d-428c-95ad-46719c4ddb44",       // ФИАС Код родителя
        "cadnum": "",                   // Кадастровый номер,
        "ifnsfl": "2901",               // Код налоговой
        "ifnsul": "2901",               // Код налоговой
        "parents": [                    // Массив родительских объектов (если был передан параметр withParent)
            {
                "id": "2900000000000",
                "name": "Архангельская",
                "zip": null,
                "type": "Область",
                "typeShort": "обл",
                "okato": "11000000000",
                "conentType": "region",
                "okato": "11401000000",
                "oktmo": "11701000",
                "guid": "06814fb6-0dc3-4bec-ba20-11f894a0faf5",
                "parentGuid": "294277aa-e25d-428c-95ad-46719c4ddb44"
            }
        ]
    },
    {
        "id": "2800200000100",
        "name": "Архара",
        "zip": "676740",
        "type": "Поселок городского типа",
        "typeShort": "пгт",
        "okato": "10205551000",
        "parents": [
            {
                "id": "2800000000000",
                "name": "Амурская",
                "zip": "675000",
                "type": "Область",
                "typeShort": "обл",
                "okato": "10000000000",
                "contentType": "region"
            },
            {
                "id": "2800200000000",
                "name": "Архаринский",
                "zip": null,
                "type": "Район",
                "typeShort": "р-н",
                "okato": "10205000000",
                "contentType": "district"
            }
        ]
    }
]
}

Особенности поиска объектов

Поиск объектов осуществляется либо по названию либо по коду связанного (родительского либо дочернего элемента).

название/ (т. е. выбираются объекты, название которых полностью совпадает с поисковой строкой либо начинается на неё).

Для поиска улицы по названию необходимо обязательно указать код населённого пункта.

Для поиска строения по названию необходимо обязательно указать код улицы.

Выбрать тариф Поддержка — [email protected]

Поддержка браузера | jQuery

---

Текущая активная поддержка

Рабочий стол

• Chrome: (текущий — 1) и текущий
• Край: (Текущий — 1) и Текущий
• Firefox: (Текущий — 1) и Текущий, ESR
• Internet Explorer: 9+
• Safari: (Текущий — 1) и Текущий
• Опера: текущий

Мобильный

• Стоковый браузер на Android 4.0+ ^[1]
• Safari на iOS 7+ ^[1]

[1] Обходные пути для браузера Android 4.0-4.3 и iOS 7 присутствуют в базе кода, но мы больше не тестируем эти версии. iOS 8 и более новые версии тестируются.

О любой проблеме с jQuery в вышеперечисленных браузерах следует сообщать как об ошибке в jQuery.

(Current — 1) и Current означают, что мы поддерживаем текущую стабильную версию браузера и предыдущую версию. Например, если текущая версия браузера 24.x, мы поддерживаем версии 24.x и 23.x.

Firefox ESR (выпуск с расширенной поддержкой) — это версия Firefox для использования организациями, включая школы, университеты, предприятия и другие организации, которым требуется расширенная поддержка для массового развертывания. Он основан на обычном выпуске Firefox и синхронизируется со следующим обычным Firefox каждые несколько выпусков — примеры версий ESR включают Firefox 47, 52 и 60. В любой момент времени доступно не более двух версий ESR; jQuery поддерживает оба из них. Дополнительную информацию см. на сайте Mozilla.

Если вам нужна поддержка старых браузеров, таких как Internet Explorer 6-8, Opera 12.1x или Safari 5.1+, используйте jQuery 1.12.

---

Неподдерживаемые браузеры

Хотя jQuery может работать без серьезных проблем в старых версиях браузеров, мы не тестируем в них jQuery активно и, как правило, не исправляем ошибки, которые могут в них появиться.

Точно так же jQuery не исправляет ошибки в предварительных версиях браузеров, таких как бета-версии или выпуски для разработчиков. Если вы обнаружите ошибку с jQuery в предварительной версии браузера, вы должны сообщить об ошибке поставщику браузера.

---

О поддержке браузеров

jQuery постоянно тестируется со всеми поддерживаемыми браузерами с помощью модульных тестов. Однако веб-страница, использующая jQuery, может не работать в том же наборе браузеров, если ее собственный код использует (или становится жертвой) поведение, специфичное для браузера. Тестирование необходимо для полной поддержки браузера. На сайте Microsoft Edge Developer доступны виртуальные машины для тестирования многих версий Internet Explorer.

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

---

О совместимости селекторов CSS

Независимо от того, поддерживает ли браузер селекторы CSS, все селекторы, перечисленные на странице api.jquery.com/category/selectors/, будут возвращать правильный набор элементов при передаче в качестве аргумента функции jQuery . .

Стили CSS, применяемые с помощью метода jQuery .css() , зависят от уровня поддержки браузера. В общем, jQuery не пытается преодолеть ограничения рендеринга в стиле браузера. (Единственное исключение — opacity , который jQuery «подгоняет» под более старую альтернативную реализацию Internet Explorer.) Кроме того, до версии 1.8 jQuery не нормализует свойства с префиксом поставщика.

jQuery Mobile Docs — Анатомия страницы

Структура «страницы» jQuery Mobile оптимизирована для поддержки либо отдельных страниц, либо локальных внутренних связанных «страниц» внутри страницы.

Цель этой модели — позволить разработчикам создавать веб-сайты с использованием лучших практик — где обычные ссылки будут «просто работать» без какой-либо специальной настройки — при этом создавая богатый, нативный опыт, которого нельзя достичь с помощью стандартных HTTP-запросов. .

Структура мобильной страницы

Мобильный сайт jQuery должен начинаться с «типа документа» HTML5, чтобы в полной мере использовать все возможности платформы. (Старые устройства с браузерами, которые не понимают HTML5, будут безопасно игнорировать «тип документа» и различные пользовательские атрибуты.)

В «заголовке» для начала необходимы ссылки на jQuery, jQuery Mobile и CSS мобильной темы. . jQuery Mobile 1.1 работает с версиями ядра jQuery 1.6.4 и 1.7.1. Для лучшей производительности мы рекомендуем использовать ссылки на файлы, размещенные в CDN jQuery:

   

<голова>


 jquery.com/mobile/1.1.1/jquery.mobile-1.1.1.min.css" />   
<тело>
...контент идет сюда...


 

Метатег области просмотра

Обратите внимание, что в заголовке заголовка есть метатег области просмотра , чтобы указать, как браузер должен отображать уровень масштабирования и размеры страницы. Если это не установлено, многие мобильные браузеры будут использовать «виртуальную» ширину страницы около 900 пикселей, чтобы она хорошо работала с существующими настольными сайтами, но экраны могут выглядеть уменьшенными и слишком широкими. Установив для атрибутов области просмотра значение content="width=device-width, initial-scale=1" , ширина будет равна ширине экрана устройства в пикселях.

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

Внутри тела: Страницы

Внутри тега каждое представление или «страница» на мобильном устройстве идентифицируется элементом (обычно div ) с data-role="page" атрибут. Просмотрите справочник атрибутов данных, чтобы увидеть все возможные атрибуты, которые вы можете добавить на страницы.

 

...

 

Внутри контейнера «страница» может использоваться любая допустимая HTML-разметка, но для типичных страниц в jQuery Mobile непосредственными дочерними элементами «страницы» являются элементы div с ролями данных "заголовок" , "контент" и "нижний колонтитул" .

 

...
...
...

 

Собираем вместе: базовый одностраничный шаблон

Собираем все вместе, это стандартный стандартный шаблон страницы, с которого вы должны начать работу над проектом:

<голова>


   
<тело>


 
Название страницы
 


Содержимое страницы находится здесь.


 
Нижний колонтитул страницы
 




 

Просмотр стандартного шаблона

Структура многостраничного шаблона

Один HTML-документ может содержать несколько «страниц», которые загружаются вместе путем наложения нескольких элементов div с ролью данных из «страницы» . Каждому блоку «страницы» нужен уникальный идентификатор ( id="foo" ), который будет использоваться для внутренних ссылок между «страницами» ( href="#foo" ). При нажатии на ссылку фреймворк ищет внутреннюю «страницу» с идентификатором и переводит ее в представление.

Вот пример 2-страничного сайта, созданного с двумя jQuery Mobile div, навигация по которым осуществляется путем ссылки на идентификатор, размещенный на каждой обертке страницы. Обратите внимание, что идентификаторы в обертках страниц необходимы только для поддержки внутренних ссылок на страницы и необязательны, если каждая страница представляет собой отдельный HTML-документ. Вот что две страницы выглядят внутри элемента body .

<тело>



 
Фу
 


Я первый в исходном порядке, поэтому я показан как страница.
Просмотреть внутреннюю страницу под названием bar


 
Нижний колонтитул страницы
 





 
Панель
 


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


 
Нижний колонтитул страницы
 



 

Просмотр многостраничного шаблона

ОБРАТИТЕ ВНИМАНИЕ: поскольку мы используем хэш для отслеживания истории переходов для всех «страниц» Ajax, в настоящее время невозможно сделать глубокую ссылку на якорь ( index.html#foo ) на страницу в jQuery Mobile, потому что фреймворк будет искать «страницу» с идентификатором из #foo вместо собственного поведения прокрутки к содержимому с этим ID .

Атрибут id всех ваших элементов должен быть уникальным не только на данной странице, но и на всех страницах сайта. Это связано с тем, что модель одностраничной навигации jQuery Mobile позволяет одновременно присутствовать в DOM множеству разных «страниц». Это также применимо при использовании многостраничного шаблона, поскольку все «страницы» в шаблоне загружаются одновременно.

Условные обозначения, а не требования

Хотя структура страницы, описанная выше, является рекомендуемым подходом для стандартного веб-приложения, созданного с помощью jQuery Mobile, структура документа очень гибкая. Элементы роли данных страницы, заголовка, содержимого и нижнего колонтитула являются необязательными и в основном полезны для обеспечения некоторого базового форматирования и структуры. Оболочка страницы, которая раньше требовалась для работы автоинициализации, теперь является необязательной для одностраничных документов, поэтому разметка вообще не требуется. Для веб-страницы с пользовательским макетом все эти структурные элементы можно опустить, а навигация Ajax и все виджеты будут работать так же, как и в шаблонной структуре. За кулисами фреймворк внедрит обёртку страницы, если она не включена в разметку, поскольку она необходима для управления страницами, но начальная разметка теперь может быть чрезвычайно простой.