Skip to content

Latest commit

 

History

History
166 lines (119 loc) · 9.2 KB

README.md

File metadata and controls

166 lines (119 loc) · 9.2 KB

Angular Mode

Angular Mode enhances your workflow by providing an interactive API for Angular CLI commands and allows you to quickly open schematic files such as components, services, and more through a dedicated keymap. Additionally, you can conveniently jump between corresponding component files, such as templates, components, tests, and stylesheets.

Keybindings

Keybinding Command Description Command
C-c a g Generate an Angular Schematic. angular-generate
C-c a o c Open a component.ts file. angular-open-component
C-c a o t Open a component.html file. angular-open-component-template
C-c a o v Open a component.(scss|sass|less|css) file. angular-open-component-stylesheet
C-c a o x Open a component.spec.ts file. angular-open-component-test
C-c a o d Open a directive.ts file. angular-open-directive
C-c a o g Open a guard.ts file. angular-open-guard
C-c a o i Open a interceptor.ts file. angular-open-interceptor
C-c a o m Open a module.ts file. angular-open-module
C-c a o p Open a pipe.ts file. angular-open-pipe
C-c a o r Open a resolver.ts file. angular-open-resolver
C-c a o s Open a service.ts file. angular-open-service
C-c a o w Open a worker.ts file. angular-open-web-worker
C-c a j c Jump to associated component.ts file. angular-jump-to-component
C-c a j t Jump to associated component.html file. angular-jump-to-template
C-c a j v Jump to associated component.(scss|sass|less|css) file. angular-jump-to-stylesheet
C-c a j x Jump to associated component.spec.ts file. angular-jump-to-test
C-c a m d Move a directory to a new destination and update import paths for all entities within the directory. angular-move-directory
C-c a m f Move a file and associated spec file to a new destination and update import paths for those files. angular-move-file
C-c a p Open the project's angular.json file. angular-project-config
C-c a h d Lookup current word at point in API reference documentation website. angular-lookup-word
C-c a h s Perform a search of angular.io using the current word at point. angular-search-word

Note: At the moment, Angular Mode only supports the generate commands.

Getting Started

To utilize this package, activate angular-mode to access the keybinding for generating schematics within your Angular project. Additionally, you can use M-x angular-generate to generate schematics.

Generate Angular Schematic

Using the C-c a g command, you can perform the following:

  • Choose a schematic from the list.
  • Specify a name for the selected schematic.
  • Pick a destination directory for the scaffolded file(s).

Quick Open Angular Files

Angular Mode offers convenient shortcuts to quickly open files for various Angular scaffolded files by using the C-c a o prefix. This will provide a filtered list of files based on the schematic type. See the list of corresponding keybindings.

Examples:

  • Component: Open a component.ts file - C-c a o c
  • Service: Open a service.ts file - C-c a o s
  • Module: Open a module.ts file - C-c a o m

Jump Between Corresponding Files

Angular Mode provides an easy way to help you jump between associated Angular files with ease. Whether you're working with components, services, resolvers, etc., you can quickly switch between the following file types:

  • Template: Jump to the associated .html file - C-c a j t
  • Component: Jump to the associated .ts file - C-c a j c
  • Test: Jump to the associated .spec.ts file - C-c a j x
  • Stylesheet: Jump to the associated .scss, .less, .sass, or .css file - C-c a j v

Moving Files and Directories

Tired of manually updating import paths when moving files around and wasting a bunch of time? Me too!

Now you can do it in seconds by using M-x angular-move-directory (C-c a m d) to move an entire directory of angular files or M-x angular-move-file (C-c a m f) to move a specific file (and associated spec file if it exists) to the destination of your choosing.

Upon move, every import path that references the moved files will automatically update to the new path. If you have a preference on using relative vs. absolute, you can customize angular-import-path-style (defaults to relative) by using the customize interface or by adding this to your config:

(setopt angular-import-path-style 'absolute)

Tips: Use angular-move-directory if you want to move a component, module, or anything that may have multiple associated files and are contained in a directory.

Use angular-move-file if you want to move a service, resolver, or anything that is a scaffolded file + an associated .spec.ts file (if it exists).

Disclaimers:

  • The move functions may change a large amount of files. Make sure you have a backup or have version control in place in case you need to revert.
  • The move functions do not support custom modules. This means any import path that references a custom module will not be updated.
  • If you move files from one module to another, you'll need to manually update those imports if you no longer want the original module importing those files.

Navigate to Component Definitions

Angular Mode supports navigating to the definition of Angular components directly from template files by using M-. (xref-find-definitions).

Installation

You can install angular-mode manually or via a package manager.

Manual Installation

  1. Clone or download this repository to your local machine.

    git clone https://github.com/kborling/angular-mode.git
  2. Add the following to your Emacs configuration file:

    (add-to-list 'load-path "/path/to/angular-mode")
    (require 'angular-mode)

Install Using a Package Manager

You can install angular-mode using popular package managers such as Straight and Elpaca. Choose the method that suits your preference:

Straight

(straight-use-package
  '(angular-mode :type git :host github :repo "kborling/angular-mode"))
;; Using the use-package integration
(use-package angular-mode
  :straight (angular-mode :host github :repo "kborling/angular-mode" :files ("*.el")))

Elpaca

(use-package angular-mode
  :ensure (angular-mode :host github :repo "kborling/angular-mode" :files ("*.el")))

Doom Emacs

(package! angular-mode
  :recipe (:host github :repo "kborling/angular-mode"))

Spacemacs

(angular-mode :location (recipe :fetcher github :repo "kborling/angular-mode"))

Configuration

Setting angular-cli executable

angular-mode assumes the Angular CLI tool is installed globally. If that's not the case, set the angular-cli-executable:

(setq angular-cli-executable "/path/to/ng/command")

Global Activation

To activate angular-mode globally, add the following:

(global-angular-mode 1)

Project Setup

To activate angular-mode automatically for a specific project, follow these steps:

  1. In your project root directory, create a .dir-locals.el file if it doesn't already exist.

  2. Open the .dir-locals.el file and add the following:

((nil . ((mode . angular))))
  1. Save the .dir-locals.el file.

This will automatically activate angular-mode when visiting any file within the project.