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

Есть два способа использовать Диктую По Буквам на своём сайте: IFrame-виджет и Javascript-виджет. Если этого окажется мало, почитайте описание нашего API.

IFrame-виджет

Это самый простой и быстрый способ добавить Диктую По Буквам на свою страницу. Он занимает всего одну строку HTML-кода, работает без Javascriptа, но имеет довольно ограниченный набор конфигурируемых параметров.

<iframe src="https://api.pobukvam.org/ru/convert?alphabet=en-nato&text=hello&format=widget&hideTitle=1" width="300" height="200"></iframe>

ru
Язык интерфейса виджета. На данный момент поддерживаются английский (en) и русский (ru). Если этот элемент не указан, по умолчанию используется русский язык.
alphabet
Алфавит для преобразования текста; один из доступных фонетических алфавитов.
text
Начальное содержимое для поля ввода текста (в URL-encoded виде). Если этот параметр не указан, поле будет пустым.
format
Этот параметр должен иметь значение "widget" обы во фрейме отображался компактный интерфейс виджета, а не полный интерфейс конвертера Диктую По Буквам.
hideTitle
Управляет видимостью логотипа и названия алфавита в виджете. Если hideTitle=1, название алфавита будет скрыто (как в примере выше), в других случаях оно будет отображаться. Это необязательный параметр.

Javascript-виджет

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

Сервис Диктую По Буквам

<input id="spelling-input" value="rm -rf /*"/>
<p>Сервис <a href="http://PoBukvam.org">Диктую По Буквам</a></p>
<dl id="spelling-result"></dl>
<script src="https://api.pobukvam.org/ru/widget.js?alphabet=int-icao"></script>
<script>
  var spellout = new Spellout({
    "inputId":"spelling-input",
    "resultId":"spelling-result",
    "resultFormat":"<dt>{original}</dt><dd>{spelling}</dd>"});
  spellout.init();
</script>

Функция Spellout (от англ. spell out - произносить по буквам) имеет следующие параметры:

inputId
ID элемента input, который содержит текст для разбора по буквам.
resultId
ID элемента, в который будут записываться результаты преобразования.
resultFormat
Формат отдельных элементов результата. Подстроки "{original}" и "{spelling}" будут заменены на символ исходного текста и соответствующее ему слово алфавита.

Если ссылка на Диктую По Буквам в виджете не вписывается в дизайн вашей страницы, вы можете перенести её в другое место сайта (например, на страницу "О сайте").