nested_array 2.4.0 → 3.0.1

data/README-ru.md

@@ -1,287 +1,557 @@
-# NestedArray
+# nested_array
 
-Предназначен для преобразования в древовидную структуру плоских данных описанных
-по паттерну «Список смежности» (Adjacency List), то есть в нодах указа предок
-`parent_id`. Например:
+🎉 Мои поздравления! Вышла версия 3.0.
+
+Гем `nested_array` позволяет преобразовать плоский массив данных древовидной
+структуры во вложенный массив, а так же помогает отобразить деревья формируя
+HTML вёрстку или псевдографику.
+
+Древовидная структура должна быть описана по шаблону Списка смежности
+(Adjacency List), то есть в каждом узле указан предок.
+
+__Выбрать язык README.md__
+
+-   en [English](README.md)
+-   ru [Русский](README-ru.md)
+
+
+
+
+## <a id="Оглавление"></a>Оглавление
+-   [Установка](#1)
+-   [Использование](#2)
+    -   [Преобразование данных методом `.to_nested`](#2.1)
+        -   [Исходные данные – массив хэш](#2.1.1)
+        -   [Исходные данные – массив ActiveRecord](#2.1.2)
+        -   [Опции метода `.to_nested`](#2.1.3)
+            -   [`root_id: id`](#2.1.3.1)
+            -   [`branch_id: id`](#2.1.3.2)
+    -   [Отображение древовидных структур](#2.2)
+        -   [В виде многоуровневых списков](#2.2.1)
+            -   [Маркированный и нумерованный списки `<ul>`, `<ol>`](#2.2.1.1)
+            -   [Использование собственных шаблонов для отображения списка](#2.2.1.2)
+            -   [Изменение шаблона в зависимости от данных узла](#2.2.1.3)
+            -   [Расскрывающийся список на основе тега `<details></details>`](#2.2.1.4)
+            -   [Формирование и вывод собственных шаблонов опираясь на изменение уровня узла `node.level`](#2.2.1.5)
+        -   [В виде псевдографики](#2.2.2)
+            -   [Добавление псевдографики перед именем модели методом `nested_to_options`](#2.2.2.1)
+            -   [Тонкая псевдографика](#2.2.2.2)
+            -   [Собственная псевдографика](#2.2.2.3)
+            -   [Увеличение отступа в собственной псевдографике](#2.2.2.4)
+        -   [В формах](#2.2.3)
+            -   [С хелпером `form.select`](#2.2.3.1)
+            -   [С хелперами `form.select` и `options_for_select`](#2.2.3.2)
+            -   [Раскрывающийся список с переключателями `form.radio_button`](#2.2.3.3)
+
+
+
+
+## <a id="1"></a>Установка [↑](#Оглавление "К оглавлению")
+
+1. Добавте строку в файл _Gemfile_ вашего приложения:
 
 ```ruby
-[
-  {id: 1, parent_id: nil, name: 'first', …},
-  {id: 2, parent_id:   1, name: 'second', …},
-  {id: 3, parent_id:   1, name: 'third', …}
-]
-# ↓ ↓ ↓
-[
-  {id: 1, parent_id: nil, name: 'first', children: [
-    {id: 2, parent_id:   1, name: 'second', …},
-    {id: 3, parent_id:   1, name: 'third', …}
-  ], …}
-]
+# Работа с древовидными массивами
+gem "nested_array", "~> 3.0"
 ```
 
+И выполните `bundle install`.
 
+2. Если вы планируете использовать скромные CSS стили гема, добавте в
+файл _app/assets/stylesheets/application.scss_:
 
+```css
+/* Отображение древовидных массивов */
+@import "nested_array";
+```
 
-## Установка
 
-Добавте строку в _Gemfile_ вашего приложения:
 
-```ruby
-# Версия не расширяет базовый класс Array методами гема. Для использования необходимо преобразовать данные к новому типу, см ниже.
 
-# Работа с древовидными массивами.
-gem 'nested_array', '~> 1.0.0'
+## <a id="2"></a>Использование [↑](#Оглавление "К оглавлению")
+
+### <a id="2.1"></a>Преобразование данных методом `.to_nested` [↑](#Оглавление "К оглавлению")
+
+#### <a id="2.1.1"></a>Исходные данные – массив хэш [↑](#Оглавление "К оглавлению")
 
-# Версия с автоматическим расширением базового класса Array методами гема.
+Допустим, есть массив хэш:
 
-# Работа с древовидными массивами.
-gem "nested_array", "~> 2.0.0"
+```rb
+flat = [
+  {'id' => 3, 'parent_id' => nil},
+  {'id' => 2, 'parent_id' => 1},
+  {'id' => 1, 'parent_id' => nil}
+]
 ```
 
-И затем выполните `bundle install`.
+Где каждый хэш это узел дерева, `id` — идентификатор узла,
+`parent_id` — указатель на родительский узел.
 
-Или установите его как `gem install nested_array`
+Необходимо преобразовать в массив в котором будут только корневые узлы
+(`'parent_id' => nil`), а дочерние узлы помещены в поле
+`children`.
 
+```rb
+nested = flat.to_nested
+puts nested.pretty_inspect
+```
 
+Выведет:
 
+```
+[#<OpenStruct id=3, parent_id=nil, level=0, origin={"id"=>3, "parent_id"=>nil}>,
+ #<OpenStruct id=1, parent_id=nil, level=0, children=[#<OpenStruct id=2, parent_id=1, level=1, origin={"id"=>2, "parent_id"=>1}>], origin={"id"=>1, "parent_id"=>nil}>]
+```
 
-## Использование
+В результате узлы представляют собой объекты `OpenStruct` у которых
+исходные поля `id`, `parent_id` и дополнительные поля
+`level`, `origin` и `children`.
 
-<a name="methods"></a>
-__Список методов__
+В качестве исходных узлов могут быть и объекты ActiveRecord.
 
-* [to_nested](#to_nested) — преобразует плоскую структуру во вложенную;
-* [each_nested](#each_nested) — перебирает вложенную стуктуру;
-* [each_nested!](#each_nested) — перебирает вложенную стуктуру, предоставляя доступ к исходным данным;
-* [nested_to_html](#nested_to_html) — преобразует вложенную структуру в html вёрстку (многоуровневый список `<ul><li>…`);
-* [nested_to_options](#nested_to_options) — преобразует вложенную структуру в массив для формирования опций html-тега `<select>` с псевдографикой;
-* [nested_to_collection_select](#nested_to_collection_select) — преобразует вложенную структуру в плоскую но добавляет псевдографику в тектовое поле для формирования тэга `<select>`;
-* [concat_nested](#concat_nested) — скеивание вложенных структур, ноды склеиваются если путь к ним одинаков.
 
 
 
+#### <a id="2.1.2"></a>Исходные данные – массив ActiveRecord [↑](#Оглавление "К оглавлению")
 
-<a name="to_nested"></a>
-### to_nested [↑](#methods "К методам")
+```rb
+catalogs = Catalog.all.to_a
+nested = catalogs.to_nested
+puts nested.pretty_inspect
+```
 
-Преобразует плоскую структуру во вложенную.
+Выведет:
 
-```ruby
-a = [{'id' => 1, 'parent_id' => nil}]
-a = NestedArray::Array.new a
-b = a.to_nested
+```
+[
+  #<OpenStruct id=1, parent_id=nil, level=0, origin=#<Catalog id: 1, name: "Computer Components", parent_id: nil>, children=[
+    #<OpenStruct id=11, parent_id=1, level=1, origin=#<Catalog id: 11, name: "External Components", parent_id: 1>, children=[
+      #<OpenStruct id=111, parent_id=11, level=2, origin=#<Catalog id: 111, name: "Hard Drives", parent_id: 11>>,
+      #<OpenStruct id=112, parent_id=11, level=2, origin=#<Catalog id: 112, name: "Sound Cards", parent_id: 11>>,
+      #<OpenStruct id=113, parent_id=11, level=2, origin=#<Catalog id: 113, name: "KVM Switches", parent_id: 11>>,
+      #<OpenStruct id=114, parent_id=11, level=2, origin=#<Catalog id: 114, name: "Optical Drives", parent_id: 11>>
+    ]>,
+    #<OpenStruct id=12, parent_id=1, level=1, origin=#<Catalog id: 12, name: "Internal Components", parent_id: 1>>
+  ]>,
+  #<OpenStruct id=2, parent_id=nil, level=0, origin=#<Catalog id: 2, name: "Monitors", parent_id: nil>>,
+  #<OpenStruct id=3, parent_id=nil, level=0, origin=#<Catalog id: 3, name: "Servers", parent_id: nil>>,
+  #<OpenStruct id=4, parent_id=nil, level=0, origin=#<Catalog id: 4, name: "Networking Products", parent_id: nil>>
+]
 ```
 
-__Опции__
+<sub>Метод `.to_nested` использует метод `object.serializable_hash`, чтобы получить список полей объекта.</sub>
 
-У каждой ноды вложенной структуры есть базовые свойства, такие как
-идентификатор, идентификатор предка и другие. Для доступа к этим данным
-используются ключи, которые можно настроить как в примере ниже. По умолчанию
-используются следующие __строковые__ (_чувствительны к string/symbol_) ключи:
 
-```ruby
-b = a.to_nested({
-  id: 'id',               # указывает какое свойство ноды является идентификатором;
-  parent_id: 'parent_id', # -//- предком;
-  children: 'children',   # -//- массивом потомков;
-  level: 'level'          # -//- дополнительным свойством с уровнем вложенности;
-  root_id: nil            # определяет что является корнем для построения дерева,
-                          # например, для построения ветви корнем корнем
-                          # является идентификатор одной из нод.
-})
-```
 
-Дополнительные опции преобразования:
 
-```ruby
-b = a.to_nested({
-  hashed: false,    # потомки могут храниться не в массиве а в хэше;
-  add_level: false, # добавляет в ноду информацию о уровене вложенности ноды;
-})
+#### <a id="2.1.3"></a>Опции метода `.to_nested` [↑](#Оглавление "К оглавлению")
+
+##### <a id="2.1.3.1"></a>`root_id: id` [↑](#Оглавление "К оглавлению")
+
+`root_id: 1` — взять потомков узла с `id` равным `1`.
+
+```erb
+<% catalogs_of_1 = Catalog.all.to_a.to_nested(root_id: 1) %>
+<ul>
+  <% catalogs_of_1.each_nested do |node, origin| %>
+    <%= node.before -%>
+    <%= origin.name -%> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.after -%>
+  <% end %>
+</ul>
 ```
 
+Выведет многоуровневый маркированный список потомков узла №1:
 
+![Screenshot](doc/images/2.1.3.1.png)
 
 
-<a name="each_nested"></a>
-### each_nested [↑](#methods "К методам")
 
-Перебирает вложенную стуктуру.
 
-```ruby
-nested.each_nested do |node, parents, level, is_last_children|
-  puts node             # > {'id' => ...}
-  puts parents          # > [{'id' => ...}]
-  puts level            # > 0
-  puts is_last_children # > false
-end
+##### <a id="2.1.3.2"></a>`branch_id: id` [↑](#Оглавление "К оглавлению")
+
+`branch_id: 1` — взять узел с `id` равным `1` и всех его потомков.
+
+```erb
+<% catalogs_from_1 = Catalog.all.to_a.to_nested(branch_id: 1) %>
+<ul>
+  <% catalogs_from_1.each_nested do |node, origin| %>
+    <%= node.before -%>
+    <%= origin.name -%> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.after -%>
+  <% end %>
+</ul>
 ```
 
+Выведет узел №1 и его потомков:
 
+![Screenshot](doc/images/2.1.3.2.png)
 
 
-<a name="nested_to_html"></a>
-### nested_to_html [↑](#methods "К методам")
+### <a id="2.2"></a>Отображение древовидных структур [↑](#Оглавление "К оглавлению")
 
-Формирует _html_-код для вывода вложенных структур с использованием вложенных друг в друга списков `<ul>`.
+#### <a id="2.2.1"></a>В виде многоуровневых списков [↑](#Оглавление "К оглавлению")
 
-__Пример__
+##### <a id="2.2.1.1"></a>Маркированный и нумерованный списки `<ul>`, `<ol>` [↑](#Оглавление "К оглавлению")
 
-```ruby
-[
-  {'id' => 1, 'parent_id' => nil, 'name' => 'first'},
-  {'id' => 2, 'parent_id' =>   1, 'name' => 'second'},
-  {'id' => 3, 'parent_id' =>   1, 'name' => 'third'}
-].to_nested.nested_to_html do |node|
-  node['name']
-end
+```erb
+<ul>
+  <% @catalogs.to_a.to_nested.each_nested do |node, origin| %>
+    <%= node.before %>
+    <%= link_to origin.name, origin %> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.after %>
+  <% end %>
+</ul>
+
+<ol>
+  <% @catalogs.to_a.to_nested.each_nested ul: '<ol>', _ul: '</ol>' do |node, origin| %>
+    <%= node.before %>
+    <%= link_to origin.name, origin %> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.after %>
+  <% end %>
+</ol>
 ```
 
-Вернёт
+![Screenshot](doc/images/2.2.1.1.png)
+
+
 
-```html
-	<li>first
-		<ul>
-			<li>second</li>
-			<li>third</li>
-		</ul>
-	</li>
+
+##### <a id="2.2.1.2"></a>Использование собственных шаблонов для отображения списка [↑](#Оглавление "К оглавлению")
+
+Вместо `<ul><li>`/`<ol><li>`
+
+```erb
+<% content_for :head do %>
+  <style>
+    /* Вертикальные отступы узла */
+    div.li { margin: .5em 0; }
+    /* Отступ уровней (children) */
+    div.ul { margin-left: 2em; }
+  </style>
+<% end %>
+
+<div class="ul">
+  <%# Переопределение открывающих и закрывающих тегов шаблонов. %>
+  <% @catalogs.to_a.to_nested.each_nested(
+    ul: '<div class="ul">',
+    _ul: '</div>',
+    li: '<div class="li">',
+    _li: '</div>'
+  ) do |node, origin| %>
+    <%= node.before -%>
+    <%= origin.name -%> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.after -%>
+  <% end %>
+</div>
 ```
 
-__Расширенный пример__
+![Screenshot](doc/images/2.2.1.2.png)
 
-```ruby
-.nested_to_html li: '<li class="my">', _ul: '<i></i></ul>' do |node, parents, level|
-  block_options = {}
-  block_options[:li] = '<li class="my current">' if node['id'] == 2
-  [
-  	"id: #{node['id']}, #{node['name']}, parent name: #{parents[level]&.[]('name')}",
-  	block_options
-  ]
-end
+
+
+
+
+##### <a id="2.2.1.3"></a>Изменение шаблона в зависимости от данных узла [↑](#Оглавление "К оглавлению")
+
+Для изменения шаблонов вывода в зависимости от данных узла мы можем проверять
+поля узла `node.li` и `node.ul`. Если поля не пустые, то вместо вывода их
+содержимого подставлять собственный динамичный html.
+
+Вывод имеющихся шаблонов узла (`node.li`, `node.ul` и `node._`):
+
+```erb
+<ul>
+  <% @catalogs.to_a.to_nested.each_nested do |node, origin| %>
+    <%= node.li -%>
+    <%= origin.name -%> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.ul -%>
+    <%= node._ -%>
+  <% end %>
+</ul>
 ```
 
-__Опции__
+![Screenshot](doc/images/2.2.1.3-1.png)
 
-Все опции могут быть аргументами метода, и только некоторые опции влияют на результат через блок — на лету (последняя строка блока).
+Замена шаблонов на динамический html:
 
-```ruby
-tabulated: true,
-inline: false,
-tab: "\t",
-ul:  '<ul>', # может задаваться блоком
-_ul: '</ul>',
-li:  '<li>', # может задаваться блоком
-_li: '</li>',
+```erb
+<% content_for :head do %>
+  <style>
+    li.level-0 {color: red;}
+    li.level-1 {color: green;}
+    li.level-2 {color: blue;}
+    li.has_children {font-weight: bold;}
+    ul.big {border: solid 1px gray;}
+  </style>
+<% end %>
+
+<ul>
+  <% @catalogs.to_a.to_nested.each_nested do |node, origin| %>
+    <li class="level-<%= node.level %> <%= 'has_children' if node.is_has_children %>">
+    <%= origin.name %> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <% if node.ul.present? %>
+      <ul class="<%= 'big' if node.children.length > 2 %>">
+    <% end %>
+    <%= node._ -%>
+  <% end %>
+</ul>
 ```
 
+![Screenshot](doc/images/2.2.1.3-2.png)
 
+Стоит отметить, что поле `node.li` всегда присутствует в узле, в отличие от
+`node.ul`.
 
 
-<a name="nested_to_options"></a>
-### nested_to_options [↑](#methods "К методам")
 
-Формирования опций для html-тега &lt;select&gt;
 
-Возвращает массив с псевдографикой, позволяющей вывести древовидную структуру.
+##### <a id="2.2.1.4"></a>Расскрывающийся список на основе тега `<details></details>` [↑](#Оглавление "К оглавлению")
 
-```ruby
+```erb
+<ul class="nested_array-details">
+  <% @catalogs.to_a.to_nested.each_nested details: true do |node, origin| %>
+    <%= node.before %>
+    <%= origin.name %> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.after %>
+  <% end %>
+</ul>
+```
 
-[['option_text1', 'option_value1'],['option_text2', 'option_value2'],…]
+![Screenshot](doc/images/2.2.1.4-1.png)
+
+По умолчанию подуровни скрыты, можно управлять отображением подуровней передавая
+опцию в метод узла: `node.after(open: …)`:
+
+```erb
+<ul class="nested_array-details">
+  <% @catalogs.to_a.to_nested.each_nested details: true do |node, origin| %>
+    <%= node.before %>
+    <%= origin.name %> <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+    <%= node.after(open: node.is_has_children) %>
+  <% end %>
+</ul>
 ```
 
-__Опции__
+![Screenshot](doc/images/2.2.1.4-2.png)
 
-```ruby
-option_value: 'id', # Что брать в качестве значений при формировании опций селекта.
-option_text: 'name',
+
+
+
+##### <a id="2.2.1.5"></a>Формирование и вывод собственных шаблонов опираясь на изменение уровня узла `node.level` [↑](#Оглавление "К оглавлению")
+
+```erb
+<% content_for :head do %>
+  <style>
+    div.children {margin-left: 1em;}
+    div.node {position: relative;}
+    div.node::before {
+      position: absolute;
+      content: "";
+      width: 0px;
+      height: 0px;
+      border-top: 5px solid transparent;
+      border-bottom: 5px solid transparent;
+      border-left: 8.66px solid red;
+      left: -9px;
+      top: 3px;
+    }
+  </style>
+<% end %>
+
+<div class="children">
+  <% prev_level = nil %>
+  <% @catalogs.to_a.to_nested.each_nested do |node, origin| %>
+
+    <%# Уровень повысился? — открываем подуровень. %>
+    <% if prev_level.present? && prev_level < node.level %>
+      <div class="children">
+    <% end %>
+
+    <%# Уровень тот же? — предыдущий закрываем просто. %>
+    <% if prev_level.present? && prev_level == node.level %>
+      </div>
+    <% end %>
+
+    <%# Уровень понизился? - предыдущий закрываем сложно. %>
+    <% if prev_level.present? && prev_level > node.level %>
+      <% (prev_level - node.level).times do |t| %>
+        </div>
+        </div>
+      <% end %>
+      </div>
+    <% end %>
+
+    <%# Наш узел. %>
+    <div class="node">
+    <%= origin.name %>
+
+    <% prev_level = node.level %>
+  <% end %>
+
+  <%# Учёт предыдущего уровня при выходе из цикла (Уровень понизился). %>
+  <% if !prev_level.nil? %>
+    <% prev_level.times do |t| %>
+      </div>
+      </div>
+    <% end %>
+    </div>
+  <% end %>
+</div>
 ```
 
+![Screenshot](doc/images/2.2.1.5.png)
+
 
 
 
-<a name="nested_to_collection_select"></a>
-### nested_to_collection_select [↑](#methods "К методам")
+#### <a id="2.2.2"></a>В виде псевдографики [↑](#Оглавление "К оглавлению")
 
-Преобразует вложенную структуру данных в плоскую, но добавляет в значение поля
-отвечающего за текстовое представление (:name) псевдографику древовидной
-структуры.
+##### <a id="2.2.2.1"></a>Добавление псевдографики перед именем модели методом `nested_to_options` [↑](#Оглавление "К оглавлению")
 
-Это позволяет вывести тэг select в сносном виде для использования с вложенными
-структурами.
+```erb
+<% options = @catalogs.to_a.to_nested.nested_to_options(:name, :id) %>
+<pre><code><%= options.pluck(0).join($/) %>
+</code></pre>
+```
 
-Пример с хелпером `collection_select`
+![Screenshot](doc/images/2.2.2.1.png)
 
-```rb
-<%= form.collection_select :catalog_ids,
-  Catalog.all.to_a.to_nested.nested_to_collection_select, :id, :name,
-  {
-    # prompt: true
-    # include_blank: true
-  },
-  {
-    multiple: true,
-    size: 10
-  }
-%>
+
+
+
+##### <a id="2.2.2.2"></a>Тонкая псевдографика [↑](#Оглавление "К оглавлению")
+
+```erb
+<% options = @catalogs.to_a.to_nested.nested_to_options(:name, :id, thin_pseudographic: true) %>
+<pre><code><%= options.pluck(0).join($/) %>
+</code></pre>
 ```
 
-Пример с хелпером `select` в сочетании с `options_from_collection_for_select`
+![Screenshot](doc/images/2.2.2.2.png)
+
+
+
+
+##### <a id="2.2.2.3"></a>Собственная певдографика [↑](#Оглавление "К оглавлению")
 
 ```erb
-<% catalogs = Catalog.all.to_a %>
-<%= form.select :catalog_ids,
-  options_from_collection_for_select(
-    catalogs.to_nested.nested_to_collection_select, :id, :name,
-    disabled: catalogs.select{|x| x.hidden?}.pluck(:id),
-    selected: form.object.catalog_ids
-  ),
-  {
-    # prompt: true
-    # include_blank: true
-  },
-  {
-    multiple: true,
-    size: 10
-  }
-%>
+<% options = @catalogs.to_a.to_nested.nested_to_options(:name, :id, pseudographics: %w(┬ ─ ❇ ├ └ &nbsp; │)) %>
+<pre><code><%= options.pluck(0).join($/).html_safe %>
+</code></pre>
 ```
 
+![Screenshot](doc/images/2.2.2.3.png)
+
+
 
 
+##### <a id="2.2.2.4"></a>Увеличение отступа в собственной псевдографике [↑](#Оглавление "К оглавлению")
 
-<a name="concat_nested"></a>
-### concat_nested [↑](#methods "К методам")
+```erb
+<% options = @catalogs.to_a.to_nested.nested_to_options(:name, :id, pseudographics: ['─┬', '──', '─&nbsp;', '&nbsp;├', '&nbsp;└', '&nbsp;&nbsp;', '&nbsp;│']) %>
+<pre><code><%= options.pluck(0).join($/).html_safe %>
+</code></pre>
+```
 
-Скеивание вложенных структур.
+![Screenshot](doc/images/2.2.2.4.png)
 
-* Ноды склеиваются если путь к ним одинаков;
-* Путь определяется из сложения Текстов (конфигурируемо через :path_key);
 
-__Опции__
 
-```ruby
-path_separator: '-=path_separator=-',
-path_key: 'text',
+
+#### <a id="2.2.3"></a>В формах [↑](#Оглавление "К оглавлению")
+
+#### <a id="2.2.3.1"></a>С хелпером `form.select` [↑](#Оглавление "К оглавлению")
+
+```erb
+<%= form_with(model: Catalog.find(11), url: root_path, method: :get) do |form| %>
+  <%= form.select :parent_id,
+    @catalogs.to_a.to_nested.nested_to_options(:name, :id),
+    {
+      include_blank: 'None'
+    },
+    {
+      multiple: false,
+      size: 11,
+      class: 'form-select form-select-sm nested_array-select'
+    }
+  %>
+<% end %>
 ```
 
+![Screenshot](doc/images/2.2.3.1.png)
 
 
 
-## Разработка
 
-…
+#### <a id="2.2.3.2"></a>С хелперами `form.select` и `options_for_select` [↑](#Оглавление "К оглавлению")
+
+```erb
+<%= form_with(model: Catalog.find(11), url: root_path, method: :get) do |form| %>
+  <%= form.select :parent_id,
+    options_for_select(
+      @catalogs.to_a.to_nested.nested_to_options(:name, :id).unshift(['None', '']),
+      selected: form.object.parent_id.to_s
+    ),
+    {
+    },
+    {
+      multiple: false,
+      size: 11,
+      class: 'nested_array-select'
+    }
+  %>
+<% end %>
+```
+
+![Screenshot](doc/images/2.2.3.2.png)
+
+
 
 
+#### <a id="2.2.3.3"></a>Раскрывающийся список с переключателями `form.radio_button` [↑](#Оглавление "К оглавлению")
 
+```erb
+<%= form_with(model: nil, url: root_path, method: :get) do |form| %>
+  <ul class="nested_array-details">
+    <% @catalogs.to_a.to_nested.each_nested details: true do |node, origin| %>
+      <%= node.before %>
+      <%= form.radio_button :parent_id, origin.id %>
+      <%= form.label :parent_id, origin.name, value: origin.id %>
+      <small>[<%= origin.id %>, <%= origin.parent_id || :nil %>, <%= node.level %>]</small>
+      <%= node.after(open: node.is_has_children) %>
+    <% end %>
+  </ul>
+<% end %>
+```
 
-## Содействие
+![Screenshot](doc/images/2.2.3.3.png)
 
-…
 
 
 
+## Разработка
 
-## Лицензия
+Часто используемые команды
+
+```sh
+# rspec управляет загружаемыми гемами, поэтому сам rspec запускается НЕ `bundle
+# exec rspec`, а просто `rspec` или `./bin/rspec`.
+rspec ./spec/lib/nested_array_spec.rb
+rspec ./spec/lib/nested_array/nested_spec.rb
+rspec                            # Прогон тестов
+subl lib/nested_array/version.rb # Обновление версии
+bundle exec yard doc             # Обновление документации в doc/_index.html
+git …                            # Git-фиксация в origin/master и тег
+gem build                        # Сборка гема
+gem push ./nested_array-…        # Публикация гема
+```
 
-В соответствии с условиями [лицензии MIT](https://opensource.org/licenses/MIT).
+Для подключения локальной версии гема в rails замените в строке подключения
+(файл Gemfile) второй аргумент (версию) на опцию path:
+
+```rb
+# Gemfile
+# Работа с древовидными массивами
+gem "nested_array", path: "../nested_array"
+```