Вы продаёте товары через интернет, или предоставляете техническую поддержку, и посетители сайта регулярно звонят вам по телефону, чтобы обсудить детали? При этом большинство разговоров начинается с мучительного выяснения имени клиента, адреса электронной почты? Установите на сайте рядом с номером контактного телефона виджет Диктую По Буквам — и звонящие с сайта смогут быстро и внятно продиктовать необходимую информацию.
Есть два способа использовать Диктую По Буквам на своём сайте: IFrame-виджет и Javascript-виджет. Если этого окажется мало, почитайте описание нашего API.
IFrame-виджет
Это самый простой и быстрый способ добавить Диктую По Буквам на свою страницу. Он занимает всего одну строку HTML-кода, работает без Javascriptа, но имеет довольно ограниченный набор конфигурируемых параметров.
<iframe src="https://api.pobukvam.org/ru/convert?
- ru
- Язык интерфейса виджета. На данный момент поддерживаются английский (
en
) и русский (ru
). Если этот элемент не указан, по умолчанию используется русский язык. - alphabet
- Алфавит для преобразования текста; один из доступных фонетических алфавитов.
- text
- Начальное содержимое для поля ввода текста (в URL-encoded виде). Если этот параметр не указан, поле будет пустым.
- format
- Этот параметр должен иметь значение "
widget
" обы во фрейме отображался компактный интерфейс виджета, а не полный интерфейс конвертера Диктую По Буквам. - hideTitle
- Управляет видимостью логотипа и названия алфавита в виджете. Если
hideTitle=1
, название алфавита будет скрыто (как в примере выше), в других случаях оно будет отображаться. Это необязательный параметр.
Javascript-виджет
Этот виджет предоставляет максимум возможностей для бесшовной интеграции, лёгкое изменение визуальных стилей, и быстрое отображение результатов по мере набора текста. С другой стороны, это требует включённого Javascript'а и больше кода, чем IFrame-виджет.
Сервис Диктую По Буквам
<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}
" будут заменены на символ исходного текста и соответствующее ему слово алфавита.
Если ссылка на Диктую По Буквам в виджете не вписывается в дизайн вашей страницы, вы можете перенести её в другое место сайта (например, на страницу "О сайте").