О чем предупреждает вас вертикальная разметка: О чем предупреждает Вас вертикальная разметка, нанесенная на ограждение дороги

При создании SmartLayout выберите шаблон для управления количеством создаваемых столбцов: Single , Double или Triple .

Преобразование

Обвязки, секции или действия потоков на основе не интеллектуального макета не могут быть автоматически преобразованы в форму интеллектуального макета. Хотя в некоторых случаях преобразование невозможно, во многих случаях преобразование может занять всего несколько минут.

Чтобы преобразовать существующий смарт-макет, установите флажок «Разрешить изменения в столбце» на панели «Свойства» смарт-макета.

Открыть тему с навигацией

Предупреждение о неизвестной опоре — React

Предупреждение о неизвестной опоре сработает, если вы попытаетесь визуализировать элемент DOM с опорой, которая не распознается React как допустимый атрибут / свойство DOM.Вы должны убедиться, что ваши элементы DOM не имеют плавающих ложных свойств.

Существует несколько вероятных причин появления этого предупреждения:

1. Вы используете {... this.props} или cloneElement (element, this.props) ? Ваш компонент передает свои собственные свойства непосредственно дочернему элементу (например, передает свойства). При передаче свойств дочернему компоненту следует убедиться, что вы случайно не перенаправляете свойства, которые должны быть интерпретированы родительским компонентом.
2. Вы используете нестандартный атрибут DOM на собственном узле DOM, возможно, для представления пользовательских данных. Если вы пытаетесь прикрепить настраиваемые данные к стандартному элементу DOM, рассмотрите возможность использования настраиваемого атрибута данных, как описано в MDN.
3. React еще не распознает указанный вами атрибут. Вероятно, это будет исправлено в будущей версии React. Однако в настоящее время React удаляет все неизвестные атрибуты, поэтому их указание в приложении React не приведет к их рендерингу.
4. Вы используете компонент React без верхнего регистра.React интерпретирует его как тег DOM, потому что преобразование React JSX использует соглашение о верхнем и нижнем регистрах, чтобы различать определяемые пользователем компоненты и теги DOM.

Чтобы исправить это, составные компоненты должны «потреблять» любую опору, которая предназначена для составного компонента и не предназначена для дочернего компонента. Пример:

Плохо: Неожиданный макет prop перенаправляется в тег div .

  function MyDiv (props) {
  если (реквизит.layout === 'horizontal') {
    
    return 

  } еще {
    
    return 

  }
}  

Хорошо: Оператор распространения может использоваться для извлечения переменных из свойств и помещения оставшихся свойств в переменную.

  function MyDiv (props) {
  const {layout, ... rest} = реквизиты
  if (layout === 'horizontal') {
    return 

  } еще {
    return 

  }
}  

Хорошо: Вы также можете назначить реквизиты новому объекту и удалить ключи, которые вы используете, из нового объекта. Убедитесь, что не удалили props из исходного объекта this.props , так как этот объект следует считать неизменяемым.

  function MyDiv (props) {

  const divProps = Object.assign ({}, реквизиты);
  удалить divProps.layout;

  if (props.layout === 'horizontal') {
    return 

  } еще {
    return 

  }
}  

Используя flexdashboard

Обзор

Flexdashboard можно использовать для публикации групп связанных визуализаций данных в виде информационной панели. В макеты flexdashboard можно включить широкий спектр компонентов, в том числе:

1. Интерактивная визуализация данных JavaScript на основе виджетов HTML.

2. R графический вывод, включая базовую, решетчатую и сеточную графику.

3. Табличные данные (с дополнительной сортировкой, фильтрацией и разбиением на страницы).

4. Поля значений для выделения важных сводных данных.

5. Приборы для отображения значений на счетчике в заданном диапазоне.

6. Текстовые аннотации разного типа.

Доступны гибкие варианты компоновки компонентов, а панели мониторинга с множеством компонентов могут быть организованы на несколько страниц. Система макетов flexdashboard также интеллектуально адаптируется для отображения на мобильных устройствах.

Есть также несколько способов добавить интерактивности в flexdashboards. Вы можете использовать htmlwidgets для добавления интерактивности клиентского JavaScript (подсказки по данным, панорамирование, масштабирование и т. Д.) И Shiny для создания полностью настраиваемых взаимодействий в R.

Макет

Ориентация

Макет по столбцу

По умолчанию заголовки уценки уровня 2 ( ------------------ ) на информационных панелях определяют столбцы с отдельными диаграммами, расположенными вертикально в каждом столбце. Вот определение приборной панели с двумя столбцами с одной диаграммой слева и двумя справа:

Макет по строкам

Вы также можете выбрать ориентацию информационных панелей по строкам, а не по столбцам, указав параметр ориентация: строки .Например, этот макет определяет две строки, первая из которых имеет одну диаграмму, а вторая — две диаграммы:

Наборы вкладок

Если у вас есть несколько компонентов, которые вы хотите отобразить в строке или столбце, то вместо того, чтобы пытаться уместить их все на экране одновременно, вы можете разместить их в виде набора вкладок. Это особенно уместно, когда один компонент является основным (т.е. должен быть виден всем читателям), а другие предоставляют вторичную информацию, которая может быть интересна только некоторым читателям.

Во многих случаях наборы вкладок являются лучшим решением, чем vertical_layout: scroll для отображения большого количества компонентов, поскольку по ним так легко перемещаться.

Чтобы разместить строку или столбец в виде набора вкладок, вы просто добавляете атрибут {.tabset} в заголовок раздела. Например, следующий код отображает второй столбец в наборе вкладок:

Строки также можно расположить в виде набора вкладок, как показано здесь:

Обратите внимание, что здесь мы также применяем {.tabset-fade} , который приводит к эффекту постепенного появления / исчезновения при переключении вкладок.

Компоненты

R Графика

Вы можете использовать любую диаграмму, созданную со стандартной графикой R (основание, решетка, сетка и т. Д.), С помощью flexdashboard.

В динамических (блестящих) информационных панелях размер этих диаграмм автоматически изменяется в соответствии с их контейнерами информационных панелей, если они заключены в вызове renderPlot.

В статических панелях мониторинга также масштабируется стандартная графика R (с сохранением соотношений сторон, чтобы не было растяжения или искажения).Однако, поскольку эти диаграммы являются изображениями PNG, они не могут полностью заполнить границы своего контейнера. В следующем разделе приведены советы о том, как добиться наилучшего соответствия заданному графическому изображению.

Масштабирование фигуры

При создании статических (не блестящих) панелей мониторинга, содержащих стандартную графику R, очень важно определить значения knitr fig.width и fig.height как можно ближе к тому, что они фактически будут на странице. Это позволяет им максимально точно вписаться в свой контейнер макета, когда панель мониторинга размещена.

Вот пример макета на основе строк, который включает 3 диаграммы из базовой графики R:

Мы явно указали fig.height и fig.width для каждой диаграммы, чтобы их визуализированный размер максимально соответствовал их гибкому контейнеру. Обратите внимание, что идеальные значения для этих размеров обычно необходимо определять экспериментально.

Табличные данные

Вы можете включить табличные данные в flexdashboards одним из двух способов:

1. В виде простого табличного дисплея.

2. Как DataTable, который включает сортировку, фильтрацию и разбиение на страницы.

Простой стол

Простая таблица идеально подходит для меньшего количества записей (например, 40-50 или меньше). Код, необходимый для простых таблиц, различается в зависимости от того, создаете ли вы статическую или динамическую (основанную на Shiny) гибкую панель управления. Для статических панелей мониторинга следует использовать функцию knitr :: kable для вывода набора данных, например:

Для панелей мониторинга на основе Shiny следует использовать функцию shiny :: renderTable , например:

Это гарантирует, что табличное отображение обновляется при изменении входных данных, от которых оно зависит.

Таблица данных

Пакет DT (интерфейс к библиотеке JavaScript DataTables) может отображать матрицы R или фреймы данных в виде интерактивных таблиц HTML, которые поддерживают фильтрацию, разбиение на страницы и сортировку.

Обратите внимание, что если вы хотите использовать DataTables с flexdashboard, вам следует установить самую последнюю версию DT (v0.2) из ​​CRAN (она содержит некоторые изменения, необходимые для совместимости с flexdashboard):

  инсталляционные пакеты («ДТ»)  

Чтобы включить DataTable, вы используете функцию DT :: datatable :

Обратите внимание, что мы указали опцию bPaginate = FALSE .Это подходит для небольших наборов данных, где прокрутка обеспечивает удобный способ навигации по данным.

Если у вас есть большой набор данных, в котором вы хотите включить разбиение на страницы, вы должны обязательно указать опцию pageLength , чтобы отображать больше, чем 10 строк по умолчанию для вашего набора данных на странице:

Блестящий

Чтобы включить DataTable в Shiny flexdashboard, вы должны обязательно обернуть вывод данных в DT :: renderDataTable (чтобы он обновлялся при вводе, это зависит от изменения).Например:

Мобильный дисплей

На дисплеях настольных компьютеров и планшетов компоненты «Простая таблица» и «Таблица данных» точно помещаются в пределах своего контейнера flexdashboard и предоставляют полосу прокрутки для просмотра записей, которые не помещаются на экране. Однако на мобильных телефонах оба компонента никогда не будут использовать полосу прокрутки (поскольку это будет конкурировать с прокруткой всей панели управления). Вернее, на макетах мобильных телефонов:

1. Простая таблица отобразит все доступные записи; и

2. Таблица данных будет использовать нумерацию страниц (т.е. force bPaginate = TRUE ).

Значения

Иногда вам нужно включить одно или несколько простых значений на панель мониторинга. Вы можете использовать функцию valueBox для отображения отдельных значений вместе с заголовком и необязательным значком. Например, вот три расположенных рядом раздела, каждый из которых отображает одно значение:

Вот код, который использовался для создания этих полей значений:

Функция valueBox вызывается для выдачи значения и указания значка (подробные сведения о доступных значках см. В разделе «Наборы значков» ниже).

Третий фрагмент кода («Спам в день») делает цвет фона поля значений динамическим с помощью параметра color . Доступные цвета: «основной», «информация», «успех», «предупреждение» и «опасность» (по умолчанию — «основной»). Для пользовательских цветов вы также можете указать любой допустимый цвет CSS (например, «#ffffff», «rgb (100,100,100)» и т. Д.).

Связывание

Если valueBox отображает значение, для которого доступны дополнительные сведения на другой странице информационной панели, вы можете включить переход на другую страницу с помощью параметра href .Например, если у вас есть страница с привязкой «#details», вы можете связать с ней поле значения следующим образом:

Наборы иконок

Можно указать значки из трех различных наборов значков:

1. Font Awesome

2. Иониконы

3. Глификоны начальной загрузки

При ссылке на значок следует использовать его полное имя, включая префикс набора значков (например, «fa-github», «ion-social-twitter», «glyphicon-time» и т. Д.).).

Блестящий

Чтобы включить поле значений в Shiny flexdashboard, вам необходимо обернуть вывод поля значений в renderValueBox (чтобы он обновлялся при вводе, зависящем от изменения). Например:

Калибры

Датчики отображают значения на счетчике в указанном диапазоне. Например, вот набор из 3-х датчиков:

Вот код, используемый для создания этих датчиков:

В этом примере следует отметить несколько моментов:

1. Датчик Функция используется для вывода датчика.У него есть три обязательных аргумента: значение , мин. и макс. (это могут быть любые числовые значения).

2. Вы можете указать дополнительный символ , который будет отображаться рядом со значением (в примере «%» используется для обозначения процента).

3. Вы можете указать набор пользовательских цветов секторов , используя функцию gaugeSectors . По умолчанию в качестве цвета шкалы используется цвет «успеха» текущей темы (обычно зеленый).Параметр секторов позволяет вам указать набор из трех диапазонов значений («успех», «предупреждение» и «опасность»), которые вызывают изменение цвета шкалы в зависимости от его значения.

Связывание

Если датчик отображает значение, для которого доступны дополнительные сведения на другой странице информационной панели, вы можете включить переход на другую страницу с помощью параметра href . Например, если у вас есть страница с привязкой «#details», вы можете привязать к ней датчик следующим образом:

Блестящий

Чтобы включить датчик в Shiny flexdashboard, вы должны обязательно обернуть вывод датчика в renderGauge (чтобы он обновлялся при вводе, это зависит от изменения).Например:

Панель навигации

По умолчанию панель навигации flexdashboard включает в себя заголовок документа , автора и дату . Если на панели мониторинга есть несколько страниц, ссылки на различные страницы также включаются в левую часть панели навигации. Вы также можете добавить ссылки на социальные сети и ссылку для просмотра исходного кода панели инструментов. Например:

Кроме того, вы можете настраивать ссылки на панель навигации, используя опцию navbar .Например, следующий код добавляет ссылку «О программе» в левую часть панели навигации:

Элементы панели навигации должны включать в себя поле заголовка или значка (или оба). Вы также должны включить href в качестве цели навигации. Поле align является необязательным (оно может быть «влево» или «вправо», по умолчанию — «вправо»).

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

Социальные ссылки

Вы можете добавить ссылки на социальные сети с помощью опции social .Например, следующая панель управления включает ссылки Twitter и Facebook, а также раскрывающееся меню с более полным списком услуг:

Опция social может включать любое количество следующих сервисов: «facebook», «twitter», «google-plus», «linkedin» и «pinterest». Вы также можете указать «меню», чтобы предоставить раскрывающееся меню общего доступа, которое включает все службы.

Исходный код

Вы можете включить ссылку на исходный код приборной панели, используя опцию source_code .Исходный код может быть встроен в документ ( source_code: embed ) или может быть ссылкой на URL-адрес, по которому исходный код можно найти в Интернете (например, source_code: "https://github.com/user/repo" ). Например, следующая панель управления включает встроенную копию исходного кода, которую можно просмотреть, нажав кнопку «Исходный код» на панели навигации:

Текстовые аннотации

Текстовые разделы

Если вам нужно включить дополнительное повествование или объяснение в вашу панель управления, вы можете сделать это следующими способами:

1. Вы можете включить содержимое вверху страницы до того, как будут представлены разделы панели мониторинга.

2. Вы можете определить разделы панели мониторинга, которые не включают диаграмму, а содержат произвольное содержимое (текст, изображения, уравнения и т. Д.).

Например, следующая панель мониторинга включает некоторое содержимое вверху и раздел панели, содержащий только текст:

Название и примечания

Каждый компонент на панели управления включает необязательные разделы заголовка и примечаний. Заголовок — это просто текст после заголовка раздела уровня 3 ( ### ).Примечания — это любой текст с префиксом > после фрагмента кода, который обеспечивает вывод компонента. Например:

Вы можете полностью исключить заголовок, применив атрибут .no-title к заголовку раздела, например:

Калибр

Чтобы создать идеальный макет панели мониторинга, важно понимать, как определяется размер отдельных диаграмм. В этом разделе описывается алгоритм макета и различные способы настройки его поведения.

Ширина и высота

Ширина диаграмм в flexdashboard в конечном итоге определяется шириной браузера. Если ваш макет состоит из одного столбца, диаграммы будут занимать всю ширину окна браузера. Если ваш макет имеет несколько столбцов, тогда столбцы будут равномерно разделять доступную ширину (если не переопределено с помощью атрибута data-width , как описано ниже).

Высота диаграмм определяется одним из двух способов в зависимости от того, настроена ли ваша информационная панель так, чтобы она вписывалась в вертикальные границы страницы ( vertical_layout: fill ) или для прокрутки ( vertical_layout: scroll ):

1. Для панелей мониторинга, заполняющих страницу, высота диаграмм будет определяться высотой окна браузера, а вертикально расположенные диаграммы равномерно разделяют доступную высоту (если это не переопределено с помощью атрибута data-height , как описано ниже).

2. Для прокручиваемых информационных панелей высота диаграмм будет определяться опцией knitr fig.height , которая по умолчанию составляет 5 дюймов (480 пикселей).

Атрибуты размера

Характер диаграмм на панели инструментов (желаемый акцент, типы визуализации и т. Д.) Часто диктует, что вы захотите изменить поведение размера по умолчанию. Если атрибуты размера не указаны, то относительный размер каждой таблицы будет определяться размером фигурки вязальщицы (это 6 x 4.8 дюймов или 576 x 460 пикселей по умолчанию).

Вы можете изменить размер по умолчанию, применив атрибуты data-width и data-height к строкам, столбцам или даже отдельным диаграммам. Эти атрибуты устанавливают относительный размер диаграмм, расположенных в одном измерении (горизонтальном или вертикальном).

Примеры

В этом примере используется атрибут data-height , чтобы указать больший размер по вертикали для первой строки, что приводит к макету, который более четко выделяет первую диаграмму.

Этот пример представляет собой вариант макета с одним столбцом, показанный выше, с атрибутом data-height , примененным к первой диаграмме:

Заполнение диаграммы

По умолчанию flexdashboard размещает 8 пикселей отступа по краям диаграмм. Для некоторых типов диаграмм это может быть не идеально. В этом случае вы можете либо добавить атрибут .no-padding , чтобы указать полное отсутствие заполнения, либо атрибут data-padding , чтобы указать определенное количество пикселей.Например:

Макет Flexbox

выполняется с помощью движка Flexbox браузера, который изменяет ширину и / или высоту своих элементов, чтобы лучше всего заполнить доступное пространство на любом устройстве отображения. Макет flexbox расширяет элементы, чтобы заполнить доступное свободное пространство, или сжимает их, чтобы предотвратить переполнение.

Смысл этого заключается в том, что размеры диаграммы, установленные либо с помощью размеров фигурок knitr, либо атрибутов data-width и data-height , используются для установления относительных размеров между диаграммами в пределах одного и того же горизонтального или вертикального измерения, в отличие от абсолютных размеров (это соответствует свойствам CSS flex-grow и flex-shrink ).

Несколько страниц

Если у вас есть несколько диаграмм, которые вы хотите включить в сводную панель, вы можете разделить ее на несколько страниц. Чтобы определить страницу, просто используйте заголовок уценки 1 уровня ( ================== ). Каждая определяемая вами страница будет иметь свою собственную вкладку навигации верхнего уровня.

Например, этот код создает информационную панель с двумя страницами, каждая из которых содержит две диаграммы:

Ориентация страницы

Обратите внимание, что в этом примере обе страницы используют ориентацию «столбцы» по умолчанию.Однако можно указать отдельную ориентацию для отдельной страницы. Это делается путем добавления атрибута ориентации данных в заголовок страницы, ориентацию которой вы хотите изменить. Например:

Навигация по страницам

По умолчанию каждой странице, которую вы определяете, предоставляется собственная вкладка верхнего уровня на панели навигации. Однако, если у вас большое количество страниц (более 5), вы можете захотеть организовать свои страницы в меню на панели навигации.

Чтобы указать, что страница должна быть доступна через меню панели навигации, вы используете атрибут data-navmenu .Например, следующая панель управления имеет 4 страницы, 2 из которых расположены в «Меню A», а две из которых расположены в «Меню B»:

Ссылки на страницы

Вы можете формировать ссылки прямо на страницы панели инструментов, используя синтаксис ссылок уценки: [Страница 2] . Чтобы использовать собственный текст ссылки, вы также можете создать ссылку через привязку страницы: [Page Two] (# page-2) . Оба стиля ссылок на страницы демонстрируются в этом примере:

Скрытие страниц

Типичным средством навигации между страницами является глобальная панель навигации, как описано выше.Однако, если вы уже предоставили заметные навигационные ссылки на страницы, вы можете полностью исключить их из панели навигации. Этого можно добиться, добавив атрибут {.hidden} к странице, которую вы хотите скрыть с панели навигации. Например:

Значки страниц

Вы можете добавить значок в меню навигации для страницы с помощью атрибута data-icon . Например, следующее указывает значок панели навигации для каждой из двух страниц:

Вы можете указать значки для элементов панели навигации из трех различных наборов значков:

1. Font Awesome

2. Иониконы

3. Глификоны начальной загрузки

При обращении к значку следует использовать его полное имя, включая префикс набора значков (например,грамм. «Fa-github», «ion-social-twitter», «glyphicon-time» и т. Д.).

Раскадровки

Раскадровки — это альтернатива схемам компоновки на основе строк и столбцов, описанным выше, которые хорошо подходят для представления последовательности визуализаций данных и связанных комментариев.

Основы раскадровки

Чтобы создать макет раскадровки, выполните следующие действия:

1. Добавьте опцию раскадровки : true на панель инструментов.

2. Включает набор компонентов информационной панели уровня 3 ( ### ).Каждому компоненту будет назначен отдельный фрейм в раскадровке, а заголовок раздела будет использоваться в качестве заголовка навигации.

Основы создания раскадровки описаны ниже. Более полный пример см. В раскадровке HTML Widgets Showcase.

Следующий код создает раскадровку с 3 кадрами:

Обратите внимание, что заголовки разделов уровня 3 (например, «Кадр 1») будут использоваться в качестве заголовков навигации. Эти подписи должны содержать краткое изложение кадра из одного или двух предложений, поэтому обычно они длиннее, чем показано здесь.

Раскадровка

Вы можете разместить одну или несколько страниц панели мониторинга как раскадровки, а затем использовать традиционную разметку строк и столбцов на других страницах. Для этого вы исключаете опцию storyboard: true и вместо этого добавляете класс {.storyboard} к страницам, которые вы хотите разложить как раскадровки.

Например, следующая информационная панель включает раскадровку на первой странице («Анализ»), а также другую страницу («Подробности»), которая использует обычную компоновку:

Мобильный макет

Система макетов flexdashboard интеллектуально адаптируется для отображения на мобильных устройствах.В этом разделе описывается поведение макета для экранов различных размеров, а также некоторые рекомендации по обеспечению правильной работы панелей мониторинга на экранах меньшего размера.

Средние экраны

Компоновка компонентов приборной панели для мобильных экранов среднего размера (например, планшетов) такая же, как и для больших экранов настольных компьютеров (любой экран с шириной более 768 пикселей считается средним экраном).

Строки и столбцы распределяются с использованием размеров рисунков по умолчанию и с учетом относительных пропорций, установленных с помощью атрибутов ширины данных .Единственным исключением являются боковые панели, ширина которых уменьшается до 220 пикселей, если ширина экрана меньше 993 пикселей.

Маленькие экраны

Для мобильных телефонов (любой экран шириной менее 768 пикселей) flexdashboard использует специальное поведение макета. Поскольку эти экраны обычно не имеют ширины для отображения нескольких столбцов, расположенных бок о бок, все компоненты панели мониторинга «сглаживаются» в один макет с одним столбцом.

Кроме того, некоторые компоненты гибкой панели управления имеют особое поведение, позволяющее адаптироваться к небольшим мобильным экранам:

1. По умолчанию графика R визуализируется дважды, один раз в естественном виде. рис.ширина и рис. высота , а также размер, оптимизированный для мобильных устройств (3,75 x 4,8 дюйма). При отображении на мобильном телефоне в портретной ориентации используется мобильный размер (этим можно управлять с помощью опции fig_mobile ).

2. В простых таблицах всегда отображаются все свои строки (это делается для того, чтобы прокрутка таблицы не мешала прокрутке мобильного дисплея).

3. DataTables всегда использует разбиение на страницы (опять же, чтобы прокрутка DataTable не мешала прокрутке всего экрана).

Мобильный CSS

Если определенные компоненты вашей панели инструментов не работают на небольших мобильных устройствах, вы можете исключить их, применив атрибут класса {.no-mobile} к разделу панели инструментов. Например, на этой панели инструментов на мобильных устройствах скрывается второй компонент:

Также возможно создать версию для мобильных устройств данного компонента панели мониторинга, которая будет использоваться вместо версии по умолчанию. Вы можете сделать это, создав два раздела с одинаковыми названиями и применив {.mobile} атрибут класса к одному из них. Например:

Внешний вид

шаблоны

Для изменения базового внешнего вида flexdashboard доступны различные темы. Доступные темы:

• по умолчанию
• космо
• бутстрап
• лазурный
• журнал
• ровно
• читаемый
• spacelab
• объединенный
• люмен
• бумага
• песчаник
• одностороннее
• йети

Тема «космо» используется, когда указано «по умолчанию».Все эти темы основаны на темах, доступных в пакете R Markdown (которые, в свою очередь, основаны на темах Bootswatch).

Используйте параметр тема , чтобы указать альтернативную тему:

Если вы ищете тему, которая хорошо встраивается в другой фрейм контента (например, не использует такой яркий цвет для панели навигации), то тема «начальной загрузки» — хороший выбор.

Стили CSS

Вы можете настроить различные стили CSS, используемые в flexdashboard, включив таблицу стилей с помощью параметра css .Например:

Обратите внимание, что базовые стили CSS определены как в активной теме Bootswatch, так и в конкретных таблицах стилей flexdashboard, которые можно найти здесь: https://github.com/rstudio/flexdashboard/tree/feature/logo-and-favicon/inst/rmarkdown / templates / flex_dashboard / resources

Цвета панели навигации

Вы можете использовать CSS для настройки цветов, используемых на панели навигации каждой темы. Если вы это сделаете, помните, что темы определяют цвета для многих элементов и состояний, поэтому вам следует быть осторожным, чтобы переопределить все необходимые элементы.

Панель навигации для flexdashboard использует класс navbar-inverse для каждой из своих тем. Вот navabar-inverse CSS для темы «cosmo» по умолчанию, используемой flexdashboard:

https://github.com/thomaspark/bootswatch/blob/v3.3.5/cosmo/bootstrap.css#L4643-L4744

Если вы хотите настроить эти цвета, вы должны создать таблицу стилей CSS с необходимыми записями navbar-inverse и включить ее, используя опцию css формата flex_dashboard .

Логотип и значок

Вы можете указать изображение логотипа и / или значка для своей панели инструментов, используя параметры logo и favicon соответственно. Например:

Логотип будет размещен в крайнем левом углу панели навигации приборной панели. Изображение логотипа не масштабируется, поэтому оно должно точно соответствовать размерам панели навигации (48 пикселей в высоту для темы «космо» по умолчанию, другие темы могут иметь немного другую высоту панели навигации).

Узнать больше

На странице Shiny описывается, как создавать информационные панели, которые позволяют зрителям изменять базовые параметры и сразу же видеть результаты или обновлять себя постепенно по мере изменения базовых данных.

Страница Макеты включает в себя множество примеров макетов, которые вы можете использовать в качестве отправной точки для ваших собственных информационных панелей.

На странице «Примеры» есть несколько примеров работы flexdashboard (включая ссылки на исходный код, если вы хотите разобраться, как был создан каждый пример).

UIStackView: извлеченные уроки. UIStackView — очень мощный макет… | Радим Халфар | INLOOPX

Удалить упорядоченный подвид

Вставить упорядоченный подвид в UIStackView легко. Вы даже можете вставить упорядоченное подвид в определенную позицию. Круто, а как насчет удаления вида ?! Многие из вас теперь могут задаться вопросом, читал ли он документацию ?! Да. Однако почему API UIStackView не является интуитивно понятным в обоих направлениях?

Приведенный выше фрагмент создает экземпляр UIStackView и добавляет в него упорядоченное подвид.Однако это еще не все, что он делает. Фактически, функция addArrangedSubview вызывает addSubview ! Это означает, что представление хранится не только как подвид connectedSubview , но также как подвид !

Это было бы хорошо, если бы при вызове removeArrangedSubview представление не оставалось в подпредставлениях UIStackView. Это в основном означает, что вам нужно впоследствии вызвать removeFromSuperview или просто написать расширение.

Нарушение ограничений 🤕

Иногда вы можете увидеть предупреждение о невыполнимых ограничениях. Вам следует возиться с этим только потому, что это может замедлить фазу рендеринга представления.

Невозможно одновременно удовлетворить ограничения. Возможно, по крайней мере, одно из ограничений в следующем списке вам не нужно.

Трудно понять, какие ограничения нарушаются, особенно в UIStackView. Есть отличный онлайн-инструмент под названием WTFAutolayout .Просто вставьте содержимое между загнутыми скобками, и оно кратко изложит вам проблемы.

Как правило, если у вас возникают проблемы с автоматической компоновкой и UIStackView, установите для вертикальных и горизонтальных ограничений более низкий приоритет. Это зависит от того, какую ось UIStackView вы используете. Если по горизонтали, вам необходимо обновить начальный и конечный приоритет ограничений ваших упорядоченных подпредставлений. Если вертикально, вам необходимо обновить приоритет верхних и нижних ограничений ваших упорядоченных подпредставлений. 999 достаточно и позволит UIStackView работать без сбоев. Что UIStackView делает за кулисами, так это то, что он добавляет 1000 ограничений приоритета к своим упорядоченным подпредставлениям. Пойдите и проверьте отладчик представления, и вы увидите причину нарушения ваших допустимых ограничений.

UIStackView + UITableView

Надежный UIStackView + UITableView
Вы упростите свой макет в IB, если у вас есть статическое содержимое в ячейке представления таблицы и вам не нужно динамически добавлять или удалять какие-либо элементы пользовательского интерфейса из представления стека.

Динамическое содержимое UIStackView в UITableView
Если вы когда-либо думали, что было бы неплохо использовать UIStackView в своем самоустанавливающемся UITableViewCell с динамическим содержимым, то вы должны просто забыть об этом!

Первоначальная идея заключалась в том, чтобы поместить его внутри ячейки, чтобы легко вставлять в нее содержимое. Действительно, если бы требовалась какая-то анимация, было бы довольно легко анимировать вставку или удаление. Как я ошибался…

Известные проблемы

1. Отставание при рендеринге разнообразного содержимого с разными размерами
   Возможное лечение : Вычислить высоту ячейки вручную
2. Необходимо очистить в программе prepareForReuse (_: )
3. Анимация раздражает, запрашивая layoutIfNeeded () в UIStackView или вызывая beginUpdates (), endUpdates () в UITableView при (не) скрытии представления непосредственно перед вызовом
4. The (un) hide должен быть помещен в блок анимации, чтобы анимация была красивой и плавной. снизу до более низкого приоритета. 999 вполне достаточно.

Другая проблема, с которой вы могли столкнуться при использовании UIStackView, — это использование его с комбинацией UIScrollView.

Рассмотрим ситуацию, показанную на изображении. Ваш макет состоит из UIScrollView, в который встроен UIStackView. Вы используете в своем коде автоматическое размещение, и представление стека связано ограничениями с его супервизором. Конструктор интерфейса теперь жалуется на размер содержимого UIScrollView, что довольно неудобно, если вы хотите вставлять элементы в UIStackView во время выполнения приложения.Если вы измените нижнее ограничение на большее или равное, это не поможет. У вас есть два варианта в зависимости от варианта использования.

Добавление упорядоченных подвидов в Interface Builder
В этой настройке вы можете легко добавить упорядоченные подвиды в построителе интерфейса. Однако в этой настройке, если вы добавляете какое-либо упорядоченное подпредставление в представление стека, оно заполняет весь экран, что нежелательно. Пришло время удалить ограничение по центру по вертикали в контейнере UIStackView. Он работает как чудо. , если у вас есть хотя бы одно представление, добавленное в представление стека в IB .

Добавление упорядоченных подпредставлений в код 🤞
Если вам нужно использовать настройку динамического макета, с этими проблемами вы можете столкнуться.

1. UIScrollView требует ограничения для положения x / y
2. Добавить упорядоченное подпредставление с высотой 0
3. Игнорировать ограничения и добавлять его во время выполнения
4. Вы можете (не) игнорировать предупреждения в построителе интерфейса

Правильный способ установить UIScrollView, включая UIStackView, — использовать вариант №1.

# 1 UIScrollView требует ограничения для положения x / y
Установите ширину UIStackView, равную представлению UIViewController. Также добавьте ограничение высоты в UIStackView, помеченное как , удаленное во время сборки .

# 2 Добавить упорядоченное подпредставление с высотой 0
Чтобы удовлетворить запрос на допустимый размер содержимого UIScrollView, вы можете добавить представление заполнителя, высота которого должна быть установлена ​​на 0. Это устранит ошибки в Конструктор интерфейсов.

Сводка известных проблем:

• Недопустимый размер содержимого UIScrollView, так как он должен быть пустым и иметь размер {0, 0}, включая упорядоченный подпредставление
• Если задан интервал, упорядоченное подпредставление по высоте 0 вызывает проблемы

Возможное решение:

• Удалите представление заполнителя во время выполнения перед добавлением любых представлений. (Для этого требуется шаблонный код, который можно опустить с решением # 1 ❗)

# 3 Игнорировать ограничения
Вы можете решить проигнорировать ограничения или просто решите не работать с IB.В этом случае вам нужно создать свои ограничения в коде, который содержит много шаблонного кода, который может быть выполнен в IB. Однако, если вы привыкли к этому, сохраняйте последовательное решение и продолжайте. Перед настройкой представления вы добавляете любое упорядоченное подвид в UIStackView, а затем вам нужно установить ограничения и закрепить UIStackView в UIScrollView.