9 "github.com/mitchellh/go-homedir"
10 "github.com/zyedidia/tcell"
13 type ViewType struct {
15 readonly bool // The file cannot be edited
16 scratch bool // The file cannot be saved
20 vtDefault = ViewType{0, false, false}
21 vtHelp = ViewType{1, true, true}
22 vtLog = ViewType{2, true, true}
23 vtScratch = ViewType{3, false, true}
26 // The View struct stores information about a view into a buffer.
27 // It stores information about the cursor, and the viewport
28 // that the user sees the buffer from.
30 // A pointer to the buffer's cursor for ease of access
33 // The topmost line, used for vertical scrolling
35 // The leftmost column, used for horizontal scrolling
38 // Specifies whether or not this view holds a help buffer
41 // Actual width and height
48 // Where this view is located
51 // How much to offset because of line numbers
54 // Holds the list of gutter messages
55 messages map[string][]GutterMessage
57 // This is the index of this view in the views array
59 // What tab is this view stored in
67 // Since tcell doesn't differentiate between a mouse release event
68 // and a mouse move event with no keys pressed, we need to keep
69 // track of whether or not the mouse was pressed (or not released) last event to determine
70 // mouse release events
73 // This stores when the last click was
74 // This is useful for detecting double and triple clicks
75 lastClickTime time.Time
77 // lastCutTime stores when the last ctrl+k was issued.
78 // It is used for clearing the clipboard to replace it with fresh cut lines.
81 // freshClip returns true if the clipboard has never been pasted.
84 // Was the last mouse event actually a double click?
85 // Useful for detecting triple clicks -- if a double click is detected
86 // but the last mouse event was actually a double click, it's a triple click
88 // Same here, just to keep track for mouse move events
96 // NewView returns a new fullscreen view
97 func NewView(buf *Buffer) *View {
98 screenW, screenH := screen.Size()
99 return NewViewWidthHeight(buf, screenW, screenH)
102 // NewViewWidthHeight returns a new view with the specified width and height
103 // Note that w and h are raw column and row values
104 func NewViewWidthHeight(buf *Buffer, w, h int) *View {
111 v.cellview = new(CellView)
117 v.messages = make(map[string][]GutterMessage)
119 v.sline = Statusline{
123 if v.Buf.Settings["statusline"].(bool) {
127 for pl := range loadedPlugins {
128 _, err := Call(pl+".onViewOpen", v)
129 if err != nil && !strings.HasPrefix(err.Error(), "function does not exist") {
138 // ToggleStatusLine creates an extra row for the statusline if necessary
139 func (v *View) ToggleStatusLine() {
140 if v.Buf.Settings["statusline"].(bool) {
147 // ToggleTabbar creates an extra row for the tabbar if necessary
148 func (v *View) ToggleTabbar() {
151 // Include one line for the tab bar at the top
163 func (v *View) paste(clip string) {
164 leadingWS := GetLeadingWhitespace(v.Buf.Line(v.Cursor.Y))
166 if v.Cursor.HasSelection() {
167 v.Cursor.DeleteSelection()
168 v.Cursor.ResetSelection()
170 clip = strings.Replace(clip, "\n", "\n"+leadingWS, -1)
171 v.Buf.Insert(v.Cursor.Loc, clip)
172 v.Cursor.Loc = v.Cursor.Loc.Move(Count(clip), v.Buf)
174 messenger.Message("Pasted clipboard")
177 // ScrollUp scrolls the view up n lines (if possible)
178 func (v *View) ScrollUp(n int) {
179 // Try to scroll by n but if it would overflow, scroll by 1
180 if v.Topline-n >= 0 {
182 } else if v.Topline > 0 {
187 // ScrollDown scrolls the view down n lines (if possible)
188 func (v *View) ScrollDown(n int) {
189 // Try to scroll by n but if it would overflow, scroll by 1
190 if v.Topline+n <= v.Buf.NumLines {
192 } else if v.Topline < v.Buf.NumLines-1 {
197 // CanClose returns whether or not the view can be closed
198 // If there are unsaved changes, the user will be asked if the view can be closed
199 // causing them to lose the unsaved changes
200 func (v *View) CanClose() bool {
201 if v.Type == vtDefault && v.Buf.IsModified {
204 if v.Buf.Settings["autosave"].(bool) {
207 choice, canceled = messenger.YesNoPrompt("Save changes to " + v.Buf.GetName() + " before closing? (y,n,esc) ")
224 // OpenBuffer opens a new buffer in this view.
225 // This resets the topline, event handler and cursor.
226 func (v *View) OpenBuffer(buf *Buffer) {
230 v.Cursor = &buf.Cursor
233 v.Cursor.ResetSelection()
236 v.messages = make(map[string][]GutterMessage)
238 // Set mouseReleased to true because we assume the mouse is not being pressed when
239 // the editor is opened
240 v.mouseReleased = true
241 v.lastClickTime = time.Time{}
244 // Open opens the given file in the view
245 func (v *View) Open(filename string) {
246 home, _ := homedir.Dir()
247 filename = strings.Replace(filename, "~", home, 1)
248 file, err := os.Open(filename)
249 fileInfo, _ := os.Stat(filename)
251 if err == nil && fileInfo.IsDir() {
252 messenger.Error(filename, " is a directory")
260 messenger.Message(err.Error())
261 // File does not exist -- create an empty buffer with that name
262 buf = NewBufferFromString("", filename)
264 buf = NewBuffer(file, FSize(file), filename)
269 // CloseBuffer performs any closing functions on the buffer
270 func (v *View) CloseBuffer() {
276 // ReOpen reloads the current buffer
277 func (v *View) ReOpen() {
285 // HSplit opens a horizontal split with the given buffer
286 func (v *View) HSplit(buf *Buffer) {
288 if v.Buf.Settings["splitBottom"].(bool) {
291 v.splitNode.HSplit(buf, v.Num+i)
294 // VSplit opens a vertical split with the given buffer
295 func (v *View) VSplit(buf *Buffer) {
297 if v.Buf.Settings["splitRight"].(bool) {
300 v.splitNode.VSplit(buf, v.Num+i)
303 // HSplitIndex opens a horizontal split with the given buffer at the given index
304 func (v *View) HSplitIndex(buf *Buffer, splitIndex int) {
305 v.splitNode.HSplit(buf, splitIndex)
308 // VSplitIndex opens a vertical split with the given buffer at the given index
309 func (v *View) VSplitIndex(buf *Buffer, splitIndex int) {
310 v.splitNode.VSplit(buf, splitIndex)
313 // GetSoftWrapLocation gets the location of a visual click on the screen and converts it to col,line
314 func (v *View) GetSoftWrapLocation(vx, vy int) (int, int) {
315 if !v.Buf.Settings["softwrap"].(bool) {
316 if vy >= v.Buf.NumLines {
317 vy = v.Buf.NumLines - 1
319 vx = v.Cursor.GetCharPosInLine(vy, vx)
323 screenX, screenY := 0, v.Topline
324 for lineN := v.Topline; lineN < v.Bottomline(); lineN++ {
325 line := v.Buf.Line(lineN)
326 if lineN >= v.Buf.NumLines {
327 return 0, v.Buf.NumLines - 1
331 for _, ch := range line {
332 if screenX >= v.Width-v.lineNumOffset {
337 if screenX == vx && screenY == vy {
342 screenX += int(v.Buf.Settings["tabsize"].(float64)) - 1
358 func (v *View) Bottomline() int {
359 if !v.Buf.Settings["softwrap"].(bool) {
360 return v.Topline + v.Height
363 screenX, screenY := 0, 0
365 for lineN := v.Topline; lineN < v.Topline+v.Height; lineN++ {
366 line := v.Buf.Line(lineN)
369 for _, ch := range line {
370 if screenX >= v.Width-v.lineNumOffset {
376 screenX += int(v.Buf.Settings["tabsize"].(float64)) - 1
386 if screenY >= v.Height {
390 return numLines + v.Topline
393 // Relocate moves the view window so that the cursor is in view
394 // This is useful if the user has scrolled far away, and then starts typing
395 func (v *View) Relocate() bool {
396 height := v.Bottomline() - v.Topline
399 scrollmargin := int(v.Buf.Settings["scrollmargin"].(float64))
400 if cy < v.Topline+scrollmargin && cy > scrollmargin-1 {
401 v.Topline = cy - scrollmargin
403 } else if cy < v.Topline {
407 if cy > v.Topline+height-1-scrollmargin && cy < v.Buf.NumLines-scrollmargin {
408 v.Topline = cy - height + 1 + scrollmargin
410 } else if cy >= v.Buf.NumLines-scrollmargin && cy > height {
411 v.Topline = v.Buf.NumLines - height
415 if !v.Buf.Settings["softwrap"].(bool) {
416 cx := v.Cursor.GetVisualX()
421 if cx+v.lineNumOffset+1 > v.leftCol+v.Width {
422 v.leftCol = cx - v.Width + v.lineNumOffset + 1
429 // MoveToMouseClick moves the cursor to location x, y assuming x, y were given
431 func (v *View) MoveToMouseClick(x, y int) {
432 if y-v.Topline > v.Height-1 {
434 y = v.Height + v.Topline - 1
443 x, y = v.GetSoftWrapLocation(x, y)
444 // x = v.Cursor.GetCharPosInLine(y, x)
445 if x > Count(v.Buf.Line(y)) {
446 x = Count(v.Buf.Line(y))
450 v.Cursor.LastVisualX = v.Cursor.GetVisualX()
453 // HandleEvent handles an event passed by the main loop
454 func (v *View) HandleEvent(event tcell.Event) {
455 // This bool determines whether the view is relocated at the end of the function
456 // By default it's true because most events should cause a relocate
461 switch e := event.(type) {
462 case *tcell.EventKey:
463 // Check first if input is a key binding, if it is we 'eat' the input and don't insert a rune
465 readonlyBindingsList := []string{"Delete", "Insert", "Backspace", "Cut", "Play", "Paste", "Move", "Add", "DuplicateLine", "Macro"}
466 if e.Key() != tcell.KeyRune || e.Modifiers() != 0 {
467 for key, actions := range bindings {
468 if e.Key() == key.keyCode {
469 if e.Key() == tcell.KeyRune {
470 if e.Rune() != key.r {
474 if e.Modifiers() == key.modifiers {
477 for _, action := range actions {
478 readonlyBindingsResult := false
479 funcName := ShortFuncName(action)
480 if v.Type.readonly == true {
481 // check for readonly and if true only let key bindings get called if they do not change the contents.
482 for _, readonlyBindings := range readonlyBindingsList {
483 if strings.Contains(funcName, readonlyBindings) {
484 readonlyBindingsResult = true
488 if !readonlyBindingsResult {
489 // call the key binding
490 relocate = action(v, true) || relocate
492 if funcName != "ToggleMacro" && funcName != "PlayMacro" {
494 curMacro = append(curMacro, action)
504 if !isBinding && e.Key() == tcell.KeyRune {
505 // Check viewtype if readonly don't insert a rune (readonly help and log view etc.)
506 if v.Type.readonly == false {
507 // Insert a character
508 if v.Cursor.HasSelection() {
509 v.Cursor.DeleteSelection()
510 v.Cursor.ResetSelection()
512 v.Buf.Insert(v.Cursor.Loc, string(e.Rune()))
515 for pl := range loadedPlugins {
516 _, err := Call(pl+".onRune", string(e.Rune()), v)
517 if err != nil && !strings.HasPrefix(err.Error(), "function does not exist") {
523 curMacro = append(curMacro, e.Rune())
527 case *tcell.EventPaste:
528 // Check viewtype if readonly don't paste (readonly help and log view etc.)
529 if v.Type.readonly == false {
530 if !PreActionCall("Paste", v) {
536 PostActionCall("Paste", v)
538 case *tcell.EventMouse:
540 x -= v.lineNumOffset - v.leftCol + v.x
542 // Don't relocate for mouse events
545 button := e.Buttons()
551 v.MoveToMouseClick(x, y)
552 if time.Since(v.lastClickTime)/time.Millisecond < doubleClickThreshold {
555 v.lastClickTime = time.Now()
558 v.doubleClick = false
560 v.Cursor.SelectLine()
561 v.Cursor.CopySelection("primary")
564 v.lastClickTime = time.Now()
567 v.tripleClick = false
569 v.Cursor.SelectWord()
570 v.Cursor.CopySelection("primary")
573 v.doubleClick = false
574 v.tripleClick = false
575 v.lastClickTime = time.Now()
577 v.Cursor.OrigSelection[0] = v.Cursor.Loc
578 v.Cursor.CurSelection[0] = v.Cursor.Loc
579 v.Cursor.CurSelection[1] = v.Cursor.Loc
581 v.mouseReleased = false
582 } else if !v.mouseReleased {
583 v.MoveToMouseClick(x, y)
585 v.Cursor.AddLineToSelection()
586 } else if v.doubleClick {
587 v.Cursor.AddWordToSelection()
589 v.Cursor.SetSelectionEnd(v.Cursor.Loc)
590 v.Cursor.CopySelection("primary")
594 // Check viewtype if readonly don't paste (readonly help and log view etc.)
595 if v.Type.readonly == false {
596 // Middle mouse button was clicked,
597 // We should paste primary
600 case tcell.ButtonNone:
601 // Mouse event with no click
602 if !v.mouseReleased {
603 // Mouse was just released
605 // Relocating here isn't really necessary because the cursor will
606 // be in the right place from the last mouse event
607 // However, if we are running in a terminal that doesn't support mouse motion
608 // events, this still allows the user to make selections, except only after they
611 if !v.doubleClick && !v.tripleClick {
612 v.MoveToMouseClick(x, y)
613 v.Cursor.SetSelectionEnd(v.Cursor.Loc)
614 v.Cursor.CopySelection("primary")
616 v.mouseReleased = true
620 scrollspeed := int(v.Buf.Settings["scrollspeed"].(float64))
621 v.ScrollUp(scrollspeed)
622 case tcell.WheelDown:
624 scrollspeed := int(v.Buf.Settings["scrollspeed"].(float64))
625 v.ScrollDown(scrollspeed)
631 // We run relocate again because there's a bug with relocating with softwrap
632 // when for example you jump to the bottom of the buffer and it tries to
633 // calculate where to put the topline so that the bottom line is at the bottom
634 // of the terminal and it runs into problems with visual lines vs real lines.
635 // This is (hopefully) a temporary solution
640 // GutterMessage creates a message in this view's gutter
641 func (v *View) GutterMessage(section string, lineN int, msg string, kind int) {
643 gutterMsg := GutterMessage{
648 for _, v := range v.messages {
649 for _, gmsg := range v {
650 if gmsg.lineNum == lineN {
655 messages := v.messages[section]
656 v.messages[section] = append(messages, gutterMsg)
659 // ClearGutterMessages clears all gutter messages from a given section
660 func (v *View) ClearGutterMessages(section string) {
661 v.messages[section] = []GutterMessage{}
664 // ClearAllGutterMessages clears all the gutter messages
665 func (v *View) ClearAllGutterMessages() {
666 for k := range v.messages {
667 v.messages[k] = []GutterMessage{}
671 // Opens the given help page in a new horizontal split
672 func (v *View) openHelp(helpPage string) {
673 if data, err := FindRuntimeFile(RTHelp, helpPage).Data(); err != nil {
674 TermMessage("Unable to load help text", helpPage, "\n", err)
676 helpBuffer := NewBufferFromString(string(data), helpPage+".md")
677 helpBuffer.name = "Help"
679 if v.Type == vtHelp {
680 v.OpenBuffer(helpBuffer)
683 CurView().Type = vtHelp
688 func (v *View) DisplayView() {
689 if v.Buf.Settings["softwrap"].(bool) && v.leftCol != 0 {
694 // Log views should always follow the cursor...
698 // We need to know the string length of the largest line number
699 // so we can pad appropriately when displaying line numbers
700 maxLineNumLength := len(strconv.Itoa(v.Buf.NumLines))
702 if v.Buf.Settings["ruler"] == true {
703 // + 1 for the little space after the line number
704 v.lineNumOffset = maxLineNumLength + 1
709 // We need to add to the line offset if there are gutter messages
710 var hasGutterMessages bool
711 for _, v := range v.messages {
713 hasGutterMessages = true
716 if hasGutterMessages {
722 // One space for the extra split divider
727 xOffset := v.x + v.lineNumOffset
735 v.cellview.Draw(v.Buf, top, height, left, width-v.lineNumOffset)
741 for visualLineN, line = range v.cellview.lines {
748 if firstChar != nil {
749 if firstChar.realLoc.Y == realLineN {
752 realLineN = firstChar.realLoc.Y
757 colorcolumn := int(v.Buf.Settings["colorcolumn"].(float64))
758 if colorcolumn != 0 {
759 style := GetColor("color-column")
760 fg, _, _ := style.Decompose()
761 st := defStyle.Background(fg)
762 screen.SetContent(xOffset+colorcolumn, yOffset+visualLineN, ' ', nil, st)
767 // If there are gutter messages we need to display the '>>' symbol here
768 if hasGutterMessages {
769 // msgOnLine stores whether or not there is a gutter message on this line in particular
771 for k := range v.messages {
772 for _, msg := range v.messages[k] {
773 if msg.lineNum == realLineN {
775 gutterStyle := defStyle
778 if style, ok := colorscheme["gutter-info"]; ok {
782 if style, ok := colorscheme["gutter-warning"]; ok {
786 if style, ok := colorscheme["gutter-error"]; ok {
790 screen.SetContent(screenX, yOffset+visualLineN, '>', nil, gutterStyle)
792 screen.SetContent(screenX, yOffset+visualLineN, '>', nil, gutterStyle)
794 if v.Cursor.Y == realLineN && !messenger.hasPrompt {
795 messenger.Message(msg.msg)
796 messenger.gutterMessage = true
801 // If there is no message on this line we just display an empty offset
803 screen.SetContent(screenX, yOffset+visualLineN, ' ', nil, defStyle)
805 screen.SetContent(screenX, yOffset+visualLineN, ' ', nil, defStyle)
807 if v.Cursor.Y == realLineN && messenger.gutterMessage {
809 messenger.gutterMessage = false
814 lineNumStyle := defStyle
815 if v.Buf.Settings["ruler"] == true {
816 // Write the line number
817 if style, ok := colorscheme["line-number"]; ok {
820 if style, ok := colorscheme["current-line-number"]; ok {
821 if realLineN == v.Cursor.Y && tabs[curTab].CurView == v.Num && !v.Cursor.HasSelection() {
826 lineNum := strconv.Itoa(realLineN + 1)
828 // Write the spaces before the line number if necessary
829 for i := 0; i < maxLineNumLength-len(lineNum); i++ {
830 screen.SetContent(screenX+divider, yOffset+visualLineN, ' ', nil, lineNumStyle)
833 if softwrapped && visualLineN != 0 {
834 // Pad without the line number because it was written on the visual line before
836 screen.SetContent(screenX+divider, yOffset+visualLineN, ' ', nil, lineNumStyle)
840 // Write the actual line number
841 for _, ch := range lineNum {
842 screen.SetContent(screenX+divider, yOffset+visualLineN, ch, nil, lineNumStyle)
847 // Write the extra space
848 screen.SetContent(screenX+divider, yOffset+visualLineN, ' ', nil, lineNumStyle)
854 for _, char := range line {
856 lineStyle := char.style
858 colorcolumn := int(v.Buf.Settings["colorcolumn"].(float64))
859 if colorcolumn != 0 && char.visualLoc.X == colorcolumn {
860 style := GetColor("color-column")
861 fg, _, _ := style.Decompose()
862 lineStyle = lineStyle.Background(fg)
865 charLoc := char.realLoc
866 if v.Cursor.HasSelection() &&
867 (charLoc.GreaterEqual(v.Cursor.CurSelection[0]) && charLoc.LessThan(v.Cursor.CurSelection[1]) ||
868 charLoc.LessThan(v.Cursor.CurSelection[0]) && charLoc.GreaterEqual(v.Cursor.CurSelection[1])) {
869 // The current character is selected
870 lineStyle = defStyle.Reverse(true)
872 if style, ok := colorscheme["selection"]; ok {
877 if tabs[curTab].CurView == v.Num && !v.Cursor.HasSelection() &&
878 v.Cursor.Y == char.realLoc.Y && v.Cursor.X == char.realLoc.X && !cursorSet {
879 screen.ShowCursor(xOffset+char.visualLoc.X, yOffset+char.visualLoc.Y)
883 if v.Buf.Settings["cursorline"].(bool) && tabs[curTab].CurView == v.Num &&
884 !v.Cursor.HasSelection() && v.Cursor.Y == realLineN {
885 style := GetColor("cursor-line")
886 fg, _, _ := style.Decompose()
887 lineStyle = lineStyle.Background(fg)
890 screen.SetContent(xOffset+char.visualLoc.X, yOffset+char.visualLoc.Y, char.drawChar, nil, lineStyle)
901 lastX = xOffset + lastChar.visualLoc.X + lastChar.width
902 if tabs[curTab].CurView == v.Num && !v.Cursor.HasSelection() &&
903 v.Cursor.Y == lastChar.realLoc.Y && v.Cursor.X == lastChar.realLoc.X+1 {
904 screen.ShowCursor(lastX, yOffset+lastChar.visualLoc.Y)
905 cx, cy = lastX, yOffset+lastChar.visualLoc.Y
907 realLoc = Loc{lastChar.realLoc.X, realLineN}
908 visualLoc = Loc{lastX - xOffset, lastChar.visualLoc.Y}
909 } else if len(line) == 0 {
910 if tabs[curTab].CurView == v.Num && !v.Cursor.HasSelection() &&
911 v.Cursor.Y == realLineN {
912 screen.ShowCursor(xOffset, yOffset+visualLineN)
913 cx, cy = xOffset, yOffset+visualLineN
916 realLoc = Loc{0, realLineN}
917 visualLoc = Loc{0, visualLineN}
920 if v.Cursor.HasSelection() &&
921 (realLoc.GreaterEqual(v.Cursor.CurSelection[0]) && realLoc.LessThan(v.Cursor.CurSelection[1]) ||
922 realLoc.LessThan(v.Cursor.CurSelection[0]) && realLoc.GreaterEqual(v.Cursor.CurSelection[1])) {
923 // The current character is selected
924 selectStyle := defStyle.Reverse(true)
926 if style, ok := colorscheme["selection"]; ok {
929 screen.SetContent(xOffset+visualLoc.X, yOffset+visualLoc.Y, ' ', nil, selectStyle)
932 if v.Buf.Settings["cursorline"].(bool) && tabs[curTab].CurView == v.Num &&
933 !v.Cursor.HasSelection() && v.Cursor.Y == realLineN {
934 for i := lastX; i < xOffset+v.Width; i++ {
935 style := GetColor("cursor-line")
936 fg, _, _ := style.Decompose()
937 style = style.Background(fg)
938 if !(tabs[curTab].CurView == v.Num && !v.Cursor.HasSelection() && i == cx && yOffset+visualLineN == cy) {
939 screen.SetContent(i, yOffset+visualLineN, ' ', nil, style)
946 dividerStyle := defStyle
947 if style, ok := colorscheme["divider"]; ok {
950 for i := 0; i < v.Height; i++ {
951 screen.SetContent(v.x, yOffset+i, '|', nil, dividerStyle.Reverse(true))
956 // Display renders the view, the cursor, and statusline
957 func (v *View) Display() {
958 if globalSettings["termtitle"].(bool) {
959 screen.SetTitle("micro: " + v.Buf.GetName())
962 // Don't draw the cursor if it is out of the viewport or if it has a selection
963 if v.Num == tabs[curTab].CurView && (v.Cursor.Y-v.Topline < 0 || v.Cursor.Y-v.Topline > v.Height-1 || v.Cursor.HasSelection()) {
966 _, screenH := screen.Size()
967 if v.Buf.Settings["statusline"].(bool) {
969 } else if (v.y + v.Height) != screenH-1 {
970 for x := 0; x < v.Width; x++ {
971 screen.SetContent(v.x+x, v.y+v.Height, '-', nil, defStyle.Reverse(true))