AMP

amp-facebook

Experimental
Bento

Description

Displays a Facebook post, video or comment.

 

Required Scripts

<script async custom-element="amp-facebook" src="https://cdn.ampproject.org/v0/amp-facebook-1.0.js"></script>

Usage

You can use the amp-facebook component to embed a Facebook post, a Facebook video or a comment on a Facebook post.

The following example shows how to embed a post:

<amp-facebook width="552" height="310"
    layout="responsive"
    data-href="https://www.facebook.com/ParksCanada/posts/1712989015384373">
</amp-facebook>
在 Playground 中打开此代码段

The following example shows how to embed a video:

<amp-facebook width="476" height="316"
    layout="responsive"
    data-embed-as="video"
    data-href="https://www.facebook.com/nasaearth/videos/10155187938052139">
</amp-facebook>
在 Playground 中打开此代码段

The following example shows how to embed a comment on a post:

<amp-facebook width="552" height="500"
    layout="responsive"
    data-embed-type="comment"
    data-href="https://www.facebook.com/zuck/posts/10102735452532991?comment_id=1070233703036185">
</amp-facebook>
在 Playground 中打开此代码段

Standalone use outside valid AMP documents

Bento allows you to use AMP components in non-AMP pages without needing to commit to fully valid AMP. You can take these components and place them in implementations with frameworks and CMSs that don't support AMP. Read more in our guide Use AMP components in non-AMP pages.

To find the standalone version of amp-facebook, see bento-facebook.

Attributes

data-href

The URL of the Facebook post/video/comment. For example, a post or video will look like https://www.facebook.com/zuck/posts/10102593740125791. A comment or comment reply will look like https://www.facebook.com/zuck/posts/10102735452532991?comment_id=1070233703036185.

data-embed-as

The value is either post, video or comment. The default is post.

Both posts and videos can be embedded as a post. Setting data-embed-as="video" for Facebook videos embeds the player of the video, and adds the accompanying post card with it. Setting data-embed-as="post" ignores the caption card. This is done to make sure we are zooming in on videos correctly.

The comment value embeds a single comment (or reply to a comment) on a post. This is not to be confused with amp-facebook-comments.

Check out the documentation for differences between post embeds and video embeds.

data-include-comment-parent

The value is either true or false. The default is false.

When you are embedding a comment reply, you can optionally also include the parent comment of the reply.

data-allowfullscreen

The value is either set or omitted. The default is omitted (no fullscreen).

When embedding a video, set this value to allow for a fullscreen experience.

data-align-center

The value is either true or false. The default is false.

For posts and videos, having this attribute set to true would align the post/video container to center.

data-locale (optional)

By default, the locale is set to user's system language; however, you can specify a locale as well.

For details on strings accepted here please visit the Facebook API Localization page.

title (optional)

Define a title attribute for the component to propagate to the underlying <iframe> element. The default value is "Facebook".

data-numposts (optional)

The number of comments to show. Currently Facebook SDK limits this to max 100. For details, see the Facebook comments documentation.

data-order-by (optional)

The order to use when displaying comments. For details, see the Facebook comments documentation.

data-action (optional)

The verb to display on the button. Can be either like or recommend. The default is like.

data-kd_site (optional)

This attribute is also known as data-kid_directed_site in the Facebook SDK. If your web site or online service, or a portion of your service, is directed to children under 13 you must enable this attribute. The default is false.

data-layout (optional)

Selects one of the different layouts that are available for the plugin. Can be one of standard, button_count, button or box_count. The default is standard.

data-ref (optional)

A label for tracking referrals which must be less than 50 characters and can contain alphanumeric characters and some punctuation.

data-share (optional)

Specifies whether to include a share button beside the Like button. This only works with the XFBML version. The default is false.

data-size (optional)

The size of the button, which can be one of two sizes, large or small. The default is small.

For details, see the Facebook comments documentation.

data-tabs (optional)

Specifies the tabs to render (i.e., timeline, events, messages). Use a comma-separated list to add multiple tabs (e.g., timeline, events). By default, the Facebook page plugin shows the timeline activity.

data-hide-cover (optional)

Hides the cover photo in the header. Default value is false.

data-show-facepile (optional)

Shows profile photos of friends who like the page. Default value is true.

data-hide-cta (optional)

Hides the custom call to action button (if available). Default value is false.

data-small-header (optional)

Uses the small header instead. Default value is false.

Common attributes

This element includes common attributes extended to AMP components.

Deprecated attributes

data-colorscheme (optional)

The color scheme. For details, see the Facebook comments documentation.

Note: This is no longer supported by Facebook. For more details, follow our our tracking issue and Facebook's bug report.

Validation

See amp-facebook rules in the AMP validator specification.

需要更多帮助?

您已多次阅读本文档,但它仍未能涵盖您的所有问题?也许其他人也这么觉得:在 Stack Overflow 上与他们联系。

前往 Stack Overflow
发现错误或缺少功能?

AMP 项目强烈鼓励您参与并做出贡献!我们希望您能成为我们开放源代码社区的持续参与者,但我们也欢迎您对所热衷问题做出一次性贡献。

前往 GitHub