Trees and taxonomies with Ancestry
November 16, 2010
Ancestry is a handy gem for building tree structures or taxonomies in your Rails applications. It’s similar to the likes of the acts_as_tree plugin (see the Railscasts tutorial). The project wiki has several ideas for ways to put Ancestry to use; in this post I’ll cover a couple of basic uses to get you rolling with some common applications of the gem.
Follow the instructions provided in Ancestry’s README to add it to your application. It’s very straightforward: Install the gem, generate and run a migration, and add
has_ancestry to any model you’d like to turn into a tree. For example, you might have a hierarchy of categories; once you’ve installed Ancestry this can be created with
The nice thing about Ancestry is how easy it makes it to work with a given object in your tree, its parents, and its children. It does this through more than 20 useful instance methods and several scopes. Among the ones you may want to start with:
- Roots: To get a collection of the Category taxonomy’s top-level nodes, just call
- Children: Pretty straightforward;
@category.children gives you a collection of a given category’s subcategories.
- Ancestors: A category’s ancestry—its parent, grandparent, and on back—is accessible with
- Parent: You’ve probably guessed it;
@category.parent will give you the category’s parent category. Useful if you want to include a back link in your view.
A practical use of Ancestry is to help visitors navigate your site through breadcrumbs. This is easy to add to your view:
That’s all there is to it to help your site visitors navigate your content more easily.
blog comments powered by
Rails testing made simple
Learn to test Rails apps the way
I learned, building up tests step-by-step, in
Everyday Rails Testing
Expanded to include exclusive content and a complete sample Rails application.
Learn more »