745 lines
29 KiB
Python
745 lines
29 KiB
Python
# vim: ft=python fileencoding=utf-8 sts=4 sw=4 et:
|
|
|
|
# Copyright 2014 Florian Bruhin (The Compiler) <mail@qutebrowser.org>
|
|
#
|
|
# This file is part of qutebrowser.
|
|
#
|
|
# qutebrowser is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# qutebrowser is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with qutebrowser. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
"""A HintManager to draw hints over links."""
|
|
|
|
import math
|
|
import subprocess
|
|
import collections
|
|
|
|
from PyQt5.QtCore import pyqtSignal, pyqtSlot, QObject, QEvent, Qt, QUrl
|
|
from PyQt5.QtGui import QMouseEvent, QClipboard
|
|
from PyQt5.QtWidgets import QApplication
|
|
|
|
from qutebrowser.config import config
|
|
from qutebrowser.keyinput import modeman
|
|
from qutebrowser.browser import webelem
|
|
from qutebrowser.commands import userscripts, cmdexc, cmdutils
|
|
from qutebrowser.utils import usertypes, log, qtutils, message, objreg
|
|
|
|
|
|
ElemTuple = collections.namedtuple('ElemTuple', ['elem', 'label'])
|
|
|
|
|
|
Target = usertypes.enum('Target', ['normal', 'tab', 'tab_bg', 'window', 'yank',
|
|
'yank_primary', 'fill', 'rapid',
|
|
'rapid_win', 'download', 'userscript',
|
|
'spawn'])
|
|
|
|
|
|
@pyqtSlot(usertypes.KeyMode)
|
|
def on_mode_entered(mode, win_id):
|
|
"""Stop hinting when insert mode was entered."""
|
|
if mode == usertypes.KeyMode.insert:
|
|
modeman.maybe_leave(win_id, usertypes.KeyMode.hint, 'insert mode')
|
|
|
|
|
|
class HintContext:
|
|
|
|
"""Context namespace used for hinting.
|
|
|
|
Attributes:
|
|
frames: The QWebFrames to use.
|
|
elems: A mapping from keystrings to (elem, label) namedtuples.
|
|
baseurl: The URL of the current page.
|
|
target: What to do with the opened links.
|
|
normal/tab/tab_bg/window: Get passed to BrowserTab.
|
|
yank/yank_primary: Yank to clipboard/primary selection
|
|
fill: Fill commandline with link.
|
|
rapid: Rapid mode with background tabs
|
|
download: Download the link.
|
|
userscript: Call a custom userscript.
|
|
spawn: Spawn a simple command.
|
|
to_follow: The link to follow when enter is pressed.
|
|
args: Custom arguments for userscript/spawn
|
|
"""
|
|
|
|
def __init__(self):
|
|
self.elems = {}
|
|
self.target = None
|
|
self.baseurl = None
|
|
self.to_follow = None
|
|
self.frames = []
|
|
self.args = []
|
|
|
|
def get_args(self, urlstr):
|
|
"""Get the arguments, with {hint-url} replaced by the given URL."""
|
|
args = []
|
|
for arg in self.args:
|
|
arg = arg.replace('{hint-url}', urlstr)
|
|
args.append(arg)
|
|
return args
|
|
|
|
|
|
class HintManager(QObject):
|
|
|
|
"""Manage drawing hints over links or other elements.
|
|
|
|
Class attributes:
|
|
HINT_CSS: The CSS template to use for hints.
|
|
HINT_TEXTS: Text displayed for different hinting modes.
|
|
|
|
Attributes:
|
|
_context: The HintContext for the current invocation.
|
|
_win_id: The window ID this HintManager is associated with.
|
|
_tab_id: The tab ID this HintManager is associated with.
|
|
|
|
Signals:
|
|
mouse_event: Mouse event to be posted in the web view.
|
|
arg: A QMouseEvent
|
|
set_open_target: Set a new target to open the links in.
|
|
"""
|
|
|
|
HINT_CSS = """
|
|
display: {display};
|
|
color: {config[colors][hints.fg]};
|
|
background: {config[colors][hints.bg]};
|
|
text-transform: {texttransform};
|
|
font: {config[fonts][hints]};
|
|
border: {config[hints][border]};
|
|
opacity: {config[hints][opacity]};
|
|
z-index: 100000;
|
|
pointer-events: none;
|
|
position: absolute;
|
|
left: {left}px;
|
|
top: {top}px;
|
|
"""
|
|
|
|
HINT_TEXTS = {
|
|
Target.normal: "Follow hint...",
|
|
Target.tab: "Follow hint in new tab...",
|
|
Target.tab_bg: "Follow hint in background tab...",
|
|
Target.window: "Follow hint in new window...",
|
|
Target.yank: "Yank hint to clipboard...",
|
|
Target.yank_primary: "Yank hint to primary selection...",
|
|
Target.fill: "Set hint in commandline...",
|
|
Target.rapid: "Follow hint (rapid mode)...",
|
|
Target.rapid_win: "Follow hint in new window (rapid mode)...",
|
|
Target.download: "Download hint...",
|
|
Target.userscript: "Call userscript via hint...",
|
|
Target.spawn: "Spawn command via hint...",
|
|
}
|
|
|
|
mouse_event = pyqtSignal('QMouseEvent')
|
|
set_open_target = pyqtSignal(str)
|
|
|
|
def __init__(self, win_id, tab_id, parent=None):
|
|
"""Constructor."""
|
|
super().__init__(parent)
|
|
self._win_id = win_id
|
|
self._tab_id = tab_id
|
|
self._context = None
|
|
mode_manager = objreg.get('mode-manager', scope='window',
|
|
window=win_id)
|
|
mode_manager.left.connect(self.on_mode_left)
|
|
|
|
def _cleanup(self):
|
|
"""Clean up after hinting."""
|
|
for elem in self._context.elems.values():
|
|
try:
|
|
elem.label.removeFromDocument()
|
|
except webelem.IsNullError:
|
|
pass
|
|
for f in self._context.frames:
|
|
log.hints.debug("Disconnecting frame {}".format(f))
|
|
f.contentsSizeChanged.disconnect(self.on_contents_size_changed)
|
|
log.hints.debug("Disconnected.")
|
|
text = self.HINT_TEXTS[self._context.target]
|
|
message_bridge = objreg.get('message-bridge', scope='window',
|
|
window=self._win_id)
|
|
message_bridge.maybe_reset_text(text)
|
|
self._context = None
|
|
|
|
def _hint_strings(self, elems):
|
|
"""Calculate the hint strings for elems.
|
|
|
|
Inspired by Vimium.
|
|
|
|
Args:
|
|
elems: The elements to get hint strings for.
|
|
|
|
Return:
|
|
A list of hint strings, in the same order as the elements.
|
|
"""
|
|
if config.get('hints', 'mode') == 'number':
|
|
chars = '0123456789'
|
|
else:
|
|
chars = config.get('hints', 'chars')
|
|
# Determine how many digits the link hints will require in the worst
|
|
# case. Usually we do not need all of these digits for every link
|
|
# single hint, so we can show shorter hints for a few of the links.
|
|
needed = math.ceil(math.log(len(elems), len(chars)))
|
|
# Short hints are the number of hints we can possibly show which are
|
|
# (needed - 1) digits in length.
|
|
short_count = math.floor((len(chars) ** needed - len(elems)) /
|
|
len(chars))
|
|
long_count = len(elems) - short_count
|
|
|
|
strings = []
|
|
|
|
if needed > 1:
|
|
for i in range(short_count):
|
|
strings.append(self._number_to_hint_str(i, chars, needed - 1))
|
|
|
|
start = short_count * len(chars)
|
|
for i in range(start, start + long_count):
|
|
strings.append(self._number_to_hint_str(i, chars, needed))
|
|
|
|
return self._shuffle_hints(strings, len(chars))
|
|
|
|
def _shuffle_hints(self, hints, length):
|
|
"""Shuffle the given set of hints so that they're scattered.
|
|
|
|
Hints starting with the same character will be spread evenly throughout
|
|
the array.
|
|
|
|
Inspired by Vimium.
|
|
|
|
Args:
|
|
hints: A list of hint strings.
|
|
length: Length of the available charset.
|
|
|
|
Return:
|
|
A list of shuffled hint strings.
|
|
"""
|
|
buckets = [[] for i in range(length)]
|
|
for i, hint in enumerate(hints):
|
|
buckets[i % len(buckets)].append(hint)
|
|
result = []
|
|
for bucket in buckets:
|
|
result += bucket
|
|
return result
|
|
|
|
def _number_to_hint_str(self, number, chars, digits=0):
|
|
"""Convert a number like "8" into a hint string like "JK".
|
|
|
|
This is used to sequentially generate all of the hint text.
|
|
The hint string will be "padded with zeroes" to ensure its length is >=
|
|
digits.
|
|
|
|
Inspired by Vimium.
|
|
|
|
Args:
|
|
number: The hint number.
|
|
chars: The charset to use.
|
|
digits: The minimum output length.
|
|
|
|
Return:
|
|
A hint string.
|
|
"""
|
|
base = len(chars)
|
|
hintstr = []
|
|
remainder = 0
|
|
while True:
|
|
remainder = number % base
|
|
hintstr.insert(0, chars[remainder])
|
|
number -= remainder
|
|
number //= base
|
|
if number <= 0:
|
|
break
|
|
# Pad the hint string we're returning so that it matches digits.
|
|
for _ in range(0, digits - len(hintstr)):
|
|
hintstr.insert(0, chars[0])
|
|
return ''.join(hintstr)
|
|
|
|
def _get_hint_css(self, elem, label=None):
|
|
"""Get the hint CSS for the element given.
|
|
|
|
Args:
|
|
elem: The QWebElement to get the CSS for.
|
|
label: The label QWebElement if display: none should be preserved.
|
|
|
|
Return:
|
|
The CSS to set as a string.
|
|
"""
|
|
if label is None or label['hidden'] != 'true':
|
|
display = 'inline'
|
|
else:
|
|
display = 'none'
|
|
|
|
# Make text uppercase if set in config
|
|
if config.get("hints","uppercase") and config.get("hints","mode") == "letter":
|
|
texttransform = 'uppercase'
|
|
else:
|
|
texttransform = 'none'
|
|
rect = elem.geometry()
|
|
left = rect.x()
|
|
top = rect.y()
|
|
if not config.get('ui', 'zoom-text-only'):
|
|
zoom = elem.webFrame().zoomFactor()
|
|
left /= zoom
|
|
top /= zoom
|
|
return self.HINT_CSS.format(
|
|
left=left, top=top, config=objreg.get('config'), display=display,
|
|
texttransform=texttransform)
|
|
|
|
def _draw_label(self, elem, string):
|
|
"""Draw a hint label over an element.
|
|
|
|
Args:
|
|
elem: The QWebElement to use.
|
|
string: The hint string to print.
|
|
|
|
Return:
|
|
The newly created label elment
|
|
"""
|
|
css = self._get_hint_css(elem)
|
|
doc = elem.webFrame().documentElement()
|
|
# It seems impossible to create an empty QWebElement for which isNull()
|
|
# is false so we can work with it.
|
|
# As a workaround, we use appendInside() with markup as argument, and
|
|
# then use lastChild() to get a reference to it.
|
|
# See: http://stackoverflow.com/q/7364852/2085149
|
|
doc.appendInside('<span class="qutehint" style="{}">{}</span>'.format(
|
|
css, string))
|
|
elem = webelem.WebElementWrapper(doc.lastChild())
|
|
elem['hidden'] = 'false'
|
|
return elem
|
|
|
|
def _click(self, elem):
|
|
"""Click an element.
|
|
|
|
Args:
|
|
elem: The QWebElement to click.
|
|
"""
|
|
if self._context.target == Target.rapid:
|
|
target = Target.tab_bg
|
|
elif self._context.target == Target.rapid_win:
|
|
target = Target.window
|
|
else:
|
|
target = self._context.target
|
|
self.set_open_target.emit(target.name)
|
|
# FIXME Instead of clicking the center, we could have nicer heuristics.
|
|
# e.g. parse (-webkit-)border-radius correctly and click text fields at
|
|
# the bottom right, and everything else on the top left or so.
|
|
# https://github.com/The-Compiler/qutebrowser/issues/70
|
|
pos = elem.rect_on_view().center()
|
|
log.hints.debug("Clicking on '{}' at {}/{}".format(
|
|
elem, pos.x(), pos.y()))
|
|
events = (
|
|
QMouseEvent(QEvent.MouseMove, pos, Qt.NoButton, Qt.NoButton,
|
|
Qt.NoModifier),
|
|
QMouseEvent(QEvent.MouseButtonPress, pos, Qt.LeftButton,
|
|
Qt.NoButton, Qt.NoModifier),
|
|
QMouseEvent(QEvent.MouseButtonRelease, pos, Qt.LeftButton,
|
|
Qt.NoButton, Qt.NoModifier),
|
|
)
|
|
for evt in events:
|
|
self.mouse_event.emit(evt)
|
|
|
|
def _yank(self, url):
|
|
"""Yank an element to the clipboard or primary selection.
|
|
|
|
Args:
|
|
url: The URL to open as a QURL.
|
|
"""
|
|
sel = self._context.target == Target.yank_primary
|
|
mode = QClipboard.Selection if sel else QClipboard.Clipboard
|
|
urlstr = url.toString(QUrl.FullyEncoded | QUrl.RemovePassword)
|
|
QApplication.clipboard().setText(urlstr, mode)
|
|
message.info(self._win_id, "URL yanked to {}".format(
|
|
"primary selection" if sel else "clipboard"))
|
|
|
|
def _preset_cmd_text(self, url):
|
|
"""Preset a commandline text based on a hint URL.
|
|
|
|
Args:
|
|
url: The URL to open as a QUrl.
|
|
"""
|
|
urlstr = url.toDisplayString(QUrl.FullyEncoded)
|
|
args = self._context.get_args(urlstr)
|
|
message.set_cmd_text(self._win_id, ' '.join(args))
|
|
|
|
def _download(self, elem):
|
|
"""Download a hint URL.
|
|
|
|
Args:
|
|
elem: The QWebElement to download.
|
|
"""
|
|
url = self._resolve_url(elem)
|
|
if url is None:
|
|
message.error(self._win_id,
|
|
"No suitable link found for this element.",
|
|
immediately=True)
|
|
return
|
|
objreg.get('download-manager').get(url, elem.webFrame().page())
|
|
|
|
def _call_userscript(self, url):
|
|
"""Call an userscript from a hint."""
|
|
cmd = self._context.args[0]
|
|
args = self._context.args[1:]
|
|
userscripts.run(cmd, *args, url=url, win_id=self._win_id)
|
|
|
|
def _spawn(self, url):
|
|
"""Spawn a simple command from a hint."""
|
|
urlstr = url.toString(QUrl.FullyEncoded | QUrl.RemovePassword)
|
|
args = self._context.get_args(urlstr)
|
|
subprocess.Popen(args)
|
|
|
|
def _resolve_url(self, elem, baseurl=None):
|
|
"""Resolve a URL and check if we want to keep it.
|
|
|
|
Args:
|
|
elem: The QWebElement to get the URL of.
|
|
baseurl: The baseurl of the current tab (overrides baseurl from
|
|
self._context).
|
|
|
|
Return:
|
|
A QUrl with the absolute URL, or None.
|
|
"""
|
|
try:
|
|
text = elem['href']
|
|
except KeyError:
|
|
return None
|
|
url = QUrl(text)
|
|
if not url.isValid():
|
|
return None
|
|
if url.isRelative():
|
|
if baseurl is None:
|
|
baseurl = self._context.baseurl
|
|
url = baseurl.resolved(url)
|
|
qtutils.ensure_valid(url)
|
|
return url
|
|
|
|
def _find_prevnext(self, frame, prev=False):
|
|
"""Find a prev/next element in frame."""
|
|
# First check for <link rel="prev(ious)|next">
|
|
elems = frame.findAllElements(
|
|
webelem.SELECTORS[webelem.Group.links])
|
|
rel_values = ('prev', 'previous') if prev else ('next')
|
|
for e in elems:
|
|
e = webelem.WebElementWrapper(e)
|
|
try:
|
|
rel_attr = e['rel']
|
|
except KeyError:
|
|
continue
|
|
if rel_attr in rel_values:
|
|
log.hints.debug("Found '{}' with rel={}".format(
|
|
e.debug_text(), rel_attr))
|
|
return e
|
|
# Then check for regular links/buttons.
|
|
elems = frame.findAllElements(
|
|
webelem.SELECTORS[webelem.Group.prevnext])
|
|
option = 'prev-regexes' if prev else 'next-regexes'
|
|
if not elems:
|
|
return None
|
|
for regex in config.get('hints', option):
|
|
log.hints.vdebug("== Checking regex '{}'.".format(regex.pattern))
|
|
for e in elems:
|
|
e = webelem.WebElementWrapper(e)
|
|
text = str(e)
|
|
if not text:
|
|
continue
|
|
if regex.search(text):
|
|
log.hints.debug("Regex '{}' matched on '{}'.".format(
|
|
regex.pattern, text))
|
|
return e
|
|
else:
|
|
log.hints.vdebug("No match on '{}'!".format(text))
|
|
return None
|
|
|
|
def _connect_frame_signals(self):
|
|
"""Connect the contentsSizeChanged signals to all frames."""
|
|
for f in self._context.frames:
|
|
log.hints.debug("Connecting frame {}".format(f))
|
|
f.contentsSizeChanged.connect(self.on_contents_size_changed)
|
|
|
|
def _check_args(self, target, *args):
|
|
"""Check the arguments passed to start() and raise if they're wrong.
|
|
|
|
Args:
|
|
target: A Target enum member.
|
|
args: Arguments for userscript/download
|
|
"""
|
|
if not isinstance(target, Target):
|
|
raise TypeError("Target {} is no Target member!".format(target))
|
|
if target in (Target.userscript, Target.spawn, Target.fill):
|
|
if not args:
|
|
raise cmdexc.CommandError(
|
|
"'args' is required with target userscript/spawn/fill.")
|
|
else:
|
|
if args:
|
|
raise cmdexc.CommandError(
|
|
"'args' is only allowed with target userscript/spawn.")
|
|
|
|
def _init_elements(self, mainframe, group):
|
|
"""Initialize the elements and labels based on the context set.
|
|
|
|
Args:
|
|
mainframe: The main QWebFrame.
|
|
group: A Group enum member (which elements to find).
|
|
"""
|
|
elems = []
|
|
for f in self._context.frames:
|
|
elems += f.findAllElements(webelem.SELECTORS[group])
|
|
elems = [e for e in elems if webelem.is_visible(e, mainframe)]
|
|
# We wrap the elements late for performance reasons, as wrapping 1000s
|
|
# of elements (with ~50 methods each) just takes too much time...
|
|
elems = [webelem.WebElementWrapper(e) for e in elems]
|
|
filterfunc = webelem.FILTERS.get(group, lambda e: True)
|
|
elems = [e for e in elems if filterfunc(e)]
|
|
if not elems:
|
|
raise cmdexc.CommandError("No elements found.")
|
|
strings = self._hint_strings(elems)
|
|
for e, string in zip(elems, strings):
|
|
label = self._draw_label(e, string)
|
|
self._context.elems[string] = ElemTuple(e, label)
|
|
keyparsers = objreg.get('keyparsers', scope='window',
|
|
window=self._win_id)
|
|
keyparser = keyparsers[usertypes.KeyMode.hint]
|
|
keyparser.update_bindings(strings)
|
|
|
|
def follow_prevnext(self, frame, baseurl, prev=False, tab=False,
|
|
background=False, window=False):
|
|
"""Click a "previous"/"next" element on the page.
|
|
|
|
Args:
|
|
frame: The frame where the element is in.
|
|
baseurl: The base URL of the current tab.
|
|
prev: True to open a "previous" link, False to open a "next" link.
|
|
tab: True to open in a new tab, False for the current tab.
|
|
background: True to open in a background tab.
|
|
window: True to open in a new window, False for the current one.
|
|
"""
|
|
elem = self._find_prevnext(frame, prev)
|
|
if elem is None:
|
|
raise cmdexc.CommandError("No {} links found!".format(
|
|
"prev" if prev else "forward"))
|
|
url = self._resolve_url(elem, baseurl)
|
|
if url is None:
|
|
raise cmdexc.CommandError("No {} links found!".format(
|
|
"prev" if prev else "forward"))
|
|
qtutils.ensure_valid(url)
|
|
if window:
|
|
main_window = objreg.get('main-window', scope='window',
|
|
window=self._win_id)
|
|
win_id = main_window.spawn()
|
|
tabbed_browser = objreg.get('tabbed-browser', scope='window',
|
|
window=win_id)
|
|
tabbed_browser.tabopen(url, background=False)
|
|
elif tab:
|
|
tabbed_browser = objreg.get('tabbed-browser', scope='window',
|
|
window=self._win_id)
|
|
tabbed_browser.tabopen(url, background=background)
|
|
else:
|
|
webview = objreg.get('webview', scope='tab', window=self._win_id,
|
|
tab=self._tab_id)
|
|
webview.openurl(url)
|
|
|
|
@cmdutils.register(instance='hintmanager', scope='tab', name='hint')
|
|
def start(self, group=webelem.Group.all, target=Target.normal,
|
|
*args: {'nargs': '*'}):
|
|
"""Start hinting.
|
|
|
|
Args:
|
|
group: The hinting mode to use.
|
|
|
|
- `all`: All clickable elements.
|
|
- `links`: Only links.
|
|
- `images`: Only images.
|
|
|
|
target: What to do with the selected element.
|
|
|
|
- `normal`: Open the link in the current tab.
|
|
- `tab`: Open the link in a new tab.
|
|
- `tab-bg`: Open the link in a new background tab.
|
|
- `window`: Open the link in a new window.
|
|
- `yank`: Yank the link to the clipboard.
|
|
- `yank-primary`: Yank the link to the primary selection.
|
|
- `fill`: Fill the commandline with the command given as
|
|
argument.
|
|
- `rapid`: Open the link in a new tab and stay in hinting mode.
|
|
- `rapid-win`: Open the link in a new window and stay in
|
|
hinting mode.
|
|
- `download`: Download the link.
|
|
- `userscript`: Call an userscript with `$QUTE_URL` set to the
|
|
link.
|
|
- `spawn`: Spawn a command.
|
|
|
|
*args: Arguments for spawn/userscript/fill.
|
|
|
|
- With `spawn`: The executable and arguments to spawn.
|
|
`{hint-url}` will get replaced by the selected
|
|
URL.
|
|
- With `userscript`: The userscript to execute.
|
|
- With `fill`: The command to fill the statusbar with.
|
|
`{hint-url}` will get replaced by the selected
|
|
URL.
|
|
"""
|
|
tabbed_browser = objreg.get('tabbed-browser', scope='window',
|
|
window=self._win_id)
|
|
widget = tabbed_browser.currentWidget()
|
|
if widget is None:
|
|
raise cmdexc.CommandError("No WebView available yet!")
|
|
mainframe = widget.page().mainFrame()
|
|
if mainframe is None:
|
|
raise cmdexc.CommandError("No frame focused!")
|
|
mode_manager = objreg.get('mode-manager', scope='window',
|
|
window=self._win_id)
|
|
if usertypes.KeyMode.hint in mode_manager.mode_stack:
|
|
raise cmdexc.CommandError("Already hinting!")
|
|
self._check_args(target, *args)
|
|
self._context = HintContext()
|
|
self._context.target = target
|
|
self._context.baseurl = tabbed_browser.current_url()
|
|
self._context.frames = webelem.get_child_frames(mainframe)
|
|
self._context.args = args
|
|
self._init_elements(mainframe, group)
|
|
message_bridge = objreg.get('message-bridge', scope='window',
|
|
window=self._win_id)
|
|
message_bridge.set_text(self.HINT_TEXTS[target])
|
|
self._connect_frame_signals()
|
|
try:
|
|
modeman.enter(self._win_id, usertypes.KeyMode.hint,
|
|
'HintManager.start')
|
|
except modeman.ModeLockedError:
|
|
self._cleanup()
|
|
|
|
def handle_partial_key(self, keystr):
|
|
"""Handle a new partial keypress."""
|
|
log.hints.debug("Handling new keystring: '{}'".format(keystr))
|
|
for (string, elems) in self._context.elems.items():
|
|
if string.startswith(keystr):
|
|
matched = string[:len(keystr)]
|
|
rest = string[len(keystr):]
|
|
elems.label.setInnerXml('<font color="{}">{}</font>{}'.format(
|
|
config.get('colors', 'hints.fg.match'), matched, rest))
|
|
if elems.label['hidden'] == 'true':
|
|
# hidden element which matches again -> unhide it
|
|
elems.label['hidden'] = 'false'
|
|
css = self._get_hint_css(elems.elem, elems.label)
|
|
elems.label['style'] = css
|
|
else:
|
|
# element doesn't match anymore -> hide it
|
|
elems.label['hidden'] = 'true'
|
|
css = self._get_hint_css(elems.elem, elems.label)
|
|
elems.label['style'] = css
|
|
|
|
def filter_hints(self, filterstr):
|
|
"""Filter displayed hints according to a text.
|
|
|
|
Args:
|
|
filterstr: The string to filer with, or None to show all.
|
|
"""
|
|
for elems in self._context.elems.values():
|
|
if (filterstr is None or
|
|
str(elems.elem).lower().startswith(filterstr)):
|
|
if elems.label['hidden'] == 'true':
|
|
# hidden element which matches again -> unhide it
|
|
elems.label['hidden'] = 'false'
|
|
css = self._get_hint_css(elems.elem, elems.label)
|
|
elems.label['style'] = css
|
|
else:
|
|
# element doesn't match anymore -> hide it
|
|
elems.label['hidden'] = 'true'
|
|
css = self._get_hint_css(elems.elem, elems.label)
|
|
elems.label['style'] = css
|
|
visible = {}
|
|
for k, e in self._context.elems.items():
|
|
if e.label['hidden'] != 'true':
|
|
visible[k] = e
|
|
if not visible:
|
|
# Whoops, filtered all hints
|
|
modeman.leave(self._win_id, usertypes.KeyMode.hint, 'all filtered')
|
|
elif len(visible) == 1 and config.get('hints', 'auto-follow'):
|
|
# unpacking gets us the first (and only) key in the dict.
|
|
self.fire(*visible)
|
|
|
|
def fire(self, keystr, force=False):
|
|
"""Fire a completed hint.
|
|
|
|
Args:
|
|
keystr: The keychain string to follow.
|
|
force: When True, follow even when auto-follow is false.
|
|
"""
|
|
if not (force or config.get('hints', 'auto-follow')):
|
|
self.handle_partial_key(keystr)
|
|
self._context.to_follow = keystr
|
|
return
|
|
# Handlers which take a QWebElement
|
|
elem_handlers = {
|
|
Target.normal: self._click,
|
|
Target.tab: self._click,
|
|
Target.tab_bg: self._click,
|
|
Target.window: self._click,
|
|
Target.rapid: self._click,
|
|
Target.rapid_win: self._click,
|
|
# _download needs a QWebElement to get the frame.
|
|
Target.download: self._download,
|
|
}
|
|
# Handlers which take a QUrl
|
|
url_handlers = {
|
|
Target.yank: self._yank,
|
|
Target.yank_primary: self._yank,
|
|
Target.fill: self._preset_cmd_text,
|
|
Target.userscript: self._call_userscript,
|
|
Target.spawn: self._spawn,
|
|
}
|
|
elem = self._context.elems[keystr].elem
|
|
if self._context.target in elem_handlers:
|
|
elem_handlers[self._context.target](elem)
|
|
elif self._context.target in url_handlers:
|
|
url = self._resolve_url(elem)
|
|
if url is None:
|
|
message.error(self._win_id,
|
|
"No suitable link found for this element.",
|
|
immediately=True)
|
|
return
|
|
url_handlers[self._context.target](url)
|
|
else:
|
|
raise ValueError("No suitable handler found!")
|
|
if self._context.target not in (Target.rapid, Target.rapid_win):
|
|
modeman.maybe_leave(self._win_id, usertypes.KeyMode.hint,
|
|
'followed')
|
|
else:
|
|
# Show all hints again
|
|
self.filter_hints(None)
|
|
# Undo keystring highlighting
|
|
for (string, elems) in self._context.elems.items():
|
|
elems.label.setInnerXml(string)
|
|
|
|
@cmdutils.register(instance='hintmanager', scope='tab', hide=True)
|
|
def follow_hint(self):
|
|
"""Follow the currently selected hint."""
|
|
if not self._context.to_follow:
|
|
raise cmdexc.CommandError("No hint to follow")
|
|
self.fire(self._context.to_follow, force=True)
|
|
|
|
@pyqtSlot('QSize')
|
|
def on_contents_size_changed(self, _size):
|
|
"""Reposition hints if contents size changed."""
|
|
log.hints.debug("Contents size changed...!")
|
|
for elems in self._context.elems.values():
|
|
if elems.elem.webFrame() is None:
|
|
# This sometimes happens for some reason...
|
|
elems.label.removeFromDocument()
|
|
continue
|
|
css = self._get_hint_css(elems.elem, elems.label)
|
|
elems.label['style'] = css
|
|
|
|
@pyqtSlot(usertypes.KeyMode)
|
|
def on_mode_left(self, mode):
|
|
"""Stop hinting when hinting mode was left."""
|
|
if mode != usertypes.KeyMode.hint or self._context is None:
|
|
# We have one HintManager per tab, so when this gets called,
|
|
# self._context might be None, because the current tab is not
|
|
# hinting.
|
|
return
|
|
self._cleanup()
|