tonyair/silverstripe-framework
1
0
Fork 0
mirror of https://github.com/silverstripe/silverstripe-framework synced 2024-10-22 14:05:37 +02:00
Code Issues Projects Releases Wiki Activity

Merge pull request #3261 from oceanmountain/patch-1

Browse Source 
Update templates.md
This commit is contained in:
Sam Minnée 2014-07-05 14:23:20 +12:00
commit 2a3eebf6df
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/en/reference/templates.md
View File

@ -641,9 +641,9 @@ default if it exists and there is no action in the url parameters.
} }
} }
## Fragment Link rewriting ## Anchor Link rewriting
Fragment links are links with a "#" in them. A frequent use-case is to use fragment links to point to different Anchor links are links with a "#" in them. A frequent use-case is to use anchor links to point to different
sections of the current page. For example, we might have this in our template. sections of the current page. For example, we might have this in our template.
For, example, we might have this on http://www.example.com/my-long-page/ For, example, we might have this on http://www.example.com/my-long-page/
@ -659,8 +659,8 @@ So far, so obvious. However, things get tricky because of we have set our `<bas
site. So, when you click the first link you will be sent to http://www.example.com/#section1 instead of site. So, when you click the first link you will be sent to http://www.example.com/#section1 instead of
http://www.example.com/my-long-page/#section1 http://www.example.com/my-long-page/#section1
In order to prevent this situation, the SSViewer template renderer will automatically rewrite any fragment link that In order to prevent this situation, the SSViewer template renderer will automatically rewrite any anchor link that
doesn't specify a URL before the fragment, prefixing the URL of the current page. For our example above, the following doesn't specify a URL before the anchor, prefixing the URL of the current page. For our example above, the following
would be created: would be created:
:::ss :::ss
@ -670,8 +670,8 @@ would be created:
</ul> </ul>
There are cases where this can be unhelpful. HTML fragments created from Ajax responses are the most common. In these There are cases where this can be unhelpful. HTML anchors created from Ajax responses are the most common. In these
situations, you can disable fragment link rewriting by setting the situations, you can disable anchor link rewriting by setting the
`SSViewer.rewrite_hash_links` configuration value to `false`. `SSViewer.rewrite_hash_links` configuration value to `false`.
### More Advanced Controls ### More Advanced Controls