<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[factorymn - Medium]]></title>
        <description><![CDATA[Разработка и развитие до результата мобильных и интернет-продуктов - Medium]]></description>
        <link>https://medium.com/factorymn?source=rss----45b8e81e35da---4</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>factorymn - Medium</title>
            <link>https://medium.com/factorymn?source=rss----45b8e81e35da---4</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 00:06:35 GMT</lastBuildDate>
        <atom:link href="https://medium.com/feed/factorymn" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Представление большого объема данных в виде линейных графиков с D3.js]]></title>
            <link>https://medium.com/factorymn/%D0%BF%D1%80%D0%B5%D0%B4%D1%81%D1%82%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B1%D0%BE%D0%BB%D1%8C%D1%88%D0%BE%D0%B3%D0%BE-%D0%BE%D0%B1%D1%8A%D0%B5%D0%BC%D0%B0-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%B2-%D0%B2%D0%B8%D0%B4%D0%B5-%D0%BB%D0%B8%D0%BD%D0%B5%D0%B9%D0%BD%D1%8B%D1%85-%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%BA%D0%BE%D0%B2-%D1%81-d3-js-61ebfa5909dc?source=rss----45b8e81e35da---4</link>
            <guid isPermaLink="false">https://medium.com/p/61ebfa5909dc</guid>
            <category><![CDATA[d3js]]></category>
            <category><![CDATA[charts]]></category>
            <category><![CDATA[frontend]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[data-visualization]]></category>
            <dc:creator><![CDATA[Mikhail Shabrikov]]></dc:creator>
            <pubDate>Thu, 15 Feb 2018 07:31:09 GMT</pubDate>
            <atom:updated>2018-02-15T07:38:50.401Z</atom:updated>
            <content:encoded><![CDATA[<h4>Пять примеров повышения интерактивности и удобства чтения</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cQmBvJAKcmk_Gcx0LjtWwA.png" /></figure><p>В этой статье мы разберём несколько приёмов, как сделать обычный линейный график более информативным и интерактивным. Для этого мы будем использовать JavaScript-библиотеку для визуализации данных — <a href="https://d3js.org/">D3.js</a>. Возьмём на вооружение <a href="https://hubofdata.ru/">хаб открытых данных</a> и визуализируем статистику «<a href="https://hubofdata.ru/dataset/cbrf_ind_85">динамики средневзвешенных процентных ставок по кредитам, предоставленным юридическим и физическим лицам</a>» для регионов, входящих в состав Центрального федерального округа России. Я прокомментировал фрагменты кода, однако замечу, что человеку не знакомому с базовыми концептами библиотеки D3.js (такими как <a href="https://github.com/d3/d3-selection">selection</a>, <a href="https://github.com/d3/d3-scale">scale</a>, <a href="https://bl.ocks.org/cmgiven/32d4c53f19aea6e528faf10bfe4f3da9">update pattern</a>, <a href="https://github.com/trinary/d3-transform">transform</a>, <a href="https://github.com/d3/d3-zoom">zoom</a>), многие моменты могут показаться не очевидными. Также здесь используется последняя — четвёртая версия библиотеки, имеющая ряд существенных отличий от третьей версии, долгое время бывшей в ходу. Код примеров написан с использованием ES6 синтаксиса, и если вы будете переносить какие-то части кода в ваш проект, работающий в среде не поддерживающей какую-либо из используемых фич, убедитесь, что вы используете транслятор кода в нужную вам версию (скорее всего это будет Babel), либо сделайте это <a href="https://babeljs.io/repl/">онлайн</a>.</p><p>Перед стартом давайте ознакомимся со структурой наших исходных данных:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*blbn9CSu9X2iwC0gr4euRw.png" /></figure><p>Каждая строка данных в csv файле это: ID региона (поле regionId), название региона (regionName), дата (date) и значение процентной ставки (percent).</p><h3>Отрисовываем графики</h3><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/08c2ff9bbe4125c5e9eb7a41c687b22d/href">https://medium.com/media/08c2ff9bbe4125c5e9eb7a41c687b22d/href</a></iframe><p>Установив русскую дефолтную локаль, загружаем csv файл с данными с помощью метода d3.csv который получает url ресурса и callback-функцию. После загрузки библиотека распарсит содержимое csv файла и вызовет callback-функцию, передав первым аргументом массив данных.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/94dd561906e1960aa69730895f595f07/href">https://medium.com/media/94dd561906e1960aa69730895f595f07/href</a></iframe><p>Непосредственно в функции для отрисовки графика первым делом определяем дефолтные размеры и три шкалы, которые нам понадобятся — шкала оси X, шкала оси Y и цветовая шкала, которую мы будем использовать для задания цвета графикам. Добавляем на страницу и сохраняем в переменную svg DOM-ноду, которая будет являться контейнером для прочих элементов визуализации.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b1996a2a84d9909b9aa7eed134b61508/href">https://medium.com/media/b1996a2a84d9909b9aa7eed134b61508/href</a></iframe><p>Обновим свойства date и percent каждого элемента нашего массива данных, преобразовав их значения из строки в Date-объект и из строки в число, соответственно. Теперь мы можем задать domain для наших шкал.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a99f1aa7ee1e9ec30809a246c52a0268/href">https://medium.com/media/a99f1aa7ee1e9ec30809a246c52a0268/href</a></iframe><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*5Mf3FzcWuLTankMQ3lQaww.png" /></figure><p>Определяем ось X (xAxis) и ось Y (yAxis), добавляем их на страницу. Обратите внимание, мы задали tickSize для оси X равный ширине графика, а для оси Y равный высоте. За счет этого мы получили сетку в области графиков.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/dbd0f86f24e2e1b007cfd04d56237e39/href">https://medium.com/media/dbd0f86f24e2e1b007cfd04d56237e39/href</a></iframe><p>Затем отрисовываем непосредственно линии графика. Проделав еще ряд манипуляций с исходным массивом данных, получаем объект (сохранен в переменной regions) в виде: ключи объекта — ID регионов, значения — массив данных (дата/процентная ставка) для данного региона. Таким образом, используя массив ID регионов для привязки данных - .data(regionIds), мы передаем необходимые данные в lineGenerator (функцию, которая вернет нужное значение аргумента d) просто обращаясь к объекту по ключу:</p><pre>.attr(&#39;d&#39;, regionId =&gt; lineGenerator(regions[regionId]))</pre><p>Итак, <a href="https://codepen.io/levvsha/pen/RQapQK">графики построены</a>, и вот здесь-то мы и видим весь масштаб проблемы — графиков очень много, плотность данных высокая, графики перекрываются, и пользователю совершенно не возможно вычленить сколько-нибудь полезной информации из этого клубка линий.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vgGjPuhAaDmddqPeQRryDA.png" /></figure><p>В последующих разделах статьи мы постараемся добавить максимум возможностей для пользователя распутать этот клубок, сделаем график интерактивным, а пока добавим вещь, без которой даже столь несуразный график не имеет смысла — легенду.</p><p>Последующие разделы будут иметь следующую структуру: сразу после заголовка будет следовать ссылка на страницу с визуальным представлением разницы между текущим кодом визуализации (с которым мы завершили предыдущий раздел) и кодом, который мы получим после реализации фичи, рассматриваемой в данном разделе. После этого мы рассмотрим ключевые фрагменты изменившегося/добавившегося кода, и в завершении вы сможете запустить встроенное демо, и посмотреть, как это работает. Таким образом мы не будем распыляться на малозначительные моменты модифицированного кода, вроде изменения стилизации/размеров, добавление констант, изменения структуры добавляемых на страницу элементов. Вы всегда сможете открыть codepen-демо в отдельной вкладке, увидеть весь код и изменить его под себя.</p><h4>1. Добавляем легенду и возможность управления видимостью графиков</h4><p><a href="https://github.com/factorymn/d3-in-all-its-glory/commit/fcc2afd8e223223d0743e150d7f68108cdb734de?diff=split"><em>Изменившийся код</em></a></p><p>Собственно легенда и подсказывает первый очевидный путь для улучшения нашей визуализации — сделать возможность скрытия желаемых линий графика кликом на соответствующий пункт легенды.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/55d56034ed18dca1c5775ae57496f2e6/href">https://medium.com/media/55d56034ed18dca1c5775ae57496f2e6/href</a></iframe><p>Сохраним в переменной regionNamesById объект с названиями регионов. Изменим структуру объекта, ранее сохраненного в переменной regions, теперь мы храним не только массив данных для определенного региона (свойство data), но и статус видимости линии данного региона на графике (свойство enabled).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e706d961ae6cc3f9c670a2f2f223b5af/href">https://medium.com/media/e706d961ae6cc3f9c670a2f2f223b5af/href</a></iframe><p>Снизу от графика выводим список регионов и соответствующий им цвет линии графика. Вешаем обработчик события клика на элемент легенды (функция clickLegendHandler).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f4ad76fa9b49d36bce3014eeeb25c032/href">https://medium.com/media/f4ad76fa9b49d36bce3014eeeb25c032/href</a></iframe><p>Мы будем изменять значение свойства enabled для данного региона. После чего заново запускать функцию отрисовки графиков redrawChart:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/38b94ed3a3ce32f550739ae7e6a1155b/href">https://medium.com/media/38b94ed3a3ce32f550739ae7e6a1155b/href</a></iframe><p>Фильтруем массив ID регионов, выбирая таким образом только регионы с включенным состоянием отображения. Полученный массив используем для привязки данных. Так как графики будут перерисовываться, следует на забывать удалять старые DOM-ноды перед добавлением новых: paths.exit().remove(). Запустите codepen ниже и посмотрите как это работает.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fembed%2Fpreview%2FaqNoGw%3Fheight%3D600%26slug-hash%3DaqNoGw%26default-tabs%3Djs%2Cresult%26host%3Dhttps%3A%2F%2Fcodepen.io%26embed-version%3D2&amp;url=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fpen%2FaqNoGw&amp;image=https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fi.cdpn.io%2F945857.aqNoGw.small.d6ade7b0-8243-4170-9d36-d18777289b90.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codepen" width="800" height="600" frameborder="0" scrolling="no"><a href="https://medium.com/media/84315d3fcc22ec95b9a0f16b0fb5cbd5/href">https://medium.com/media/84315d3fcc22ec95b9a0f16b0fb5cbd5/href</a></iframe><p>Как вы можете видеть, мы также добавили опции «скрыть все» и «показать все» (см. исходный код примера со строки 143). График уже стал намного дружественнее к пользователю. Мы можем скрыть все линии и выбрать 3–4 региона, которые нас интересуют в данный момент.</p><p>Но давайте подумаем, как еще мы бы могли улучшить взаимодействие пользователем с графиком? Согласитесь, что при текущей реализации пользователю неудобно действовать с заинтересовавшей его линей графика—в этом случае он должен найти в списке легенды соответствующий пункт, скрыть все линии и активировать его. Можем ли мы как-то помочь пользователю в этом случае? Ответ — да. В D3.js есть специальная фича для этого, которая называется <strong>разбиение Вороного</strong>.</p><h4>2. Добавляем разбиение Вороного</h4><p><a href="https://github.com/factorymn/d3-in-all-its-glory/commit/46a38ced8fca7709ff9f261e65cd72de1ff24d8e?diff=split"><em>Изменившийся код</em></a></p><blockquote><a href="https://dic.academic.ru/dic.nsf/ruwiki/328641">Диаграмма/разбиение Вороного</a> конечного множества точек S на плоскости представляет такое разбиение плоскости, при котором каждая область этого разбиения образует множество точек, более близких к одному из элементов множества S, чем к любому другому элементу множества.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/892/1*oKM2MfKTaBaESZ2wEuk2iQ.gif" /></figure><p>Пожалуй, лучше всего добавить ссылку на рабочий пример сразу же в начале раздела, что вы воочию могли увидеть как это работает, а после остановиться на деталях имплементации. Итак, запустите пример ниже, активируйте чекбокс «показать разбиение Вороного» и попробуйте изменить видимость линий некоторых регионов кликом на элементы легенды или в области графиков.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fembed%2Fpreview%2FyvOMPQ%3Fheight%3D600%26slug-hash%3DyvOMPQ%26default-tabs%3Djs%2Cresult%26host%3Dhttps%3A%2F%2Fcodepen.io%26embed-version%3D2&amp;url=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fpen%2FyvOMPQ&amp;image=https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fi.cdpn.io%2F945857.yvOMPQ.small.d3c6f38a-d9e3-40f6-8d89-e586dfe5bf31.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codepen" width="800" height="600" frameborder="0" scrolling="no"><a href="https://medium.com/media/f3679259e61efa1d9e143ef9b72583ee/href">https://medium.com/media/f3679259e61efa1d9e143ef9b72583ee/href</a></iframe><p>Теперь всякий раз, когда курсор мыши находится над областью графиков, мы можем ассоциировать текущую позицию курсора с ближайшей точкой данных на графике и сделать соответствующую линию активной (увеличив её толщину). Как вы можете убедиться на примере, это значительно упрощает возможность выбора линии графика при перемещении курсора, а при клике мы реализовали скрытие всех прочих линий кроме активной (повторный клик вернет график к прежнему состоянию).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a55ee2fc4789af7974753d7516e5eb35/href">https://medium.com/media/a55ee2fc4789af7974753d7516e5eb35/href</a></iframe><p>Весь сложный алгоритм разбиения создатели библиотеки реализовали за нас. Нам необходимо лишь определить функции для вычисления позиции по осям X и Y, а также, метод extend, куда мы передаем массив двух координат —верхнего левого и нижнего правого угла области, внутри которой должно произойти разбиение. Сохраним в переменную voronoiGroup DOM-ноду, которая будет служить контейнером для добавляемых полигонов разбиения. Добавляя, либо удаляя класс voronoi-show у этого элемента, мы будем управлять видимостью границ полигонов при переключении чекбокса «Показать разбиение Вороного».</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5753146d2f5ae68623d5b00cfe295db8/href">https://medium.com/media/5753146d2f5ae68623d5b00cfe295db8/href</a></iframe><p>В функции отрисовки графиков redrawChart мы теперь можем вызвать метод voronoi.polygons, передав единственным аргументом массив исходных данных, и получить на выходе массивы точек для построения полигонов — рассчитанных как раз с использованием алгоритма построения разбиения Вороного.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/bd1b0c1b58a3d91381bbdfa095ccd052/href">https://medium.com/media/bd1b0c1b58a3d91381bbdfa095ccd052/href</a></iframe><p>В функциях-обработчиках событий mouseover и mouseout мы будем, соответственно, добавлять или удалять класс region-hover для увеличения толщины линии, либо скрывать все линии, кроме активной в момент клика, либо возвращать графику предыдущее состояние (последующий клик).</p><p>И снова одна реализованная фича подсказывает нам, как еще мы можем улучшить этак график. Итак, если при перемещении курсора над областью графиков мы всегда имеем активной определенную точку данных, т.е. некоторую дату и величину процентной ставки в указанную дату, то почему бы нам не отображать точное значение процентной ставки для каждого региона рядом с легендой? Ведь сейчас пользователь может определить лишь примерное значение, мысленно проведя перпендикуляр к оси Y.</p><h4>3. Отображаем актуальные данные при перемещении курсора в области графиков</h4><p><a href="https://github.com/factorymn/d3-in-all-its-glory/commit/6a276a4977f093dafd7ceef0bfceb945eda3af0a?diff=split"><em>Изменившийся код</em></a></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2b73e46053a01018b2daaa472cf93a1a/href">https://medium.com/media/2b73e46053a01018b2daaa472cf93a1a/href</a></iframe><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Wcxk4xtS5uK47Yt_SypBfA.png" /></figure><p>Добавим и сохраним в переменную legendsValues набор нод, в которых мы будем выводить значение величины процентной ставки для соответствующего региона. А над этим списком будем выводить соответствующую дату в формате день-месяц-год (legendsDate).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fd888e374a38fc3eb74d4877356804b8/href">https://medium.com/media/fd888e374a38fc3eb74d4877356804b8/href</a></iframe><p>Создадим и сохраним в переменную percentsByDate объект, наполним его данными таким образом, что мы могли получить величину процентной ставки в конкретную дату в конкретном регионе следующим образом:</p><pre>percentsByDate[/* дата */][/* ID региона */]</pre><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f27bb9c3c71480abb7d06a2c8c9d4acd/href">https://medium.com/media/f27bb9c3c71480abb7d06a2c8c9d4acd/href</a></iframe><p>Обновлять значения будем при каждом пересечении курсором мыши (функция обработчик события mouseover) сегмента разбиения Вороного. Здесь же мы будем задавать смещение для точки (элемент в переменной hoverDot), показывающей, какая именно дата сейчас выделена на активной линии. Получившийся результат вы можете посмотреть, запустив пример ниже.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fembed%2Fpreview%2FgvrmGW%3Fheight%3D600%26slug-hash%3DgvrmGW%26default-tabs%3Djs%2Cresult%26host%3Dhttps%3A%2F%2Fcodepen.io%26embed-version%3D2&amp;url=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fpen%2FgvrmGW&amp;image=https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fi.cdpn.io%2F945857.gvrmGW.small.a9faba3f-2dd8-4619-9fc9-d5d0bcf0a714.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codepen" width="800" height="600" frameborder="0" scrolling="no"><a href="https://medium.com/media/61a72e02224052dd5c60bcb1b80510fe/href">https://medium.com/media/61a72e02224052dd5c60bcb1b80510fe/href</a></iframe><p>Следующим приемом для повышения интерактивности нашего графика будет возможность его масштабирования. Она будет чрезвычайно полезна, учитываю ту плотность данных, которую мы имеем.</p><h4>4. Добавляем возможность масштабирования графиков</h4><p><a href="https://github.com/factorymn/d3-in-all-its-glory/commit/da37c38cbdacbfb23b14ea21d0b2ccc7efd7a8ec?diff=split"><em>Изменившийся код</em></a></p><p>Еще одной примечательной фичей библиотеки D3.js, для реализации которой потребуется лишь несколько строк кода, является возможность масштабирования определенной области (<a href="https://github.com/d3/d3-zoom">d3.zoom</a>).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/59b7afc6a7783dd4c941905a790ba4a9/href">https://medium.com/media/59b7afc6a7783dd4c941905a790ba4a9/href</a></iframe><p>Определяем пороговые значения для величины масштабирования и смещения (помимо масштабирования мы также сможем смещать графики drag-and-drop-ом), указываем обработчики событий start и zoom и передаем в метод call на выбранном с помощью метода d3.select DOM элементе (в нашем случае это контейнер для полигонов разбиения Вороного).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/40da2e7e6b07ea961fcc3785265dc4b0/href">https://medium.com/media/40da2e7e6b07ea961fcc3785265dc4b0/href</a></iframe><p>Мы будем использовать <a href="http://tutorials.jenkov.com/svg/clip-path.html">clipPath для ограничения области видимости</a> элементов, которые в результате масштабирования могут частично или полностью оказаться за пределами области графиков.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e423d90465ba17f5ca8086084b5be1fa/href">https://medium.com/media/e423d90465ba17f5ca8086084b5be1fa/href</a></iframe><p>В функции обработчике события zoom, используя параметры объекта события d3.event.transform мы получаем новые значения для шкал координатных осей (rescaledX и rescaledY) и, используя их, обновляем отсечки на координатных осях, отрисовываем отмасштабированные линии графика.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e77e1dd2bf03ca33f01e93cd6019ae28/href">https://medium.com/media/e77e1dd2bf03ca33f01e93cd6019ae28/href</a></iframe><p>Значения rescaledX и rescaledY мы также используем для генератора линий, а также в обработчике события mouseover полигонов разбиения Вороного для задания смещения точки-указателя.</p><p>Мы также добавим кнопку “Сбросить зум”, чтобы пользователь мог вернуть графики к первоначальному состоянию одним кликом.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fembed%2Fpreview%2FBYKWRd%3Fheight%3D600%26slug-hash%3DBYKWRd%26default-tabs%3Djs%2Cresult%26host%3Dhttps%3A%2F%2Fcodepen.io%26embed-version%3D2&amp;url=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fpen%2FBYKWRd&amp;image=https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fi.cdpn.io%2F945857.BYKWRd.small.b91a6cff-d51c-480f-a710-3f41ec3a147f.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codepen" width="800" height="600" frameborder="0" scrolling="no"><a href="https://medium.com/media/6ab5ff0cca4b7cce196f71adc63b74df/href">https://medium.com/media/6ab5ff0cca4b7cce196f71adc63b74df/href</a></iframe><p>Финальным шагом давайте исправим один маленький недостаток, который привносится возможностью масштабирования графиков, ведь после масштабирования пользователь не совсем понимает, как сильно увеличен масштаб, насколько большой участок графика скрыт за пределом отмасштабированного участка и как график ведет себя за его пределами.</p><h4>5. Показываем превью с отображением отмасштабированного участка</h4><p><a href="https://github.com/factorymn/d3-in-all-its-glory/commit/ea779c131fc462d295e94ebf7b8a0ebbce7ee856?diff=split"><em>Изменившийся код</em></a></p><p>Сразу же начну раздел с гифки, демонстрирующей как это будет работать:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/912/1*U9-mLnscnw4CFdHlUHz_QA.gif" /></figure><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/df171380e921c837cae077ef7c672d09/href">https://medium.com/media/df171380e921c837cae077ef7c672d09/href</a></iframe><p>Превью области графиков будет в четыре раза меньше самой области. Сохраним это значение в переменную ratio, оно нам еще понадобится.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/6e76c1e94c75f6a8a18e10ecb229e7ce/href">https://medium.com/media/6e76c1e94c75f6a8a18e10ecb229e7ce/href</a></iframe><p>Определяем шкалы и функцию для генерации линий графиков на превью.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/efd902ffb99d6cfb89ca2cbaa9149281/href">https://medium.com/media/efd902ffb99d6cfb89ca2cbaa9149281/href</a></iframe><p>Собственно превью будет состоять из линии (мы будем показывать лишь одну, последнюю-активную линию) и двух элементов rect : статичного фона и элемента, который будет изменять свои размеры при масштабировании (сохранен в переменную draggedNode). Мы также реализуем возможность перемещения этого элемента мышью с помощью <a href="https://github.com/d3/d3-drag">d3-drag behavior</a>.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/23f737841693d70f7502efa210786119/href">https://medium.com/media/23f737841693d70f7502efa210786119/href</a></iframe><p>В функции dragged мы обновляем значения атрибутов x и y самого перетаскиваемого элемента, а также программно устанавливаем значение трансформации для масштабируемой области графиков: используя значение ratio задаем смещение по осям, для значения scale используем величину currentTransformationValue, которая имеет начальное значение равное 1 и изменяется при масштабировании (см. ниже).</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/efc60ab351eb2cd1873b89904ef4165d/href">https://medium.com/media/efc60ab351eb2cd1873b89904ef4165d/href</a></iframe><p>Внутри функции обработчика события zoom вычисляем и обновляем атрибуты x, y, width и height у элемента draggedNode, таким образом мы достигаем того, что этот элемент покрывает на превью область, соответствующую отмасштабированной.</p><p>Отрисовка превью активной линии происходит в функциях redrawChart и voronoiMouseover (см. код со строки 348 и 426 соответственно).</p><p>И последнее, итоговое демо, включающее все, что мы сделали в рамках этой статьи:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fembed%2Fpreview%2FOQNWqR%3Fheight%3D600%26slug-hash%3DOQNWqR%26default-tabs%3Djs%2Cresult%26host%3Dhttps%3A%2F%2Fcodepen.io%26embed-version%3D2&amp;url=https%3A%2F%2Fcodepen.io%2Flevvsha%2Fpen%2FOQNWqR&amp;image=https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fi.cdpn.io%2F945857.OQNWqR.small.9f9fbdfa-eac4-4ff8-a7c3-1272920e779e.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codepen" width="800" height="600" frameborder="0" scrolling="no"><a href="https://medium.com/media/020041b46fecb00f4945b6eecc9c7c9b/href">https://medium.com/media/020041b46fecb00f4945b6eecc9c7c9b/href</a></iframe><p>Совершенство недостижимо, и мы можем придумать ещё несколько способов улучшения данной визуализации. Например, используя <a href="https://github.com/d3/d3-brush">d3-brush</a>, мы можем реализовать <a href="https://bl.ocks.org/mbostock/f48fcdb929a620ed97877e4678ab15e6">выделение произвольной области графиков с последующим масштабированием</a>. Но уже и того, что мы реализовали в рамках этой статьи достаточно, чтобы убедится насколько широки возможности используемой библиотеки. Отдавая должное многочисленным библиотекам-надстройкам над D3.js (<a href="http://c3js.org/">C3.js</a>, <a href="https://emeeks.github.io/semiotic/#/">Semiotic</a>, <a href="https://naver.github.io/billboard.js/">Billboard.js</a> и подобные), упрощающим задачу создания визуализаций до уровня определения объекта-конфигурации, я остаюсь сторонником использования именно “нативного D3.js”, а для проектов с потенциально высокой вероятностью долгосрочной поддержки и развития и вовсе считаю это единственным верным вариантом.</p><p><em>P.S. Эта статья вдохновлена и использует в своей основе </em><a href="https://bl.ocks.org/lorenzopub/6a56e17551d59278631dffd7f65a0cda"><em>данное демо</em></a><em>.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=61ebfa5909dc" width="1" height="1" alt=""><hr><p><a href="https://medium.com/factorymn/%D0%BF%D1%80%D0%B5%D0%B4%D1%81%D1%82%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B1%D0%BE%D0%BB%D1%8C%D1%88%D0%BE%D0%B3%D0%BE-%D0%BE%D0%B1%D1%8A%D0%B5%D0%BC%D0%B0-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%B2-%D0%B2%D0%B8%D0%B4%D0%B5-%D0%BB%D0%B8%D0%BD%D0%B5%D0%B9%D0%BD%D1%8B%D1%85-%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%BA%D0%BE%D0%B2-%D1%81-d3-js-61ebfa5909dc">Представление большого объема данных в виде линейных графиков с D3.js</a> was originally published in <a href="https://medium.com/factorymn">factorymn</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Draft.js — фреймворк для создания текстовых редакторов от Facebook]]></title>
            <link>https://medium.com/factorymn/draft-js-%D1%84%D1%80%D0%B5%D0%B9%D0%BC%D0%B2%D0%BE%D1%80%D0%BA-%D0%B4%D0%BB%D1%8F-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D1%8F-%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D1%85-%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%BE%D1%80%D0%BE%D0%B2-%D0%BE%D1%82-facebook-ea8e9102aa1?source=rss----45b8e81e35da---4</link>
            <guid isPermaLink="false">https://medium.com/p/ea8e9102aa1</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[draftjs]]></category>
            <category><![CDATA[rich-text-editor]]></category>
            <category><![CDATA[frontend]]></category>
            <category><![CDATA[text-editor]]></category>
            <dc:creator><![CDATA[Mikhail Shabrikov]]></dc:creator>
            <pubDate>Thu, 16 Nov 2017 13:42:57 GMT</pubDate>
            <atom:updated>2018-02-15T07:39:18.638Z</atom:updated>
            <content:encoded><![CDATA[<h4>Русскоязычное руководство</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PXyPyova35r2dEsEdqfnqg.png" /></figure><p>Draft.js — часть огромной инфраструктуры, выстраиваемой в Facebook вокруг концепции React.js. Технологию, изначально созданную инженерами Facebook внутри компании, <a href="https://www.youtube.com/watch?v=feUYwoLhE_4">представили сообществу в феврале 2016 года на React Conf</a>, исходники проекта появились <a href="https://github.com/facebook/draft-js">на github</a>, и к текущему моменту репозиторий собрал уже более 11 000 звёзд.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/142/1*J2QOmYyPGPaD3O3wXDxaxg.png" /></figure><p>Конечно же, необходимо сразу отметить, что Draft.js — это инструмент для решения весьма узкого спектра задач, а именно — задач управления текстовым вводом и редактирования текста.</p><blockquote>“Rich text editor framework for React” (фреймворк для создания текстовых редакторов на React), как представляют его на официальном сайте.</blockquote><p>Здесь я хотел бы провести аналогию с другой узконишевой, но довольно известной в JavaScript сообществе технологией — <a href="https://d3js.org/">D3.js</a>. Рассчитываю, что эта аналогия позволит понять область применения Draft.js и ответит на резонно возникающий вопрос — «Зачем осваивать целый фреймворк, если можно воспользоваться массой готовых решений?». Допустим, вы хотите показать на странице некоторые данные в виде графика, и вам без труда удасться найти плагин/компонент/модуль, который «нарисует» желаемое и потребует от вас только передать ему на вход соответствующим образом отформатированные данные. Однако, если от вас требуется <a href="http://www.datasketch.es/december/code/nadieh/">что-то</a> <a href="https://nbremer.github.io/olympicfeathers/">совершенно</a> <a href="http://www.datasketch.es/july/code/nadieh/">нестандартное</a>, если необходима полная свобода в стилизации, расширении и кастомизации результата, то, скорее всего, от готового решения вам придется отказаться и обратиться к более низкоуровневому инструменту для работы с визуализацией данных, такому, как D3.js. Сказанное выше останется абсолютно справедливым, если мы заменим график на текстовый редактор и D3.js на Draft.js.</p><p>Потенциал этой технологии чрезвычайно высок. Посмотрите <a href="http://bitwiser.in/medium-draft/">примеры</a> <a href="https://draft-wysiwyg.herokuapp.com/">текстовых</a> <a href="https://jpuri.github.io/react-draft-wysiwyg/#/">редакторов</a> сделанных на Draft.js со страницы <a href="https://github.com/nikgraf/awesome-draft-js">«Awesome Draft.js»</a>. Ниже я попытаюсь раскрыть и продемонстрировать основные (но далеко не все) возможности этого фреймворка. При подготовке этой публикации я использовал примеры и рецепты кода из официальной <a href="https://draftjs.org/">документации Draft.js</a>, а также массы статей и блогпостов от очень активного комьюнити, образовавшегося вокруг Draft.js. Особо хотел бы выделить цикл статей, посвященных использованию этой технологии, от <a href="https://medium.com/u/89299dab9679">Brijesh Bittu</a> и его потрясающий open-source проект — <a href="https://github.com/brijeshb42/medium-draft">medium-draft</a>. Я рекомендовал бы обязательно изучить исходники этого проекта, если вам интересно как может быть организована архитектура по-настоящему сложного и многофункционального редактора.</p><p>На финише у нас накопится довольно внушительная кодовая база. Поэтому я решил выделить каждую стадию в отдельную ветку в <a href="https://github.com/factorymn/draftjs-blogpost-demo">репозитории</a> и <a href="https://factorymn.github.io/draftjs-blogpost-demo/">демо-страницу</a> на github pages, а в тексте статьи будут разобраны наиболее значимые фрагменты кода. Также я не буду останавливаться на структуре папок, config-файлах для Webpack и стилях. Если вы уже работали с React.js и Webpack, не думаю, что эти моменты вызовут у вас какие-либо вопросы. Если какие-то вопросы все же возникли — пишите в комментарии, я отвечу.</p><h3>Шаг 1. Подключаем компонент редактора</h3><p>Начнем с ветки starting point — это будет отправная точка. Все, что должно нас здесь интересовать — это файл src/components/DraftEditor/DraftEditor.js.</p><pre>export default class DraftEditor extends Component {<br>  constructor() {<br>    super();<br><br>    this.state = {<br>      editorState: EditorState.createEmpty()<br>    };<br><br>    this.onChange = (editorState) =&gt; {<br>      console.log(&#39;editorState ==&gt;&#39;, editorState.toJS());<br><br>      this.setState({ editorState });<br>    }<br>  }<br><br>  render() {<br>    const {<br>      editorState<br>    } = this.state;<br><br>    return (<br>      &lt;<strong>div<br>        </strong>id=&quot;editor-container&quot;<br>        className=&quot;c-editor-container js-editor-container&quot;<br>      &gt;<br>        &lt;<strong>div </strong>className=&quot;editor&quot;&gt;<br>          &lt;<strong>Editor<br>            </strong>editorState={editorState}<br>            onChange={this.onChange}<br>            placeholder=&quot;Здесь можно печатать...&quot;<br>          /&gt;<br>        &lt;/<strong>div</strong>&gt;<br>      &lt;/<strong>div</strong>&gt;<br>    );<br>  }<br>}</pre><p>Здесь мы просто подключили на страницу React-компонент Editor, который пока ничего не умеет. Давайте, однако, подробнее рассмотрим приведенный выше фрагмент кода, а потом уже возьмемся за добавление более интересного функционала. У компонента, помимо не требующего объяснений свойства placeholder, объявлены свойства:</p><ul><li>editorState — текущее состояние редактора.</li><li>onChange — функция вызывающаяся при любых манипуляциях внутри редактора, первый аргументом эта функция получает объект — изменившейся editorState.</li></ul><p>Как вы можете видеть из кода, мы будем хранить editorState редактора в стейте родительского компонента и обновлять его в методе onChange через setState. В конструкторе класса присвоим начальное значение свойству editorState с помощью EditorState.createEmpty(). Для тех случаев, когда редактор должен появится на странице уже с предопределенным контентом, используется метод <a href="https://draftjs.org/docs/api-reference-editor-state.html#createwithcontent">createWithContent</a>. Также в методе onChange поставим console.log, чтобы при каждом изменении видеть текущий editorState в консоли. Здесь нужно обратить внимание, что сам editorState — это сущность <a href="https://facebook.github.io/immutable-js/docs/#/Record">Record</a> библиотеки Immutable.js, поэтому мы переводим его в привычный JavaScript объект вызовом toJS().</p><p>Посмотрите, какой сложной структуры этот объект:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XtLUctxmseZPSftTQC57RQ.png" /></figure><p>Здесь, помимо данных непосредственно о текущем контенте редактора, хранится информация о выделенном фрагменте текста (selection), полная история изменений (undoStack/redoStack) и прочая информация. За счет использования immutable структур удается хранить историю изменений оптимальным для памяти и производительности приложения образом. Попробуйте стандартные горячие клавиши (Ctrl/Cmd + Z и Ctrl/Cmd + Shift + Z) для отмены и возвращения сделанных изменений. Конечно, сейчас, когда наш редактор по своему функционалу мало чем отличается от обычной textarea, это выглядит не так эффектно, поэтому, давайте перейдем к следующему шагу.</p><h3>Шаг 2. Инлайн стилизация</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/343/1*YipKbhNUmPhWn1BKU6OMSQ.png" /></figure><p>В этой части, рассмотрим, как с помощью Draft.js применить стилизацию к тексту. Мы повторим знакомое всем пользователям Medium поведение с появлением тулбара с вариантами действий непосредственно над выделенным участком текста.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5H9A1YLGctM9hkniBJVW_g.png" /></figure><p>Переключитесь в ветку inline-stylization. У нас появился новый компонент src/components/InlineToolbar и файл для хранения утилитарных функций utils/index.js. Сейчас их там две: getSelectionRange для получения данных о текущем выделении (selection):</p><pre><strong>export</strong> <strong>const</strong> getSelectionRange = () =&gt; {<br>  <strong>const</strong> selection = window.getSelection();<br>  <strong>if</strong> (selection.rangeCount === 0) <strong>return</strong> null;</pre><pre>  <strong>return</strong> selection.getRangeAt(0);<br>};</pre><p>И getSelectionCoords для получения координат выделенного фрагмента относительно контейнера редактора:</p><pre><strong>export</strong> <strong>const</strong> getSelectionCoords = (selectionRange) =&gt; {<br>  <strong>const</strong> editorBounds = document.getElementById(&#39;editor-container&#39;).getBoundingClientRect();</pre><pre>  <strong>const</strong> rangeBounds = selectionRange.getBoundingClientRect();<br>  <strong>const</strong> rangeWidth = rangeBounds.right - rangeBounds.left;<br>  <em>// 107px is width of inline toolbar</em><br>  <strong>const</strong> offsetLeft = (rangeBounds.left - editorBounds.left) + (rangeWidth / 2) - (107 / 2);<br>  <em>// 42px is height of inline toolbar</em><br>  <strong>const</strong> offsetTop = rangeBounds.top - editorBounds.top - 42;</pre><pre>  <strong>return</strong> { offsetLeft, offsetTop };<br>};</pre><p>Следует заметить, что эти функции даже никак не связанны с Draft.js, здесь используется стандартный браузерный <a href="https://developer.mozilla.org/en-US/docs/Web/API/Selection">Selection API</a>. Воспользуемся ими в методе onChange компонента DraftEditor, где теперь мы не просто обновляем свойство editorState стейта компонента, но и проверяем, есть ли внутри редактора выделенный фрагмент текста (как упоминалось выше, объект editorState хранит в себе информацию в том числе и о selection). В положительном случае мы вычисляем координаты, необходимые, чтобы наш тулбар появился непосредственно над выделенным текстом и обновляем стейт компонента.</p><pre>onChange(editorState) {<br>    <strong>if</strong> (!editorState.getSelection().isCollapsed()) {<br>      <strong>const</strong> selectionRange = getSelectionRange();</pre><pre>      <strong>if</strong> (!selectionRange) {<br>        <strong>this</strong>.setState({ inlineToolbar: { show: false } });</pre><pre>        <strong>return</strong>;<br>      }</pre><pre>      <strong>const</strong> selectionCoords = getSelectionCoords(selectionRange);</pre><pre>      <strong>this</strong>.setState({<br>        inlineToolbar: {<br>          show: true,<br>          position: {<br>            top: selectionCoords.offsetTop,<br>            left: selectionCoords.offsetLeft<br>          }<br>        }<br>      });<br>    } <strong>else</strong> {<br>      <strong>this</strong>.setState({ inlineToolbar: { show: false } });<br>    }</pre><pre>    <strong>this</strong>.setState({ editorState });<br>  }</pre><p>В компоненте DraftEditor также появился новый метод:</p><pre>toggleInlineStyle(inlineStyle) {<br>    <strong>this</strong>.onChange(<br>      RichUtils.toggleInlineStyle(<br>        <strong>this</strong>.state.editorState,<br>        inlineStyle<br>      )<br>    );<br>  }</pre><p>Здесь мы впервые воспользуемся методом из модуля <a href="https://draftjs.org/docs/api-reference-rich-utils.html">RichUtils</a> — это набор утилит для Draft.js, в дальнейшем мы ещё неоднократно к нему обратимся. Метод RichUtils.toggleInlineStyle, получая первым аргументом текущий editorState редактора, а вторым — строку с названием стиля, который должен быть применен (например &#39;BOLD&#39;), вернет новый editorState, в котором уже будет храниться информация, что выделенный на момент вызова фрагмент текста стилизован соответствующим образом.</p><p>Метод toggleInlineStyle прокидываем в свойство onToggle компонента InlineToolbar:</p><pre>&lt;InlineToolbar<br>  editorState={editorState}<br>  onToggle={<strong>this</strong>.toggleInlineStyle}<br>  position={inlineToolbar.position}<br>/&gt;</pre><p>В самом компоненте (src/components/InlineToolbar) вызываем его в функции обработчике события onMouseDown:</p><pre>onMouseDown={(e) =&gt; {<br>  e.preventDefault();<br>  onToggle(type.style);<br>}}</pre><p>Тулбар будет состоять из трех элементов, по клику на которые выделенный текст будет стилизован одним из следующий типов стилей: BOLD — жирное начертание, ITALIC— курсив и HIGHLIGHT — выделенный текст. И здесь необходимо заметить, что BOLD и ITALIC — это стандартные типы стилей для Draft.js. То есть, когда один из них применяется к фрагменту текста, Draft.js знает о том, что к соответствующей этому фрагменту DOM-ноде, следует применить инлайновые стили font-weight: bold и font-style: italic соответственно. А вот для того, чтобы фреймворк знал, какие css-правила необходимо применять для кастомных стилей (в нашем случае — HIGHLIGHТ), объявляем в компоненте src/components/DraftEditor объект customStyleMap:</p><pre><strong>const</strong> customStyleMap = {<br>  HIGHLIGHT: {<br>    backgroundColor: &#39;palegreen&#39;,<br>  },<br>};</pre><p>Формат этот объекта должен быть следующим: ключи — названия кастомного стиля, значение — соответствующие ему css-свойства. В случае, если нам понадобятся другие кастомные стили, мы просто расширим этот объект новыми свойствами. Теперь передаем этот объект в одноименное свойство компонента Editor:</p><pre>&lt;Editor<br>  editorState={editorState}<br>  onChange={<strong>this</strong>.onChange}<br>  handleKeyCommand={<strong>this</strong>.handleKeyCommand}<br>  customStyleMap={customStyleMap}<br>  ref=&quot;editor&quot;<br>/&gt;</pre><p>Последнее, что осталось рассмотреть в этой части — метод handleKeyCommand. Как вы видите, из фрагмента кода выше, он также передается в соответствующее свойство компонента Editor. Этот метод необходим, чтобы наш редактор мог реагировать на стандартные для инструментов редактирования текста горячие клавиши.</p><pre>handleKeyCommand(command) {<br>    <strong>const</strong> { editorState } = <strong>this</strong>.state;<br>    <strong>const</strong> newState = RichUtils.handleKeyCommand(editorState, command);</pre><pre>    <strong>if</strong> (newState) {<br>      <strong>this</strong>.onChange(newState);<br>      <strong>return</strong> true;<br>    }</pre><pre>    <strong>return</strong> false;<br>  }</pre><p>Попробуйте выделить текст и нажать Ctrl/Cmd + B или Ctrl/Cmd + I, текст примет жирное или курсивное начертание. И опять же, что бы нам определить кастомные горячие клавиши для стилизации либо каких то других манипуляций внутри редактора, придется проделать немного дополнительной работы. <a href="https://draftjs.org/docs/advanced-topics-key-bindings.html#content">Наглядный пример</a> реализации этого есть на официальном сайте Draft.js.</p><h3>Шаг 3. Добавление ссылок — Entities и Decorators в Draft.js.</h3><p>В этой части расширим наш редактор возможностью добавления ссылок и на этом примере рассмотрим две широкоиспользуемые в Draft.js концепции: Entities — особым образом аннотированные участки текста, которые могут иметь некоторые метаданные (для нашего случая это url ссылки) и систему декораторов (Draft.js Decorators).<br>Переключимся в ветку link-entity. Обратите внимание на то, что в тулбаре появился новый элемент для добавления ссылки.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GvLjx1YdHLi605Hl9YLYzg.png" /></figure><p>Для простоты мы будем использовать стандартный prompt диалог. Рассмотрим метод setLink, который вызывается при клике на соответствующий элемент тулбара.</p><pre>setLink() {<br>    // <em>получаем ссылку из prompt диалога</em><br>    <strong>const</strong> urlValue = prompt(&#39;Введите ссылку&#39;, &#39;&#39;);</pre><pre>    // <em>получаем текущий editorState</em><br>    <strong>const</strong> { editorState } = <strong>this</strong>.state;</pre><pre><em>    // получаем текущий contentState</em><br>    <strong>const</strong> contentState = editorState.getCurrentContent();</pre><pre>    // <em>создаем Entity<br></em>    <strong>const</strong> contentStateWithEntity = contentState.createEntity(<br>      &#39;LINK&#39;,<br>      &#39;SEGMENTED&#39;,<br>      { url: urlValue }<br>    );</pre><pre>    <strong>const</strong> entityKey = contentStateWithEntity.getLastCreatedEntityKey();</pre><pre><em>    // обновляем свойство currentContent у editorState</em><br>    <strong>const</strong> newEditorState = EditorState.set(editorState, {currentContent: contentStateWithEntity});<br><br>    // с помощью метода toggleLink из RichUtils генерируем новый<br>    // editorState и обновляем стейт<br>    <strong>this</strong>.setState({<br>      editorState: RichUtils.toggleLink(<br>        newEditorState,<br>        newEditorState.getSelection(),<br>        entityKey<br>      )<br>    }, () =&gt; {<br>      setTimeout(() =&gt; <strong>this</strong>.focus(), 0);<br>    });<br>  }</pre><p>Подробнее остановимся на созданииEntity. Для создания Entity необходимо на текущем contentState вызвать метод createEntity, который принимает два обязательных аргумента и один опциональный. Давайте рассмотрим каждый из них на нашем примере:</p><ul><li>LINK (строка) — собственно тип создаваемого Entity. Ниже, когда мы начнем рассматривать декораторы, мы увидим пример использования этого свойства.</li><li>SEGMENTED (строка) — это свойство определяет поведение текста связанного с создаваемым Entity в случае его редактирования. Возможные значения: IMMUTABLE — любое редактирование текста приведет к разрыву связи фрагмента текста с Entity и, соответственно, её удалению; MUTABLE — полная свобода редактирования текста, Entity будет удалено вместе с удалением последнего символа из ассоциированного участка текста; SEGMENTED — связь между текстом и Entity разрывается при добавлении символов к тексту, однако, при удалении, сохраняется пока не удален последний сегмент текста. Как именно Entity ведет себя в этом случае, лучше увидеть наглядно, поэтому мы используем именно SEGMENTED в нашем примере, в реальных условиях, для ссылки логично использовать тип MUTABLE.</li><li>{ url: urlValue } (объект) — метаданные, которые будут привязаны к создаваемому Entity (опциональный аргумент).</li></ul><p>Если бы мы, все же, дополняли наш код последовательно, то сейчас, заметили бы, что после добавления Entity визуально контент редактора никак не изменился. Чтобы в контенте редактора отрендерить ссылку желаемым образом, воспользуемся <a href="https://draftjs.org/docs/advanced-topics-decorators.html">концепцией декораторов в Draft.js</a>. Она заключается в том, что содержимое редактора сканируется, и участки текста удовлетворяющие определенному условию рендерятся с помощью отдельного React.js компонента. В нашем случае таким условием будет то, что фрагмент текста имеет ассоциированное Entity с типом LINK.</p><pre>const decorator = new CompositeDecorator([<br>  {<br>    strategy: findLinkEntities,<br>    component: Link<br>  }<br>]);<br><br>this.state = {<br>  inlineToolbar: { show: false },<br>  editorState: EditorState.createEmpty(decorator)<br>};</pre><p>Создаем экземпляр класса CompositeDecorator передавая в качестве аргумента массив объектов со свойствами strategy — функция для выборки фрагментов текста и component — компонент, с помощью которого этот фрагмент будет отрендерен, сохраняем его в переменную decorator, которую передаем в метод createEmpty. Код компонента и функции выборки приведен ниже.</p><pre>function findLinkEntities(<em>contentBlock</em>, <em>callback</em>, <em>contentState</em>) {<br>  <em>contentBlock</em>.findEntityRanges(<br>    (<em>character</em>) =&gt; {<br>      const entityKey = <em>character</em>.getEntity();<br>      return (<br>        entityKey !== null &amp;&amp;<br>        <em>contentState</em>.getEntity(entityKey).getType() === &#39;LINK&#39;<br>      );<br>    },<br>    <em>callback<br>  </em>);<br>}<br><br>const Link = (<em>props</em>) =&gt; {<br>  const { url } = <em>props</em>.contentState<br>    .getEntity(<em>props</em>.entityKey).getData();<br><br>  return (<br>    &lt;<strong>a </strong>href={url} title={url} className=&quot;ed-link&quot;&gt;<br>      {<em>props</em>.children}<br>    &lt;/<strong>a</strong>&gt;<br>  );<br>};</pre><h3>Шаг 4. Кастомный блок — слайдер</h3><p>Возможность определения кастомных блоков — это, пожалуй, самая мощная фича в арсенале Draft.js. В этой части мы реализуем возможность добавления в контент редактора слайдера изображений. Причем сделать это можно будет просто перетащив несколько изображений в область редактора.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*6M1XBnUS-hurM8MfhWLm6g.gif" /></figure><p>В законченном виде этот функционал сохранен в ветке custom-component демо-репозитория (<a href="https://factorymn.github.io/draftjs-blogpost-demo/custom-component/">попробовать как это работает</a>).</p><p>Начнем с того, что в Draft.js есть и набор дефолтных блоков (с полным их перечнем можно ознакомиться <a href="https://draftjs.org/docs/advanced-topics-custom-block-render-map.html#draft-default-block-render-map">здесь</a>). Подобно случаю с дефолтными стилями, для их добавления в редактор не потребуется создавать отдельного компонента.</p><pre>constructor() {<br>  ...<br>  this.getEditorState = () =&gt; this.state.editorState;<br>  this.blockRendererFn = customBlockRenderer(<br>    this.onChange,<br>    this.getEditorState<br>  );<br>}</pre><pre>...</pre><pre>const customBlockRenderer = (<em>setEditorState</em>, <em>getEditorState</em>) =&gt; (<em>contentBlock</em>) =&gt; {<br>  const type = <em>contentBlock</em>.getType(); &lt;-- [1]<br><br>  switch (type) {<br>    case &#39;SLIDER&#39;:<br>      return {<br>        component: EditorSlider, // &lt;-- [2]<br>        props: {<br>          <em>getEditorState</em>, // &lt;-- [3]<br>          <em>setEditorState</em>, // &lt;-- [3]<br>        }<br>    };<br><br>    default: return null;<br>  }<br>};<br><br>const RenderMap = new Map({ // &lt;-- [4]<br>  SLIDER: {<br>    element: &#39;div&#39;, // &lt;-- [5]<br>  }<br>}).merge(DefaultDraftBlockRenderMap);</pre><p>В случае же с кастомным блоком нам потребуется создать отдельный react-компонент и сообщить редактору, что он должен рендерить блок определенного типа [1], (в нашем случае SLIDER) с помощью указанного компонента [2]. Для этого мы определяем функцию customBlockRenderer, получающую перым аргументом функцию для обновления editorState, а вторым — функцию для получения текущего editorState, эти же функции мы пробросим в props нашего компонента [3]. Также, определим RenderMap [4] — правила, сообщающие редактору, какой элемент должен быть оберткой для нашего компонента, в конкретном случае, это будет простой &lt;div&gt;, но, в зависимости от задачи, это может быть и другой react-компонент.</p><pre>render() {<br>    ...<br>    &lt;<strong>Editor<br>      </strong>editorState={editorState}<br>      onChange={this.onChange}<br>      handleKeyCommand={this.handleKeyCommand}<br>      customStyleMap={customStyleMap}<br>      handleDroppedFiles={this.handleDroppedFiles} // &lt;-- [4]<br>      handleReturn={this.handleReturn} // &lt;-- [3]<br>      blockRenderMap={RenderMap} // &lt;-- [1]<br>      blockRendererFn={this.blockRendererFn} // &lt;-- [1]<br>      ref=&quot;editor&quot;<br>    /&gt;<br>    ...<br>  );<br>}</pre><p>RenderMap и метод this.blockRenderFn мы передаем в соответствующие свойства компонента Editor [1]. У компонента появилось еще два ранее не рассмотренных свойства: handleReturn и handleDroppedFiles. Первое из них [3] необходимо, что бы корректно обрабатывать нажатие пользователем кнопки Enter (переход на новую строку) для случая, когда курсор находится в пределах нашего кастомного блока. Дело в том, что если в момент нажатия Enter, курсор находится на участке текста являющимся блоком, Draft.js переводит курсор на новую строку и добавляет контейнер именно для того блока, на котором курсор находился, поэтому, чтобы у нас не вставлялся новый слайдер, мы предотвращаем такое поведение в методе this.handleReturn. В свойство handleDroppedFiles передается обработчик для события, перетаскивания файла/файлов в область редактора.</p><pre>handleDroppedFiles(<em>selection</em>, <em>files</em>) {<br>  const filteredFiles = <em>files<br>    </em>.filter(<em>file </em>=&gt; (<em>file</em>.type.indexOf(&#39;image/&#39;) === 0)); // &lt;-- [1]<br><br>  if (!filteredFiles.length) {<br>    return &#39;not_handled&#39;; // &lt;-- [2]<br>  }<br><br>  this.onChange(addNewBlockAt( // &lt;-- [3]<br>    this.state.editorState, <br>    <em>selection</em>.getAnchorKey(),<br>    &#39;SLIDER&#39;,<br>    new Map({ slides: _map(<br>      filteredFiles,<br>      <em>file </em>=&gt; ({ url: urlCreator.createObjectURL(<em>file</em>) }) // &lt;-- [4]<br>    )})<br>  ));<br><br>  return &#39;handled&#39;;<br>}</pre><p>Здесь мы отфильтруем только изображения из массива переданных файлов [1], и если среди этих файлов изображений нет — то мы никак не будем обрабатывать это событие [2], а в положительном случае — обновим состояние редактора с помощью метода addNewBlockAt, реализацию которого можно посмотреть в файле для хранения утилит — /src/utils/index.js.</p><p>Изучая код множества open-source проектов, использующих Draft.js, можно найти для себя массу полезных рецептов для реиспользования кода. Также, хотел бы отметить вот <a href="https://github.com/jpuri/draftjs-utils">этот репозиторий</a>, где подобные утилитарные методы агрегируются. Чтобы метод addNewBlockAt разобрался, какой блок необходимо добавить и куда именно, в качестве аргументов мы передаем ему: текущий стейт редактора, ключ фрагмента текста, являющегося началом текущего selection, тип блока и данные для этого блока. Данные (url слайдов) мы для упрощения создадим с помощью метода <a href="https://developer.mozilla.org/ru/docs/Web/API/URL/createObjectURL">URL.createObjectURL</a> [4], то есть это будут blob-объекты. В реальных условиях здесь должен быть метод, отправляющий файлы на сервер и получающий в ответ url файлов лежащих на сервере. На коде самого компонента слайдера /src/components/Slider/EditorSlider.js не будем останавливаться, так как он является и работает как стандартный react-компонент, в props которого Draft.js передает необходимые данные. Приведу ниже лишь код метода updateData, обновляющего данные кастомного блока и вызывающегося после выхода из режима редактирования слайдов, в котором мы можем удалить, добавить или изменить порядок слайдов:</p><pre>updateData(<em>data</em>) {<br>  const editorState = this.props.blockProps.getEditorState();<br>  const content = editorState.getCurrentContent();<br><br>  const selection = new SelectionState({<br>    anchorKey: this.props.block.key,<br>    anchorOffset: 0,<br>    focusKey: this.props.block.key,<br>    focusOffset: this.props.block.getLength()<br>  });<br><br>  const newContentState = Modifier.mergeBlockData(content, selection, <em>data</em>);<br>  const newEditorState = EditorState.push(editorState, newContentState);<br><br>  setTimeout(() =&gt; this.props.blockProps.setEditorState(newEditorState));<br>}</pre><h3>Шаг 5. Экспорт состояния редактора в html-разметку</h3><p>Естественно, полноценный редактор текстов должен уметь инициализироваться с уже предопределенным контентом, чтобы можно было вернуться к редактированию ранее сохраненного черновика, и генерировать обычную html-разметку, которая будет показываться на пользовательских страницах. Именно экспорт текущего стейта редактора в html-строку мы и разберем в последней части этой публикации.</p><p><a href="https://factorymn.github.io/draftjs-blogpost-demo/markup-export/">Демо-страница</a>, ветка в репозитории — markup-export.</p><p>Что касается инициализации с предопределенным контентом — в Draft.js есть все необходимое для этого уже из коробки. Как упоминалось выше, для этого вместо EditorState.createEmpty, используется метод <a href="https://draftjs.org/docs/api-reference-editor-state.html#createwithcontent">EditorState.createWithContent</a>, в качестве аргументов необходимо передать объект особого формата и, опционально, декоратор. “Объект особого формата” получаем с помощью функции convertToRaw, передав ей на вход текущий ContentState редактора. Увидеть структуру этого объекта можно на demo-странице, открыв консоль и кликнув кнопку “Log state”. Код обработчика клика приведен ниже:</p><pre>this.logState = () =&gt; {<br>  console.log(<br>    &#39;editor state ==&gt; &#39;,<br>    convertToRaw(this.state.editorState.getCurrentContent())<br>  );<br>}</pre><p>С генерацией же html-разметки все не так просто. Дело в том, что в Draft.js из коробки способов решения этой задачи нет. Предполагаю, что связанно это с тем, что в Draft.js допустимо определять кастомные сущности — стили, блоки. Однако, существует масса решений в виде <a href="https://www.npmjs.com/package/draftjs-to-html">отдельных</a> <a href="https://www.npmjs.com/package/draft-js-import-html">модулей</a>. Для нашего случая мы будем использовать <a href="https://www.npmjs.com/package/draft-convert">draft-convert</a>. В файле src/components/DraftEditor/converter.js определяем набор правил, в соответствии с которыми контент нашего редактора будет преобразован в html-строку:</p><pre>import React from &#39;react&#39;;<br>import { convertToHTML } from &#39;draft-convert&#39;;<br><br>export const styleToHTML = (<em>style</em>) =&gt; { // &lt;-- [1]<br>  switch (<em>style</em>) {<br>    case &#39;ITALIC&#39;:<br>      return &lt;<strong>em </strong>className=&quot;italic&quot; /&gt;;<br>    case &#39;BOLD&#39;:<br>      return &lt;<strong>strong </strong>className=&quot;bold&quot; /&gt;;<br>    case &#39;HIGHLIGHT&#39;:<br>      return &lt;<strong>strong </strong>className=&quot;highlight&quot; /&gt;;<br>    default:<br>      return null;<br>  }<br>};<br><br>export const blockToHTML = (<em>block</em>) =&gt; { // &lt;-- [2]<br>  const blockType = <em>block</em>.type;<br><br>  switch (blockType) {<br>    case &#39;SLIDER&#39;: {<br>      const slides = <em>block</em>.data.slides; // &lt;-- [4]<br><br>      return {<br>        start: `&lt;div class=&quot;slider js-slider&quot; data-slides=&quot;${ <em>JSON</em>.stringify(slides).replace(/&quot;/g, &quot;&#39;&quot;)}&quot;&gt;&lt;div&gt;`,<br>        end: `&lt;/div&gt;&lt;/div&gt;`<br>      }<br>    }<br><br>    default: return null;<br>  }<br>};<br><br>export const entityToHTML = (<em>entity</em>, text) =&gt; { // &lt;-- [3]<br>  if (<em>entity</em>.type === &#39;LINK&#39;) {<br>    return (<br>      &lt;<strong>a<br>        </strong>className=&quot;link&quot;<br>        href={<em>entity</em>.data.url}<br>        target=&quot;_blank&quot;<br>      &gt;<br>        {<em>text</em>}<br>      &lt;/<strong>a</strong>&gt;<br>    );<br>  }<br>  return <em>text</em>;<br>};<br>...</pre><p>Необходимо определить три функции: styleToHTML[1], blockToHTML[2] и entityToHTML [3]— их названия говорят сами за себя — каждая из них возвращает фрагмент разметки на основании типа инлайн стилизации, блока или entity. Также прошу обратить внимание, что в функции blockToHTML, определяя разметку для блока SLIDER, мы сохранили данные ассоциированные с блоком в переменную slides[4], преобразовали в JSON-строку и записали в data-атрибут data-slides.</p><pre>...<br>export const options = { // &lt;-- [1]<br>  styleToHTML,<br>  blockToHTML,<br>  entityToHTML,<br>};<br><br>const converterFunction = convertToHTML(options); // &lt;-- [2]<br><br>export default <em>contentState </em>=&gt; converterFunction(<em>contentState</em>);</pre><p>Эти функции используются в конфигурационном объекте[1], который передается в метод convertToHTML, его вызов вернет функцию [2], которая в свою очередь получает первым аргументом contentState редактора и возвращает желаемое — html-строку. В файле DraftEditor.js мы импортируем нужный нам метод и используем его в обработчике клика по кнопке “Export &amp; log markup”:</p><pre>...<br>import converter from &#39;./converter&#39;;<br>...</pre><pre>logMarkup() {<br>  const markup = converter(this.state.editorState.getCurrentContent()); // &lt;-- [1]<br><br>  document.getElementById(&#39;js-markup-container&#39;).innerHTML = markup;<br>  console.log(&#39;markup ==&gt; &#39;, markup); // &lt;-- [2]<br><br>  const sliders = document.querySelectorAll(&#39;.js-slider&#39;);// &lt;-- [3]<br><br>  _forEach(sliders, <em>slider </em>=&gt; {<br>    const description = <em>slider</em>.innerHTML;<br><br>    <em>slider</em>.innerHTML = &#39;&#39;; // eslint-disable-line<br><br>    render(( &lt;-- [4]<br>      &lt;<strong>ContentSlider<br>        </strong>slides={<em>JSON</em>.parse(<em>slider</em>.getAttribute(&#39;data-slides&#39;).replace(/&#39;/g, &#39;&quot;&#39;))}<br>        descriptionHtml={description}<br>      /&gt;<br>    ), <em>slider</em>);<br>  });<br>}</pre><p>Сохраняем строку с html в переменную markup[1], для наглядности добавляем разметку на страницу и выводим в консоль [2]. Так как мы ожидаем увидеть на странице работающий слайдер, потребуется еще немного кода. Как вы помните, определяя разметку для блока SLIDER, мы записали массив с url слайдов в data-атрибут data-slides и присвоили особый класс js-slider, теперь, найдя на страницы все DOM-ноды с этим классом [3], используя стандартный метод render из React.js, мы просто рендерим на месте данной ноды компонент ContentSlider, передавая в его свойства массив url слайдов и текст подписи под слайдером [4]. Сам компонент ContentSlider — это урезанный EditorSlider, из которого удален весь лишний функционал.</p><p>Как итог мы получили текстовый редактор с завершенным базовым функционалом, который вполне можно использовать как основу для более сложного приложения.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ea8e9102aa1" width="1" height="1" alt=""><hr><p><a href="https://medium.com/factorymn/draft-js-%D1%84%D1%80%D0%B5%D0%B9%D0%BC%D0%B2%D0%BE%D1%80%D0%BA-%D0%B4%D0%BB%D1%8F-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D1%8F-%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D1%85-%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%BE%D1%80%D0%BE%D0%B2-%D0%BE%D1%82-facebook-ea8e9102aa1">Draft.js — фреймворк для создания текстовых редакторов от Facebook</a> was originally published in <a href="https://medium.com/factorymn">factorymn</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Growth Hacking Mobile Apps: A Step-by-Step Guide]]></title>
            <link>https://medium.com/factorymn/growth-hacking-mobile-apps-a-step-by-step-guide-4295defb04da?source=rss----45b8e81e35da---4</link>
            <guid isPermaLink="false">https://medium.com/p/4295defb04da</guid>
            <category><![CDATA[startup]]></category>
            <category><![CDATA[retention]]></category>
            <category><![CDATA[growth-hacking]]></category>
            <category><![CDATA[mobile-apps]]></category>
            <category><![CDATA[customer-journey]]></category>
            <dc:creator><![CDATA[Manufactura IT Production & Graphic Design]]></dc:creator>
            <pubDate>Thu, 16 Nov 2017 10:40:10 GMT</pubDate>
            <atom:updated>2018-02-15T07:39:26.479Z</atom:updated>
            <content:encoded><![CDATA[<h4>Three steps to take in 45 minutes</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Vg5QF1QO1WeUcQ5QQx3JJg.jpeg" /></figure><blockquote><em>Sun Tzu, a famous Chinese strategist, said, “The general who wins a battle makes many calculations in his temple before the battle is fought. The general who loses a battle makes but few calculations beforehand. Thus do many calculations lead to victory, and few calculations to defeat; how much more no calculation at all! It is by attention to this point that I can foresee who is likely to win or lose.”</em></blockquote><p><em>The authors of the article — Dmitry Provotorov, the COO and Product Manager in a mobile development company, with 10 years of experience in e-commerce marketing, and Andrey Esaulov, the Head of the prototyping department within a large German media holding and the CTO of a startup project purchased by the holding.</em></p><p>November 2016. We were faced with a question from the company’s senior management: “Should we really invest in development of this mobile app?” To answer the question, we created our own tool, the KPI Calculator.</p><p>It is actually a framework that helps us determine the main points of force application to reach the growth hacking goals. As a result of using it, we not only received the funds for the following year of product development in 2016, but also <a href="http://meinestadt.factory.mn/">successfully launched</a> the app in April 2017.</p><p>We were able to forecast some of the KPIs to the nearest hundredths. Moreover, we “hacked” some of them, <strong>doubling</strong> and even <strong>tripling</strong> the growth, which came as a big surprise to the management.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hkyLnz_QvY00IkbM9qFktQ.jpeg" /></figure><p>In this article, we describe the three simple steps that will allow you to <strong>model your own KPIs in just 45 minutes</strong>. These steps are based on our own extensive experience and insights. We have decided to share our framework with the public so that anyone can download the template and play with numbers: <a href="http://mkpicalc.factorymn.com/">http://mkpicalc.factorymn.com</a></p><h3>Step 1. Create a Monetization Formula</h3><p>First, you need to utilize your math skills (refresh them if they got rusty) and create a formula that will describe how exactly the mobile product contributes to business processes of the company. In most cases, it will be monetary contribution, i.e. revenue.</p><p><strong>In the simplest terms,</strong> the monthly revenue model looks like this:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aFCtzPKVz0YCb37cYEeh1A.jpeg" /><figcaption>Revenue = Visitors × Conversion × Revenue per Conversion</figcaption></figure><p>Where conversion (to action) could be a click on the ad, an order of the product or a subscription.</p><p><strong>For a mass media app</strong> that makes money from adds, the formula would be:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3AOHUpzv6hC0StfFXy2giA.jpeg" /><figcaption>Revenue = Monthly Active Users × Impressions per User × Revenue per Impression</figcaption></figure><p>For an app where a business model is based on the partner <strong>commission from the purchases</strong> that users make inside an app (buying either products — books, clothes, or services — hotels, tickets, etc.), the formula is:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ltV299nueHX9QB0pcrBJZw.jpeg" /><figcaption>Revenue = Monthly Active Users × Conversion × Average Basket Value × Commission</figcaption></figure><p><strong>For an app with a subscription</strong> business model (e.g. online courses or publishing), it is:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7tgFBEu8CyEF9Mfgw7M0Gg.jpeg" /><figcaption>Revenue = (Existing Subscribers + New Subscribers — Unsubscribes) × Monthly Subscription Cost</figcaption></figure><p><strong>The artifact (result) upon finishing the first step </strong>is your revenue formula setting the KPIs that play a vital role for your mobile application. As you can see, it’s not rocket science — all you need is a napkin, a pen and some logic.</p><h3>Step 2. Digitize Potential Growth</h3><p>In the previous step, you defined the KPIs that drive your app’s success. Now you need to understand within what range these KPIs can change and what impact this may have, i.e. how much they influence the overall success? Here again a napkin might do, but basic knowledge of Excel, Google Tables or Numbers would help you to be more effective in your calculations.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UE2OrjTBR19pP4PfRM9LLA.jpeg" /></figure><p>You can start with a simple table consisting of 13 columns: the first one lists all the KPIs, and the rest 12 columns contain their values to be observed on the monthly basis. This way, we can make a forecast for development during the first year of the product lifecycle. If you want to make your predictions even more precise, the amount of rows will increase and the table will become more complex, starting to look like a piece of art or like a “hell of analytics” — depending on your point of view.</p><p>Just do not allow yourself to think, “It’s way too complicated for me”, because you only need to start and you will be amazed, how quickly your simple calculations will become elaborate and precise.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Rnlo6Pc-Tzb5Q3KCI5yDkw.gif" /></figure><p>Now divide your table in two big blocks. In the first one, you will put the prediction of MAUs (Monthly Active Users). Note that most of the growth calculations have MAUs as their cornerstone. MAUs consist of New Installs and Retention (the amount of those users who return into the app from the previous months). The New Installs depend on the amount of users you are able to get organically through the search in stores (Google Play Store, App Store), through the purchased installs and through virality. In the second block, you will have the calculation of revenues which depends on the size of your monthly active audience. You have this formula already.</p><p>You can create your own template for these calculations or apply the ones that one can find in the free access — there are several projects available online. For instance, you can use our <a href="http://mkpicalc.factorymn.com/">mKPI.calc for mobile apps</a>, <a href="http://christophjanz.blogspot.com/2013/04/a-kpi-dashboard-for-early-stage-saas.html">dashboard of Christoph Janz for startup</a> or <a href="https://www.klipfolio.com/resources/kpi-examples/digital-marketing">ideas collection for dashboard creation made by Klipfolio</a>.</p><p>In <a href="http://mkpicalc.factorymn.com/">mKPI.calc</a>, each parameter in the KPI column has a description, recommendations on the range of values and examples for different kinds of products, which could help you a lot at the early stages of planning.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nrhOu9fGHvYn4LJtS2GGzg.gif" /></figure><p>In your table, we advise to highlight the KPIs visually. Their growth (or even “hacking” that would lead to the exponential growth) will be the main goal for your team. Forecast the change of these KPIs from month to month and keep track of how the revenues change accordingly. Your task will be to nurture this growth.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FGxTr803DU5cqC-S9Q_0kg.gif" /></figure><p>Your sources of information could be:</p><ol><li>The data from the analytics packages integrated into your app (if you have one): native analytics of App Store and Google Play, <a href="https://fabric.io/">Fabric</a>, <a href="https://www.localytics.com/">Localytics</a> and others.</li><li>Client’s expert opinion (in case you work for a client) or investor’s expert opinion (in case of a startup).</li><li>Your own experience in other mobile apps as well as other teams’ experience (by collecting the published cases).</li><li>Do not forget about open data providers: <a href="https://www.appannie.com/">AppAnnie</a>, <a href="https://www.statista.com/">Statista</a>, <a href="https://www.similarweb.com/">Similarweb</a> and others.</li></ol><blockquote>What if your predictions do not come true once you start receiving the data?</blockquote><p>First of all — realize that the situation you are in, is much better compared to where you would have been if you had no objective data-driven predictions in the first place. Now you can find the main causes of error and increase your expertise, making your predictions more precise in the future. This, in turn, will help you adjust the growth strategy at the next stage, which in the end will result in your product’s success!</p><p><strong>The artifact upon finishing Step 2</strong> will be the filled-in table with KPIs and the projection of their changes.</p><h3>Step 3. “Play” with your KPIs</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*w0lZIGgf-75UKU_mOPiHQA.gif" /></figure><p>You may have already noticed in the previous step that it is rather difficult to find such a combination of KPIs that shows you a real success. At the same time, you are unlikely to find someone ready to invest in an app that only brings $10,000 of revenue per year. Whereas the number of 1,000,000 could be highly motivating, especially when you know which KPIs you should focus on to reach this order of magnitude.</p><p>Step 3 is there for you not only to find the KPIs that will make your app profitable, but also to think about the strategy of changing things — in case you see that the results turn out to be “average” and thus not very attractive for your team, your client or investor.</p><blockquote>At this stage, you should be very attentive to the insights you have because they will be help you “hack” the system and find the ways to the exponential growth.</blockquote><p>What possible conclusions could you make up while “playing” with KPIs?</p><ol><li>The only way to have the exponential growth in revenues from mobile apps is to create a viral system, i.e. to attract new users.</li><li>You can only reach a high number of MAUs by bringing the product to other markets, countries and languages.</li><li>The focus on retention will increase your revenue by 20%.</li><li>The second platform (iOS and Android) will double your revenue, the third one will triple them, provided you are able to maintain the equivalent number of MAUs for each platform.</li></ol><p><strong>Your final goal</strong> is the understanding of what exactly you should be focusing on during the development of your mobile application. You need to create a product development roadmap to realize which features to include into the MVP and which features to add to the subsequent releases. The roadmap will help you generate feature requests for your architecture, design, development, and testing. It will also be an objective basis for your dialogue with a client or an investor.</p><p><strong>The artifact after finishing Step 3</strong> will be the product development roadmap, which will be based on the revenue formula and its derivatives in the KPIs.</p><h3>Advantages of this approach</h3><ol><li>The fast immersion into a mobile product. After filling out about 15–20 of such tables you will be able to digitize any app idea in approximately 30 minutes, weighing the real opportunities and risks of building this app as a sustainable business model.</li><li>Dispelling the myths that tend to accumulate while nurturing the app idea for a long time. Often, the product that looks perfect in your mind will crash upon the reality of objective KPIs — once you calculate all the options.</li><li>Becoming a numbers geek. After a while, you will see the patterns in the cases you are presented, and your expertise will grow accordingly.</li><li>After mastering this approach and reading a couple of extra books you will be asked where you received your MBA. Even if you didn’t...</li></ol><p>We wish you growth and success!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4295defb04da" width="1" height="1" alt=""><hr><p><a href="https://medium.com/factorymn/growth-hacking-mobile-apps-a-step-by-step-guide-4295defb04da">Growth Hacking Mobile Apps: A Step-by-Step Guide</a> was originally published in <a href="https://medium.com/factorymn">factorymn</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>