currentstyle dede是什么？

Of course! Let's break down what currentstyle is in the context of DedeCMS (织梦内容管理系统).

In short, currentstyle is a DedeCMS-specific global variable used to automatically apply a specific CSS class or style to the currently active link within a navigation menu or other link lists.

Its primary purpose is to make it incredibly easy to style the "current page" link differently from the others, which is a very common requirement for website navigation.

How It Works: The Core Concept

Imagine you have a standard navigation menu in your website's header:

<ul>
  <li><a href="index.php">Home</a></li>
  <li><a href="about.php">About Us</a></li>
  <li><a href="services.php">Services</a></li>
  <li><a href="contact.php">Contact</a></li>
</ul>

When a user is on the "About Us" page, you want that link to look different—maybe bold, with a different color, or with an underline. This tells the user, "You are here."

Without currentstyle, you would have to manually edit your template file for every single page to add a special class to the correct link. This is tedious and error-prone.

currentstyle automates this.

When you use the DedeCMS {dede:channel} or {dede:arclist} tags, DedeCMS checks the URL of the page being viewed. It then compares it to the URLs of the links generated by the tag. If a match is found, that specific link is wrapped with the HTML and class you define in the currentstyle attribute.

Practical Examples

The most common place to use currentstyle is with the {dede:channel} tag, which is used to generate navigation menus from the site's channel (category) structure.

Example 1: Basic Navigation Menu

Let's say you want to add the class current to the active link. Your DedeCMS template code would look like this:

{dede:channel type='top' currentstyle="<li class='current'><a href='~typelink~'>~typename~</a></li>"}
    <li><a href='[field:typelink/]'>[field:typename/]</a></li>
{/dede:channel}

How this works:

1. {dede:channel type='top' ...}: This tag gets all top-level channels (categories).
2. currentstyle="...": This is the key attribute. It defines the template for the active link.
   • ~typelink~ and ~typename~ are special placeholder variables that will be replaced by the actual link URL and channel name.
   • The result is a full <li> element with the class='current'.
3. <li><a href='[field:typelink/]'>[field:typename/]</a></li>: This is the default template for links that are not active. [field:typelink/] and [field:typename/] are the standard field variables.

What happens on the front-end:

• When a user is on the "Home" page (index.php):

  <ul>
    <li class="current"><a href="index.php">Home</a></li>
    <li><a href="about.php">About Us</a></li>
    <li><a href="services.php">Services</a></li>
    <li><a href="contact.php">Contact</a></li>
  </ul>

• When a user is on the "About Us" page (about.php):

  <ul>
    <li><a href="index.php">Home</a></li>
    <li class="current"><a href="about.php">About Us</a></li>
    <li><a href="services.php">Services</a></li>
    <li><a href="contact.php">Contact</a></li>
  </ul>

Example 2: Adding a Visual Indicator

You can also use currentstyle to add an icon or more complex styling.

{dede:channel type='top' currentstyle="<li class='active'><a href='~typelink~'>~typename~</a><span class='active-indicator'></span></li>"}
    <li><a href='[field:typelink/]'>[field:typename/]</a></li>
{/dede:channel}

With this CSS:

.active-indicator {
    display: inline-block;
    width: 0;
    height: 0;
    border-left: 5px solid #333;
    border-top: 5px solid transparent;
    border-bottom: 5px solid transparent;
    margin-left: 5px;
}

This would add a small arrow next to the name of the current page.

Key Parameters and Syntax

• Tag: Most commonly used with {dede:channel}.
• Attribute: currentstyle
• Syntax: currentstyle="<your_html_template_with_placeholders>"

Placeholders in currentstyle:

• ~typelink~: Replaced with the URL of the channel.
• ~typename~: Replaced with the name of the channel.

Commonly used parameters for {dede:channel}:

• type='top': Only shows top-level channels.
• type='son': Shows channels under the current channel.
• type='self': Shows the current channel and its sub-channels.
• row='10': Limits the number of channels displayed.

Important Considerations

1. Use with {dede:arclist}: While most common with {dede:channel}, currentstyle can also be used with {dede:arclist} to highlight an article if the article's link matches the current page URL. This is useful for "related articles" or "article lists" where you want to highlight the current article in the list.

2. Performance: For very large sites with thousands of channels, using complex currentstyle logic might have a negligible impact on performance, but for standard navigation, it's highly efficient.

3. CSS Styling: The currentstyle attribute only provides the HTML structure. You must define the styles for the class you use (e.g., .current, .active) in your website's CSS file for the visual effect to appear.

   /* Example CSS */
   .current a {
       color: #ff6600;
       font-weight: bold;
   }

Summary