Перевод обработчиков нажатия клавиш со строк на объект клавиш, комментарии

This commit is contained in:
XeRo 2026-01-26 17:46:17 +05:00
parent c69a7ae84b
commit 2192b3647f
11 changed files with 240 additions and 210 deletions

View file

@ -6,6 +6,7 @@ import (
"bubble/setup/utils"
"bubble/types"
"fmt"
"github.com/charmbracelet/bubbles/key"
"github.com/charmbracelet/bubbles/viewport"
tea "github.com/charmbracelet/bubbletea"
"github.com/charmbracelet/lipgloss"
@ -115,9 +116,9 @@ func (m *FormModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
return m, nil
case tea.KeyMsg:
//Отслеживаем нажатие клавиш формы
switch msg.String() {
case "esc":
//Обработчик клавиши escape на форме нужен для закрытия полей поддерживающих открытие.
switch {
case key.Matches(msg, types.MainKeys.Close):
//Обработчик клавиши закрытия на форме нужен для закрытия полей поддерживающих открытие или закрытие формы настройки.
//Обходим все доступные в текущей форме поля и закрываем те, что были открыты.
//Проверять на фокус не нужно, так как не предполагается, что у нас может быть открыто сразу несколько полей.
//Поэтому просто возвращаем команду по возврату сообщение об обновлении полей.
@ -147,8 +148,8 @@ func (m *FormModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
},
}
}
case "enter":
//Обработчик клавиши enter на форме нужен для перехода на следующую секцию.
case key.Matches(msg, types.MainKeys.Confirm):
//Обработчик клавиши подтверждения на форме, нужен для перехода на следующую секцию.
//Проверяем где сейчас находится фокус, если его позиция равняется количеству полей,
//значит он вышел за пределы формы и находится на кнопке next section, что ставится последней.
//После этого мы сбрасываем фокус и возвращаем команду по возврату сообщения о переходе на следующую секцию
@ -158,53 +159,23 @@ func (m *FormModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
return types.NextSectionMsg{}
}
}
case "tab", "shift+tab", "down", "up":
//Обработчик клавиш tab, shift+tab, down, up на форме нужен для перехода между объектами формы.
//Получаем точное имя клавиши нажатия, после проверяем где сейчас находится фокус.
case key.Matches(msg, types.MainKeys.Up):
//Обработчик клавиши перехода на предыдущий элемент формы, нужен для смены фокуса на прошлый элемент.
//Если фокус меньше количества полей, то значит фокус сейчас на поле формы.
// Подробнее. У нас фокус в двух состояниях так сказать,
// фокус равен количество полей, значит он на кнопке следующей секции,
// если меньше количества полей или равен 0, значит фокус на поле формы.
// Если у нас нет полей на форме (секция About), значит количество полей равно 0, а фокус по умолчанию устанавливается 0.
// Чтобы m.FieldModels[m.focus] не вызвало ошибку "индекс вне массива",
// нужно чтобы в условие m.focus < len(m.FieldModels) попал фокус меньше 0 (-1,-2 и тд).
// Чтобы этого избежать, есть проверка, которая устанавливает m.focus на последнюю позицию (количество полей на форме).
// Чтобы эта проверка дала сбой, нужно после неё прописать изменение фокуса формы на отрицательный принудительно, так как такое не может произойти в текущем коде.
//Получаем имя поля (так как это старый фокус, то и поле на котором мы находимся это предыдущее поле, отсюда и название переменной),
//Если поле не открыто, то мы можем перейти на следующее поле, увеличив или уменьшив фокус.
//Если фокус равен количеству полей, значит он находится на кнопке переключения секций. Увеличиваем или уменьшаем фокус.
key := msg.String()
//Если поле не открыто, то уменьшаем фокус.
//Если поле открыто, то передаем сообщение в это поле.
//Если фокус стал меньше 0, то присваиваем ему индекс кнопки секции и
//возвращаем команду по возврату сообщения прокручивания в самый низ.
if m.focus < len(m.FieldModels) {
prevField := m.FieldModels[m.focus]
if !prevField.CaptureKeys() {
if key == "tab" || key == "down" {
m.focus++
} else if key == "shift+tab" || key == "up" {
m.focus--
}
if !m.FieldModels[m.focus].CaptureKeys() {
m.focus--
} else {
return m, m.updateFields(msg)
}
} else {
if key == "tab" || key == "down" {
m.focus++
} else if key == "shift+tab" || key == "up" {
m.focus--
}
m.focus--
}
//Проверка правильности фокуса, чтобы не выйти за границы массива полей формы, необходимо проверить новое значение фокуса.
//Если фокус стал больше чем количество полей формы, значит он вышел за пределы всей формы и находится уже даже ниже кнопки,
//переводим его на первую позицию, то есть на 0 и перемещаем видимую область наверх.
//Если фокус стал меньше 0, значит он вышел за пределы формы и находится выше первого поля формы,
//переводим его на последнюю позицию, то есть на кнопку переключения секции, равную положение которой = количество полей на форме и перемещаем видимую область вниз.
if m.focus == len(m.FieldModels)+1 {
m.focus = 0
return m, func() tea.Msg {
return types.ViewportScrollMsg{
Direction: "up",
}
}
} else if m.focus < 0 {
if m.focus < 0 {
m.focus = len(m.FieldModels)
return m, func() tea.Msg {
return types.ViewportScrollMsg{
@ -212,7 +183,129 @@ func (m *FormModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
}
}
}
case key.Matches(msg, types.MainKeys.Down):
//Обработчик клавиши перехода на следующий элемент формы, нужен для смены фокуса на следующий элемент.
//Если фокус меньше количества полей, то значит фокус сейчас на поле формы.
//Если поле не открыто, то увеличиваем фокус.
//Если поле открыто, то передаем сообщение в это поле.
//Если фокус стал больше количества полей формы, то присваиваем ему стартовый индекс и
//возвращаем команду по возврату сообщения прокручивания в самый верх.
if m.focus < len(m.FieldModels) {
if !m.FieldModels[m.focus].CaptureKeys() {
m.focus++
} else {
return m, m.updateFields(msg)
}
} else {
m.focus++
}
if m.focus == len(m.FieldModels)+1 {
m.focus = 0
return m, func() tea.Msg {
return types.ViewportScrollMsg{
Direction: "up",
}
}
}
}
//switch msg.String() {
//case "esc":
// //Обработчик клавиши escape на форме нужен для закрытия полей поддерживающих открытие.
// //Обходим все доступные в текущей форме поля и закрываем те, что были открыты.
// //Проверять на фокус не нужно, так как не предполагается, что у нас может быть открыто сразу несколько полей.
// //Поэтому просто возвращаем команду по возврату сообщение об обновлении полей.
// for _, field := range m.FieldModels {
// //проверяем открыто ли поле
// if field.CaptureKeys() {
// //обновляем поля если оно открыто
// return m, m.updateFields(msg)
// }
// }
// //Если открытых полей не было найдено, значит escape была нажата для закрытия настройки,
// //возвращаем команду по возврату сообщения об открытии модального окна
// return m, func() tea.Msg {
// return types.ShowModalMsg{
// Type: types.ModalWarning,
// Title: "Прервать настройку",
// Message: "Вы уверены, что хотите прервать настройку?\nВсе введенные данные будут потеряны.",
// ModalButtons: []types.ModalButton{
// {Text: "Да, выйти", Value: true},
// {Text: "Продолжить настройку", Value: false},
// },
// OnResult: func(result any) tea.Cmd {
// if result == true {
// return func() tea.Msg { return types.BackToListMsg{} }
// }
// return nil
// },
// }
// }
//case "enter":
// //Обработчик клавиши enter на форме нужен для перехода на следующую секцию.
// //Проверяем где сейчас находится фокус, если его позиция равняется количеству полей,
// //значит он вышел за пределы формы и находится на кнопке next section, что ставится последней.
// //После этого мы сбрасываем фокус и возвращаем команду по возврату сообщения о переходе на следующую секцию
// if len(m.FieldModels) == m.focus {
// m.focus = 0
// return m, func() tea.Msg {
// return types.NextSectionMsg{}
// }
// }
//case "tab", "shift+tab", "down", "up":
// //Обработчик клавиш tab, shift+tab, down, up на форме нужен для перехода между объектами формы.
// //Получаем точное имя клавиши нажатия, после проверяем где сейчас находится фокус.
// //Если фокус меньше количества полей, то значит фокус сейчас на поле формы.
// // Подробнее. У нас фокус в двух состояниях так сказать,
// // фокус равен количество полей, значит он на кнопке следующей секции,
// // если меньше количества полей или равен 0, значит фокус на поле формы.
// // Если у нас нет полей на форме (секция About), значит количество полей равно 0, а фокус по умолчанию устанавливается 0.
// // Чтобы m.FieldModels[m.focus] не вызвало ошибку "индекс вне массива",
// // нужно чтобы в условие m.focus < len(m.FieldModels) попал фокус меньше 0 (-1,-2 и тд).
// // Чтобы этого избежать, есть проверка, которая устанавливает m.focus на последнюю позицию (количество полей на форме).
// // Чтобы эта проверка дала сбой, нужно после неё прописать изменение фокуса формы на отрицательный принудительно, так как такое не может произойти в текущем коде.
// //Получаем имя поля (так как это старый фокус, то и поле на котором мы находимся это предыдущее поле, отсюда и название переменной),
// //Если поле не открыто, то мы можем перейти на следующее поле, увеличив или уменьшив фокус.
// //Если фокус равен количеству полей, значит он находится на кнопке переключения секций. Увеличиваем или уменьшаем фокус.
// key := msg.String()
// if m.focus < len(m.FieldModels) {
// prevField := m.FieldModels[m.focus]
// if !prevField.CaptureKeys() {
// if key == "tab" || key == "down" {
// m.focus++
// } else if key == "shift+tab" || key == "up" {
// m.focus--
// }
// } else {
// return m, m.updateFields(msg)
// }
// } else {
// if key == "tab" || key == "down" {
// m.focus++
// } else if key == "shift+tab" || key == "up" {
// m.focus--
// }
// }
// //Проверка правильности фокуса, чтобы не выйти за границы массива полей формы, необходимо проверить новое значение фокуса.
// //Если фокус стал больше чем количество полей формы, значит он вышел за пределы всей формы и находится уже даже ниже кнопки,
// //переводим его на первую позицию, то есть на 0 и перемещаем видимую область наверх.
// //Если фокус стал меньше 0, значит он вышел за пределы формы и находится выше первого поля формы,
// //переводим его на последнюю позицию, то есть на кнопку переключения секции, равную положение которой = количество полей на форме и перемещаем видимую область вниз.
// if m.focus == len(m.FieldModels)+1 {
// m.focus = 0
// return m, func() tea.Msg {
// return types.ViewportScrollMsg{
// Direction: "up",
// }
// }
// } else if m.focus < 0 {
// m.focus = len(m.FieldModels)
// return m, func() tea.Msg {
// return types.ViewportScrollMsg{
// Direction: "down",
// }
// }
// }
//}
case types.ViewportScrollMsg:
if msg.Direction == "up" {
m.viewport.GotoTop()