Skip to content
D
Documentation

Browse articles by tag

task
4 min readUpdated

Browse articles by tag

A tag-filtered article list is the Home article list narrowed to one tag. Use it when you want to find articles grouped under the same subject label. The list belongs to the Home flow, alongside the lists reached through Your Feed and Global Feed.

If you need to…Go to
Open the list for a subject labelOpen a tag-filtered list
Recognize the tag list and its messagesRead the filtered list
Move through the resultsBrowse the article pages
Continue to general route guidanceNavigation basics
Read an article from the listRead an article

Before you start

You need the tag you want to browse, either as a tag link on Home or as the tag value for the tag route.

Prerequisites

  • You have a tag value to open.
  • If you start on Home, its tag list is available to select.

The tag route opens the Home article list for the tag value you provide. This task does not require entering information in a form; open a tag instead.

Result: You have a tag value and a starting point for opening its filtered list.

Open a tag-filtered list

Use a tag link when you are already on Home. If you already know the route value, open the tag route directly.

Prerequisites

  • You are on Home, or you know the tag value to use in the route.

Steps

  1. Choose one route to open the list:

    If you are trying to…Do this
    Browse a tag shown on HomeSelect the tag for the subject you want in Home’s tag list.
    Open a known tag directlyOpen the tag route with the tag value.

    Each tag link on Home opens the tag route with the selected tag value.

Result: The Home article-list surface opens with the selected tag in its tag tab.

Read the filtered list

The filtered list is the Home surface for finding articles under one tag. Read the active tag in the tag tab, the article results in the main list, and the available page numbers below the results.

AreaWhat you use it for
Your FeedOpen the following feed when you are authenticated.
Global FeedOpen the general article list.
Tag tabConfirm which tag filters the current list.
Article listRead the articles returned for the selected list.
Page numberMove to an available page of results after the articles load.
Tag listChoose another subject label from Home.

The Home page contains a tag list, an article list from Feed, Global, or Tag, and pagination for the article list. The tag tab appears when the route contains a tag, and the article list uses that route value as its filter.

Result: You can tell which tag is active, where its articles appear, and which page numbers are available.

Browse the article pages

An article page is one numbered portion of the selected tag's results. Use the page numbers to continue through the list without changing the tag filter.

Prerequisites

  • The tag-filtered Home list is open.
  • More than one article page is available.

Steps

  1. Select the page number you want to read.
  2. Read the articles shown for that page.

The article list requests 10 articles per page. When you select a page after page 1, the route includes its page query parameter. Returning to page 1 removes that parameter; the current feed parameter is preserved when one is present.

Result: The selected page of articles is displayed under the same tag filter. If a loading or empty message appears, use Handle loading and empty lists.

Handle loading and empty lists

The list gives you a different message while data is loading and when the completed request contains no results. Use the message you see to decide whether to wait, choose another tag, or switch to the general list.

What you seeWhat to do
Loading tags...Wait for the tag list to load.
No tags are here... yet.Open the tag route with a tag value.
Loading articles...Wait for the article list to load.
No articles are here... yet.Select another tag link.
Your feed is empty. Follow some users to see their articles here, or check out the Global Feed!Select Global Feed to open the general article list.

Result: You know whether the list is still loading or has finished with no articles or tags to display. When results are available, continue with Continue from the article list.

Continue from the article list

After browsing the filtered list, continue with the task that matches what you want to do next.

If you need to…Go to
Learn the wider Home and route navigationNavigation basics
Find articles in the general or following listFind articles in feeds
Continue with loading and unavailable statesLoading and unavailable states
Read an article you selectedRead an article

Result: You have either continued through the selected tag's article pages or moved to the page for the next article-list task.

Was this page helpful?

Download as PDF
Browse articles by tag — Conduit (Angular)