Документация

Подключение к веб-формам

Как подключить и использовать приложение Веб-Спеллер для проверки правописания на страницах сайтов.

Веб-Спеллер предназначен для проверки правописания в HTML-элементах <textarea> и <input type="text"> и представляет собой полнофункциональное веб-приложение с диалоговым пользовательским интерфейсом, которое можно встроить в любую веб-страницу.

Веб-Спеллер состоит из двух частей – клиентской и серверной:

  1. Клиентская часть включает три диалоговых окна (проверки правописания, настроек и редактирования пользовательского словаря) и скрипт spell.js. Клиентская часть должна быть установлена на том же сервере, где размещается сайт.

    HTML-код клиентской части доступен для загрузки по адресу:

  2. Серверная часть – это XML-сервис проверки орфографии Яндекса, см. Web Service API.
Совет. 

Пример подключения Веб-Спеллера можно посмотреть на странице http://speller.yandex.net/speller/1.0/index.html

Для того чтобы подключить Веб-Спеллер, выполните следующие шаги:

  1. Загрузите архив spell-1.0.zip и распакуйте его в каталог /speller вашего web-приложения.

    В архиве находятся все необходимые для демонстрации возможностей Веб-Спеллера файлы:

    • spell.css - файл со стилями;
    • spell.js - JavaScript-файл клиентской части Веб-Спеллера;
    • spelldlg.html - диалоговое окно проверки правописания;
    • spellopt.html - диалоговое окно настроек Веб-Спеллера;
    • userdic.html - диалоговое окно редактирования пользовательского словаря (работает в Internet Explorer 8 и Firefox 3);
    • test.html - простая HTML-страница с формой для ввода текста и двумя кнопками для вызова диалоговых окон.
  2. На страницу с проверяемым текстом добавьте клиентский скрипт:

    <script type="text/javascript" src="speller/spell.js"></script>

    и функцию spellCheck(), внутри которой передайте методу speller.check() массив элементов управления, в которых необходимо проверить орфографию:

    <script type="text/javascript">
    var speller = new Speller({ url:"speller", lang:"ru", options:Speller.IGNORE_URLS });
     
    function spellCheck() {
        var form = document.forms["myform"];
        speller.check([ form.ctrl_1, form.ctrl_2, ..., form.ctrl_N ]);
    }
    </script>
    Примечание. Параметр url:"speller" задает URL каталога, в который был распакован архив (см. пункт 1).
  3. Добавьте кнопки вызова диалоговых окон для проверки правописания и настроек Веб-Спеллера:

    <button name="cmdSpell" type="button" onclick="spellCheck()">Проверить правописание</button>

    <button type="button" onclick="speller.optionsDialog()"> Параметры...</button>

Для проверки работоспособности приложения наберите в поле ввода произвольный текст (разумеется, с ошибками) и нажмите на кнопку "Проверить правописание".

Совет. 

Веб-Спеллер поддерживает HTTPS-протокол. Для работы по HTTPS требуется:

  1. Во всех клиентских HTML-файлах заменить http: на https:

  2. В файл spelldlg.html вставить следующий скрипт:

    <script type="text/javascript">
    Speller.URL="https://speller.yandex.net/services/spellservice.js"
    </script>

Как изменить настройки по умолчанию?

Для того чтобы изменить настройки Веб-Спеллера по умолчанию, следует задать поля lang и options при создании объекта Speller.

Например, чтобы установить украинский язык проверки и игнорировать слова с прописными буквами, добавьте следующий JavaScript:

<script type="text/javascript">
   var speller = new Speller({ url: "speller",
      lang: "uk",
      options: Speller.IGNORE_UPPERCASE });
   ...
</script>
Веб-Спеллер