Версия источника: d69b9006cd250b109de4a44a5f811da1244f4387
Синхронизировано: 2026-11-19T02:42:04.913Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/d69b9006cd250b109de4a44a5f811da1244f4387

<a id="interface-telephone-links"></a>

# Кликабельные телефонные номера

## Коротко

Каждый опубликованный контактный телефон, предназначенный для звонка, оформляется текстовой ссылкой `tel:`. Это относится к шапке, подвалу, контактам, карточкам и содержимому страниц. Номер остается читаемым и доступным для копирования на компьютере и телефоне.

## Плохо

```html
<span>{{ phone.display }}</span>
```

## Хорошо

```html
<a href="{{ phone.telUri }}">
  {{ phone.display }}
</a>
```

## Почему

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

## Когда применять

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

Это требование интерфейса справочника. RFC 3966 определяет формат телефонного URI, а не обязанность делать любой текст с цифрами ссылкой. Примеры выше — шаблон: реальные номера в справочник не добавляются, `phone.telUri` формируется из проверенных данных контакта.

### Требования

- Используйте `<a href="tel:…">` с обычным текстом номера, доступным с клавиатуры. Не заменяйте его картинкой, `javascript:` или обработчиком клика на `<span>`. Работа ссылки не зависит от аналитики и загрузки JavaScript.
- Храните проверенное значение номера отдельно от удобного отображения. `phone.display` и `phone.telUri` относятся к одному контакту; текст с пробелами и скобками не копируется вслепую в адрес. Формируйте URI с разрешенной схемой `tel:` и корректно экранируйте данные шаблона.
- Для публичного контакта используйте глобальную форму с `+` и кодом страны, если она доступна. Локальная форма требует `phone-context` согласно RFC. Не определяйте страну по языку страницы и не заменяйте начальную цифру номера без известного плана нумерации. Проверка формата не доказывает существование и принадлежность номера.
- Добавочный номер храните отдельно. RFC предусматривает `;ext=`, но поддержку конкретным обработчиком проверяйте. Показывайте добавочный также текстом; не приписывайте его к основному номеру как дополнительные цифры и не вставляйте управляющие команды набора без отдельного проверенного контракта.
- Подписывайте назначение: поддержка, продажи, филиал или запись. У кнопки-иконки есть доступное имя. Если используется `aria-label`, он сохраняет видимый номер или понятную видимую подпись; не прячьте от скринридера, куда ведет действие.
- Несколько телефонов — отдельные ссылки с понятными подписями. Мессенджер, заказ обратного звонка и телефонный звонок — разные действия; нажатие на номер не должно неожиданно открывать форму или чат вместо `tel:`.
- На компьютере ссылка сохраняется даже при отсутствии обработчика. Оставьте возможность выделить номер; при необходимости добавьте отдельное действие «Скопировать». Не подменяйте телефонную ссылку копированием в зависимости от размера экрана и не обещайте автоматический звонок.
- Для отдельных кнопок обеспечьте удобную область нажатия и расстояния до соседних действий. К телефонной ссылке внутри абзаца применимо исключение WCAG 2.5.8 для встроенного текста; не требуется превращать каждое упоминание в большой блок.
- При динамической подмене контакта обновляйте одновременно видимый номер, `href` и доступную подпись из одной записи. Повторный рендер не возвращает устаревшую цель. Ошибка внешней аналитики не блокирует открытие обработчика; если отслеживаете клик, не называйте его состоявшимся звонком.

## Пример применения

В вымышленной карточке филиала и в мобильной панели отображается контакт из одной записи. Оба места содержат `tel:` на один и тот же номер; рядом можно скопировать текст. Добавочный подписан отдельно. В репозитории используются только имена полей, без действующих или демонстрационных телефонных номеров.

## Как проверить

- Обойдите шапку, подвал, контакты, карточки, раскрытые блоки и текстовые материалы. Каждый действующий контакт для звонка имеет корректный `tel:`, а обычные числовые идентификаторы не стали телефонами.
- Сопоставьте видимый номер, URI и исходную запись, включая код страны, добавочный и динамическую подмену. Смена контакта не оставляет старый `href`.
- Проверьте Tab/Enter, доступное имя, выделение и копирование. На телефоне и компьютере проверьте передачу номера выбранному обработчику; завершение реального звонка не требуется.
- Проверьте отсутствие обработчика и отказ аналитики: номер остается читаемым и копируемым, страница не теряет управление. Реальный тестовый звонок выполняется только по согласованному контакту.
- Проверьте неизвестный, пустой и замаскированный номер: фиктивная ссылка или автоматически угаданный номер не публикуются.

## Человек

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

## Агент

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

## Источники

- [RFC 3966: tel URI, глобальные и локальные номера, добавочные](https://www.rfc-editor.org/rfc/rfc3966.html)
- [MDN: телефонные ссылки и поведение обработчика](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a#linking_to_telephone_numbers)
- [W3C: Target Size (Minimum) — отдельные цели и встроенные ссылки](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html)

Уровень: Обязательно. Опубликовано: 2026-11-19. Проверено: 2026-11-19. Изменено: 2026-11-19.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/d69b9006cd250b109de4a44a5f811da1244f4387/registry/standards/ui/admin-interface/rules/telephone-links.md)
