mirror of
https://github.com/xmonad/xmonad-contrib.git
synced 2025-05-19 03:20:21 -07:00
3d65a6bf72
Essentially, whenever the tutorial actually has decent material on the
subject matter. The replacement is roughly done as follows:
- logHook → tutorial
- keybindings → tutorial, as this is thoroughly covered
- manageHook → tutorial + X.D.Extending, as the manageHook stuff the
tutorial talks about is a little bit of an afterthought.
- X.D.Extending (on its own) → tutorial + X.D.Extending
- layoutHook → tutorial + X.D.Extending, as the tutorial, while
talking about layouts, doesn't necessarily have a huge focus there.
- mouse bindings → leave this alone, as the tutorial does not at all
talk about them.
152 lines
6.3 KiB
Haskell
152 lines
6.3 KiB
Haskell
{-# LANGUAGE FlexibleContexts, MultiParamTypeClasses, TypeSynonymInstances, PatternGuards #-}
|
|
|
|
----------------------------------------------------------------------------
|
|
-- |
|
|
-- Module : XMonad.Layout.Hidden
|
|
-- Description : Hide windows from layouts.
|
|
-- Copyright : (c) Peter Jones 2015
|
|
-- License : BSD3-style (see LICENSE)
|
|
--
|
|
-- Maintainer : pjones@devalot.com
|
|
-- Stability : unstable
|
|
-- Portability : not portable
|
|
--
|
|
-- Similar to "XMonad.Layout.Minimize" but completely removes windows
|
|
-- from the window set so "XMonad.Layout.BoringWindows" isn't
|
|
-- necessary. Perfect companion to
|
|
-- "XMonad.Layout.BinarySpacePartition" since it can be used to move
|
|
-- windows to another part of the BSP tree.
|
|
--
|
|
-----------------------------------------------------------------------------
|
|
module XMonad.Layout.Hidden
|
|
( -- * Usage
|
|
-- $usage
|
|
HiddenWindows
|
|
, HiddenMsg (..)
|
|
, hiddenWindows
|
|
, hideWindow
|
|
, popOldestHiddenWindow
|
|
, popNewestHiddenWindow
|
|
, popHiddenWindow
|
|
) where
|
|
|
|
--------------------------------------------------------------------------------
|
|
import XMonad
|
|
import XMonad.Layout.LayoutModifier
|
|
import qualified XMonad.StackSet as W
|
|
|
|
--------------------------------------------------------------------------------
|
|
-- $usage
|
|
-- You can use this module with the following in your @~\/.xmonad\/xmonad.hs@:
|
|
--
|
|
-- > import XMonad.Layout.Hidden
|
|
--
|
|
-- Then edit your @layoutHook@ by adding the @HiddenWindows@ layout modifier:
|
|
--
|
|
-- > myLayout = hiddenWindows (Tall 1 (3/100) (1/2)) ||| Full ||| etc..
|
|
-- > main = xmonad def { layoutHook = myLayout }
|
|
--
|
|
-- For more detailed instructions on editing the layoutHook see
|
|
-- <https://xmonad.org/TUTORIAL.html#customizing-xmonad the tutorial> and
|
|
-- "XMonad.Doc.Extending#Editing_the_layout_hook".
|
|
--
|
|
-- In the key bindings, do something like:
|
|
--
|
|
-- > , ((modMask, xK_backslash), withFocused hideWindow)
|
|
-- > , ((modMask .|. shiftMask, xK_backslash), popOldestHiddenWindow)
|
|
-- > ...
|
|
--
|
|
-- For detailed instruction on editing the key bindings see:
|
|
--
|
|
-- <https://xmonad.org/TUTORIAL.html#customizing-xmonad the tutorial>.
|
|
|
|
--------------------------------------------------------------------------------
|
|
newtype HiddenWindows a = HiddenWindows [Window] deriving (Show, Read)
|
|
|
|
--------------------------------------------------------------------------------
|
|
-- | Messages for the @HiddenWindows@ layout modifier.
|
|
data HiddenMsg = HideWindow Window -- ^ Hide a window.
|
|
| PopNewestHiddenWindow -- ^ Restore window (FILO).
|
|
| PopOldestHiddenWindow -- ^ Restore window (FIFO).
|
|
| PopSpecificHiddenWindow Window -- ^ Restore specific window.
|
|
deriving (Eq)
|
|
|
|
instance Message HiddenMsg
|
|
|
|
--------------------------------------------------------------------------------
|
|
instance LayoutModifier HiddenWindows Window where
|
|
handleMess h@(HiddenWindows hidden) mess
|
|
| Just (HideWindow win) <- fromMessage mess = hideWindowMsg h win
|
|
| Just PopNewestHiddenWindow <- fromMessage mess = popNewestMsg h
|
|
| Just PopOldestHiddenWindow <- fromMessage mess = popOldestMsg h
|
|
| Just (PopSpecificHiddenWindow win) <- fromMessage mess = popSpecificMsg win h
|
|
| Just ReleaseResources <- fromMessage mess = doUnhook
|
|
| otherwise = return Nothing
|
|
where doUnhook = do mapM_ restoreWindow hidden
|
|
return Nothing
|
|
|
|
modifierDescription _ = "Hidden"
|
|
|
|
--------------------------------------------------------------------------------
|
|
-- | Apply the @HiddenWindows@ layout modifier.
|
|
hiddenWindows :: LayoutClass l Window => l Window -> ModifiedLayout HiddenWindows l Window
|
|
hiddenWindows = ModifiedLayout $ HiddenWindows []
|
|
|
|
--------------------------------------------------------------------------------
|
|
-- | Remove the given window from the current layout. It is placed in
|
|
-- list of hidden windows so it can be restored later.
|
|
hideWindow :: Window -> X ()
|
|
hideWindow = sendMessage . HideWindow
|
|
|
|
--------------------------------------------------------------------------------
|
|
-- | Restore a previously hidden window. Using this function will
|
|
-- treat the list of hidden windows as a FIFO queue. That is, the
|
|
-- first window hidden will be restored.
|
|
popOldestHiddenWindow :: X ()
|
|
popOldestHiddenWindow = sendMessage PopOldestHiddenWindow
|
|
|
|
--------------------------------------------------------------------------------
|
|
-- | Restore a previously hidden window. Using this function will
|
|
-- treat the list of hidden windows as a FILO queue. That is, the
|
|
-- most recently hidden window will be restored.
|
|
popNewestHiddenWindow :: X ()
|
|
popNewestHiddenWindow = sendMessage PopNewestHiddenWindow
|
|
|
|
popHiddenWindow :: Window -> X ()
|
|
popHiddenWindow = sendMessage . PopSpecificHiddenWindow
|
|
|
|
--------------------------------------------------------------------------------
|
|
hideWindowMsg :: HiddenWindows a -> Window -> X (Maybe (HiddenWindows a))
|
|
hideWindowMsg (HiddenWindows hidden) win = do
|
|
modify (\s -> s { windowset = W.delete' win $ windowset s })
|
|
return . Just . HiddenWindows $ hidden ++ [win]
|
|
|
|
--------------------------------------------------------------------------------
|
|
popNewestMsg :: HiddenWindows a -> X (Maybe (HiddenWindows a))
|
|
popNewestMsg (HiddenWindows []) = return Nothing
|
|
popNewestMsg (HiddenWindows hidden) = do
|
|
let (win, rest) = (last hidden, init hidden)
|
|
restoreWindow win
|
|
return . Just . HiddenWindows $ rest
|
|
|
|
--------------------------------------------------------------------------------
|
|
popOldestMsg :: HiddenWindows a -> X (Maybe (HiddenWindows a))
|
|
popOldestMsg (HiddenWindows []) = return Nothing
|
|
popOldestMsg (HiddenWindows (win:rest)) = do
|
|
restoreWindow win
|
|
return . Just . HiddenWindows $ rest
|
|
|
|
--------------------------------------------------------------------------------
|
|
popSpecificMsg :: Window -> HiddenWindows a -> X (Maybe (HiddenWindows a))
|
|
popSpecificMsg _ (HiddenWindows []) = return Nothing
|
|
popSpecificMsg win (HiddenWindows hiddenWins) = if win `elem` hiddenWins
|
|
then do
|
|
restoreWindow win
|
|
return . Just . HiddenWindows $ filter (/= win) hiddenWins
|
|
else
|
|
return . Just . HiddenWindows $ hiddenWins
|
|
|
|
--------------------------------------------------------------------------------
|
|
restoreWindow :: Window -> X ()
|
|
restoreWindow = windows . W.insertUp
|