Hộp thoại Chia sẻ

Thông qua hộp thoại Chia sẻ, mọi người có thể đăng một tin riêng lẻ lên dòng thời gian của họ, dòng thời gian của bạn bè, một nhóm hoặc trong một tin nhắn riêng tư trên Messenger. Hộp thoại Chia sẻ không yêu cầu phương thức Đăng nhập bằng Facebook hay bất kỳ quyền mở rộng nào. Vì vậy, đây là cách dễ nhất để cho phép chia sẻ trên web.

Tài liệu này mô tả cách triển khai hộp thoại Chia sẻ trên Web. Nếu bạn muốn triển khai hộp thoại Chia sẻ trong ứng dụng di động, hãy xem phần Chia sẻ trên iOS và Chia sẻ trên Android.

Dưới đây là ví dụ minh họa hộp thoại Chia sẻ dùng để chia sẻ liên kết lên dòng thời gian của người dùng.

Ở hình ảnh bên trên, chúng tôi đã chọn Chia sẻ trên Dòng thời gian của chính bạn trong danh sách thả xuống để chọn đối tượng chia sẻ. Danh sách thả xuống để chọn đối tượng chia sẻ sẽ không hiện ra khi một người đang dùng trình duyệt không đăng nhập bằng cookie. Điều này cũng đúng nếu ứng dụng sử dụng hộp thoại nguồn cấp dữ liệu thay vì hộp thoại chia sẻ hoặc nếu ứng dụng dùng chế độ xem web iframe.

Nếu bạn là Quản trị viên web của một trang được chia sẻ lên Facebook, hãy thêm thẻ meta open graph để tùy chỉnh tin được chia sẻ trở lại Facebook. Bạn cần phải đánh dấu trang web bằng thẻ Open Graph để kiểm soát cách nội dung của mình xuất hiện trên Facebook. Để biết thêm thông tin, hãy xem Hướng dẫn chia sẻ dành cho quản trị viên web.

Chia sẻ bằng cách chuyển hướng URL

Để chia sẻ liên kết bằng cách chuyển hướng URL, bạn cần sử dụng mã sau đây. Chúng tôi đã ngắt dòng để dễ đọc. Hãy xóa ngắt dòng khi bạn sử dụng mã này.

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

Chia sẻ bằng Facebook SDK dành cho JavaScript

Hộp thoại Chia sẻ có sẵn trong Facebook SDK dành cho JavaScript khi bạn sử dụng hàm FB.ui cùng với thông số phương thức share. Hãy sử dụng đoạn mã dưới đây để mở hộp thoại Chia sẻ.

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});

Hãy tự trải nghiệm!

Thông số

Dưới đây là những thông số của hộp thoại Chia sẻ.

Thông số	Mô tả	Bắt buộc?
`app_id`	Thông tin nhận dạng duy nhất của ứng dụng.	Có. Được cung cấp tự động khi bạn sử dụng SDK.
`display`	Cách hiển thị hộp thoại Chia sẻ. Chuyển hướng URL - Giá trị `display` là `page`. Hộp thoại Chia sẻ là một trang đầy đủ xuất hiện trong Facebook.com. Facebook SDK dành cho JavaScript - Giá trị display là một trong những giá trị sau đây: `iframe` của phương thức cho những người đã đăng nhập vào ứng dụng của bạn `async` khi sử dụng trong game trên Facebook.com cửa sổ `popup` cho những người khác Nếu cần thiết, bạn cũng có thể buộc hiển thị theo kiểu `popup` khi sử dụng Facebook SDK dành cho JavaScript. Ứng dụng web di động - Giá trị `display` luôn là `touch`. Facebook SDK dành cho iOS hoặc Android - SDK này sẽ tự động chỉ định giá trị `display` và chọn kiểu hiển thị thích hợp cho thiết bị.	Có. Được cung cấp tự động khi bạn sử dụng SDK.
`hashtag`	Hashtag sẽ thêm vào nội dung được chia sẻ. Mọi người có thể gỡ hashtag trong hộp thoại Chia sẻ. Hashtag này cần có ký hiệu dấu thăng, chẳng hạn như `#facebook`. Giá trị mặc định là `null`.	Không
`href`	Liên kết sẽ chia sẻ. Giá trị mặc định là URL hiện tại.	Bắt buộc khi bạn sử dụng SDK.
~~`redirect_uri`~~ Đã ngừng sử dụng	~~URL sẽ chuyển hướng đến sau khi một người nhấp vào nút trên hộp thoại Chia sẻ.~~	~~Có. Được cung cấp tự động khi bạn sử dụng SDK.~~
~~`mobile_iframe`~~ Đã ngừng sử dụng	~~`true` để mở hộp thoại chia sẻ trong iframe trên đầu trang web của bạn. Tùy chọn này chỉ dùng được trên di động, chứ không dùng được trên máy tính~~	~~`false`~~

Dữ liệu phản hồi

Chỉ có phản hồi khi người dùng đăng nhập vào ứng dụng của bạn thông qua phương thức Đăng nhập bằng Facebook.

Thông số	Mô tả
`error_message`	Thông báo lỗi.

Xem thêm

Cách tốt nhất để chia sẻ