mailru.common.stream.post js api

Показывает пользователю диалог добавления записи в «Что нового».

Внешний вид: диалога, ленты Что нового.

Параметры

Имя Тип Описание
paramsobjectобъект, собержащий информацию о записи, которую вы хотите создать; обязательный параметр

Пример параметра params:

  1. {
  2.   'title': 'заголовок записи, будет написан жирным шрифтом',
  3.   // text - обязательное поле
  4.   // text никак не обрабатывается (ссылки не выделяются)
  5.   'text': 'основной текст вашей записи',
  6.   // картинка, которая будет отображаться в записи
  7.   'img_url': 'http://exmaple.com/img.gif',
  8.   'action_links': [
  9.     // абсолютные URL'ы работают только для внешних сайтов
  10.     // для приложений href будет даписан в якорь ссылки на страницу приложения
  11.     {'text': 'заголовок ссылки 1', 'href': 'http://example.com/test1'},
  12.     {'text': 'заголовок ссылки 2', 'href': 'http://example.com/test2'}
  13.   ]
  14. }

Ограничение на длину заголовка и текста — 400 символов. Ограничение на длину текста ссылок — 20 символов.

Если у значение любого из action_links text будет равно "default", то этот линк будет на тексте и картинке сообщения (если она задана) и не будет отображаться в списке линков под записью

Обратите внимание, что абсолютные URL'ы в action_link'ах работают только для внешних сайтов, для приложений ссылка под записью всегда будет вести на страницу приложения, а href будет дописан в якорь (после #). Этот текст можно прочитать с помощью функции hash.readjs.

Если размер картинки, указанной в img_url, превышает 180×180 пикселей, то она будет пропорционально уменьшена.

Результат

Для получения результата выполнения функции подписывайтесь на события, описанные в секции «Генерируемые события».

Генерируемые события

mailru.common.events.streamPublish

  1. {
  2.   // варианты: opened/closed/publishSuccess/publishFail/authError
  3.   'status': "publishSuccess"
  4. }

Пример вызова

  1. mailru.events.listen(mailru.common.events.streamPublish, function(event) {
  2.   // эта функция будет вызываться при закрытии диалога
  3.   alert(event.status);
  4. });
  5. mailru.common.stream.post({'title':'title', 'text': 'description'});

См. также

Использование JS API

Функции JS API