mailru.common.stream.post js api

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

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

Параметры

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

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

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

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

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

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

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

Результат

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

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

mailru.common.events.streamPublish

{
  // варианты: opened/closed/publishSuccess/publishFail/authError
  'status': "publishSuccess"
}

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

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

См. также

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

Функции JS API