Название сторонних компонентов

AMP делит компоненты на "собственные" и "сторонние" компоненты:

• Собственные компоненты — это те, которые работают независимо от конкретного внешнего сервиса. Эти компоненты являются универсальными. Вот примеры собственных компонентов:

  • <amp-sidebar>
  • <amp-list>
  • <amp-iframe>^[1]
  • и т.д.

• Сторонние компоненты — это те, которые встраивают функциональность, предоставленную сервисом, отдельно от среды выполнения AMP, обычно через встроенный <iframe>. Эти компоненты всегда зависят от конкретного сервиса. Вот примеры сторонних компонентов:

  • <amp-facebook>
  • <amp-gfycat>
  • <amp-subscriptions-google>
  • и т.д.

Цель этих руководств — различать собственные и сторонние компоненты по их названиям, чтобы компонент, предоставленный сторонним сервисом, не путался с универсальным.

Руководство 1: Сторонние компоненты должны содержать название бренда

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

• ✅ Это OK: <amp-facebook-comments>
• ❌ Это не OK: <amp-comments>

Исключение: Название бренда может быть схожим с названием универсального компонентаПредположим, что есть сервис под названием Toast.io. Независимо от того, что этот сервис предоставляет, назвать компонент для этого сервиса "<amp-toast>" было бы неправильно, так как это может быть сведено к универсальному термину для компонента "toast". В этом случае название должно указывать, что это сторонний встраиваемый компонент:- ❌ Это не OK: <amp-toast>

• ✅ Это OK: <amp-embed-toast>
• ✅ Это OK: <amp-toast-io>

Руководство 2: Компоненты проигрывателей должны содержать суффикс "-player"

Названия сторонних продуктов могут не передавать их назначение, поэтому все названия компонентов проигрывателей (например, видео или аудио проигрывателей) должны заканчиваться на -player. Это предоставляет удобство по умолчанию: все сторонние компоненты проигрывателей всегда аннотируются таким образом.^[2]

Предположим, что есть поставщик видео под названием UltraVideo:

• ❌ Это не подходит: <amp-ultra-video>
• ✅ Это подходит: <amp-ultra-video-player>
• ✅ Это ещё лучше: <amp-ultra-video-embed-player>

¹ Почему <amp-iframe> или <amp-video-iframe> считаются первыми сторонами?

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

² Почему <amp-youtube> не имеет суффикса, как <amp-youtube-player>?

Названия нескольких компонентов медиаплеера не имеют суффикса -player, как <amp-youtube> и все те, которые применяются в списке медиаплееров. Эти компоненты исторически были созданы до этого руководства.