Home

• Overview
  • narrow-ui
  • Control bar
  • Term and Roles
• Specs
  • Flow of startup
• Narrow query

Overview

narrow-ui

Control bar

Term and Roles

• narrow-provider: Provide items to narrow and action to jump to item selected.
• narrow-ui: in most case, it means narrow-editor.
  • handles user input and update item list.
  • manage narrow-editor and control-bar, syntax highlight grammar.
• narrow-editor: text-editor where items are rendered and where you input narrow-query.

Provider

Spec

Narrow query

• Used to filter items on narrow-editor.
• You can input query on first line of narrow-editor.
• Basically query is matched as-is( No regular expression support currently ).
• Can chain multiple query separating by whilte-space.
  • e.g. foo bar means, select items matches foo and bar.
• * is treated as wildcard, internally converted to .* regular expression.
  • To search * itself, use * solely separate it by space.
  • Or use double **. ( e.g. To match to string *hello use **hello as query).
• ! is treated as negate, !foo means 'not matching foo'.
  • If config negateNarrowQueryByEndingExclamation set to true, you can also use foo!.
• Query case sensitivity is configurable with config caseSensitivityForNarrowQuery.
  • Can override global setting on each provider if you want.
• See also this issue
  • Query expressiveness