author | Sylvain Thénault <sylvain.thenault@logilab.fr> |
Mon, 12 Oct 2009 12:54:01 +0200 | |
branch | stable |
changeset 3638 | 648d6dbec630 |
parent 3018 | e872e57e70d0 |
child 3023 | 7864fee8b4ec |
child 3689 | deb13e88e037 |
permissions | -rw-r--r-- |
0 | 1 |
"""navigation components definition for CubicWeb web client |
2 |
||
3 |
:organization: Logilab |
|
1977
606923dff11b
big bunch of copyright / docstring update
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
1723
diff
changeset
|
4 |
:copyright: 2001-2009 LOGILAB S.A. (Paris, FRANCE), license is LGPL v2. |
0 | 5 |
:contact: http://www.logilab.fr/ -- mailto:contact@logilab.fr |
1977
606923dff11b
big bunch of copyright / docstring update
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
1723
diff
changeset
|
6 |
:license: GNU Lesser General Public License, v2.1 - http://www.gnu.org/licenses |
0 | 7 |
""" |
8 |
__docformat__ = "restructuredtext en" |
|
2259 | 9 |
_ = unicode |
0 | 10 |
|
11 |
from rql.nodes import VariableRef, Constant |
|
12 |
||
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
13 |
from logilab.mtconverter import xml_escape |
2613
5e19c2bb370e
R [all] logilab.common 0.44 provides only deprecated
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2381
diff
changeset
|
14 |
from logilab.common.deprecation import deprecated |
0 | 15 |
|
16 |
from cubicweb.interfaces import IPrevNext |
|
692
800592b8d39b
replace deprecated cubicweb.common.selectors by its new module path (cubicweb.selectors)
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
588
diff
changeset
|
17 |
from cubicweb.selectors import (paginated_rset, sorted_rset, |
800592b8d39b
replace deprecated cubicweb.common.selectors by its new module path (cubicweb.selectors)
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
588
diff
changeset
|
18 |
primary_view, match_context_prop, |
800592b8d39b
replace deprecated cubicweb.common.selectors by its new module path (cubicweb.selectors)
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
588
diff
changeset
|
19 |
one_line_rset, implements) |
0 | 20 |
from cubicweb.common.uilib import cut |
21 |
from cubicweb.web.component import EntityVComponent, NavigationComponent |
|
22 |
||
23 |
||
24 |
class PageNavigation(NavigationComponent): |
|
25 |
||
26 |
def call(self): |
|
27 |
"""displays a resultset by page""" |
|
28 |
w = self.w |
|
29 |
req = self.req |
|
30 |
rset = self.rset |
|
31 |
page_size = self.page_size |
|
32 |
start = 0 |
|
33 |
blocklist = [] |
|
34 |
params = dict(req.form) |
|
35 |
self.clean_params(params) |
|
36 |
basepath = req.relative_path(includeparams=False) |
|
37 |
while start < rset.rowcount: |
|
38 |
stop = min(start + page_size - 1, rset.rowcount - 1) |
|
39 |
blocklist.append(self.page_link(basepath, params, start, stop, |
|
588
f37ee42cd0e9
permit override of display index on simple navigation
Arthur Lutz <arthur.lutz@logilab.fr>
parents:
445
diff
changeset
|
40 |
self.index_display(start, stop))) |
0 | 41 |
start = stop + 1 |
42 |
w(u'<div class="pagination">') |
|
3014
62ce5a139b52
[page nav] previous/next page links should also consider url's base path
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2996
diff
changeset
|
43 |
w(u'%s ' % self.previous_link(basepath, params)) |
2996
866a2c135c33
B #345282 xhtml requires to use   instead of
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2650
diff
changeset
|
44 |
w(u'[ %s ]' % u' | '.join(blocklist)) |
3014
62ce5a139b52
[page nav] previous/next page links should also consider url's base path
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2996
diff
changeset
|
45 |
w(u' %s' % self.next_link(basepath, params)) |
0 | 46 |
w(u'</div>') |
1657
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
47 |
|
588
f37ee42cd0e9
permit override of display index on simple navigation
Arthur Lutz <arthur.lutz@logilab.fr>
parents:
445
diff
changeset
|
48 |
def index_display(self, start, stop): |
f37ee42cd0e9
permit override of display index on simple navigation
Arthur Lutz <arthur.lutz@logilab.fr>
parents:
445
diff
changeset
|
49 |
return u'%s - %s' % (start+1, stop+1) |
0 | 50 |
|
2058
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
51 |
|
0 | 52 |
class SortedNavigation(NavigationComponent): |
53 |
"""sorted navigation apply if navigation is needed (according to page size) |
|
54 |
and if the result set is sorted |
|
55 |
""" |
|
742
99115e029dca
replaced most of __selectors__ assignments with __select__
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
692
diff
changeset
|
56 |
__select__ = paginated_rset() & sorted_rset() |
1657
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
57 |
|
0 | 58 |
# number of considered chars to build page links |
59 |
nb_chars = 5 |
|
1657
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
60 |
|
0 | 61 |
def display_func(self, rset, col, attrname): |
62 |
req = self.req |
|
63 |
if attrname is not None: |
|
64 |
def index_display(row): |
|
65 |
entity = rset.get_entity(row, col) |
|
66 |
return entity.printable_value(attrname, format='text/plain') |
|
67 |
elif self.schema.eschema(rset.description[0][col]).is_final(): |
|
68 |
def index_display(row): |
|
69 |
return unicode(rset[row][col]) |
|
70 |
else: |
|
71 |
def index_display(row): |
|
72 |
return rset.get_entity(row, col).view('text') |
|
73 |
return index_display |
|
1657
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
74 |
|
0 | 75 |
def call(self): |
76 |
"""displays links to navigate accross pages of a result set |
|
77 |
||
78 |
Displayed result is done according to a variable on which the sort |
|
79 |
is done, and looks like: |
|
80 |
[ana - cro] | [cro - ghe] | ... | [tim - zou] |
|
81 |
""" |
|
82 |
w = self.w |
|
83 |
rset = self.rset |
|
84 |
page_size = self.page_size |
|
85 |
rschema = self.schema.rschema |
|
86 |
# attrname = the name of attribute according to which the sort |
|
87 |
# is done if any |
|
88 |
for sorterm in rset.syntax_tree().children[0].orderby: |
|
89 |
if isinstance(sorterm.term, Constant): |
|
90 |
col = sorterm.term.value - 1 |
|
91 |
index_display = self.display_func(rset, col, None) |
|
92 |
break |
|
93 |
var = sorterm.term.get_nodes(VariableRef)[0].variable |
|
94 |
col = None |
|
95 |
for ref in var.references(): |
|
96 |
rel = ref.relation() |
|
97 |
if rel is None: |
|
98 |
continue |
|
99 |
attrname = rel.r_type |
|
100 |
if attrname == 'is': |
|
101 |
continue |
|
102 |
if not rschema(attrname).is_final(): |
|
103 |
col = var.selected_index() |
|
104 |
attrname = None |
|
105 |
if col is None: |
|
106 |
# final relation or not selected non final relation |
|
107 |
if var is rel.children[0]: |
|
108 |
relvar = rel.children[1].children[0].get_nodes(VariableRef)[0] |
|
109 |
else: |
|
110 |
relvar = rel.children[0].variable |
|
111 |
col = relvar.selected_index() |
|
112 |
if col is not None: |
|
113 |
break |
|
114 |
else: |
|
115 |
# no relation but maybe usable anyway if selected |
|
116 |
col = var.selected_index() |
|
117 |
attrname = None |
|
118 |
if col is not None: |
|
119 |
index_display = self.display_func(rset, col, attrname) |
|
120 |
break |
|
121 |
else: |
|
122 |
# nothing usable found, use the first column |
|
123 |
index_display = self.display_func(rset, 0, None) |
|
124 |
blocklist = [] |
|
125 |
params = dict(self.req.form) |
|
126 |
self.clean_params(params) |
|
127 |
start = 0 |
|
128 |
basepath = self.req.relative_path(includeparams=False) |
|
129 |
while start < rset.rowcount: |
|
130 |
stop = min(start + page_size - 1, rset.rowcount - 1) |
|
131 |
cell = self.format_link_content(index_display(start), index_display(stop)) |
|
132 |
blocklist.append(self.page_link(basepath, params, start, stop, cell)) |
|
133 |
start = stop + 1 |
|
3014
62ce5a139b52
[page nav] previous/next page links should also consider url's base path
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2996
diff
changeset
|
134 |
self.write_links(basepath, params, blocklist) |
0 | 135 |
|
136 |
def format_link_content(self, startstr, stopstr): |
|
137 |
text = u'%s - %s' % (startstr.lower()[:self.nb_chars], |
|
138 |
stopstr.lower()[:self.nb_chars]) |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
139 |
return xml_escape(text) |
0 | 140 |
|
3014
62ce5a139b52
[page nav] previous/next page links should also consider url's base path
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2996
diff
changeset
|
141 |
def write_links(self, basepath, params, blocklist): |
0 | 142 |
self.w(u'<div class="pagination">') |
3014
62ce5a139b52
[page nav] previous/next page links should also consider url's base path
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2996
diff
changeset
|
143 |
self.w(u'%s ' % self.previous_link(basepath, params)) |
2996
866a2c135c33
B #345282 xhtml requires to use   instead of
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2650
diff
changeset
|
144 |
self.w(u'[ %s ]' % u' | '.join(blocklist)) |
3014
62ce5a139b52
[page nav] previous/next page links should also consider url's base path
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2996
diff
changeset
|
145 |
self.w(u' %s' % self.next_link(basepath, params)) |
0 | 146 |
self.w(u'</div>') |
147 |
||
148 |
||
588
f37ee42cd0e9
permit override of display index on simple navigation
Arthur Lutz <arthur.lutz@logilab.fr>
parents:
445
diff
changeset
|
149 |
def limit_rset_using_paged_nav(self, req, rset, w, forcedisplay=False, |
873 | 150 |
show_all_option=True, page_size=None): |
2058
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
151 |
if not (forcedisplay or req.form.get('__force_display') is not None): |
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
152 |
nav = self.vreg['components'].select_object('navigation', req, |
2058
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
153 |
rset=rset, page_size=page_size) |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
154 |
if nav: |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
155 |
# get boundaries before component rendering |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
156 |
start, stop = nav.page_boundaries() |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
157 |
nav.render(w=w) |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
158 |
params = dict(req.form) |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
159 |
nav.clean_params(params) |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
160 |
# make a link to see them all |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
161 |
if show_all_option: |
2381 | 162 |
url = xml_escape(self.build_url(__force_display=1, **params)) |
3018 | 163 |
w(u'<span><a href="%s">%s</a></span>\n' |
2058
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
164 |
% (url, req._('show %s results') % len(rset))) |
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
165 |
rset.limit(offset=start, limit=stop-start, inplace=True) |
0 | 166 |
|
167 |
||
168 |
# monkey patch base View class to add a .pagination(req, rset, w, forcedisplay) |
|
169 |
# method to be called on view's result set and printing pages index in the view |
|
834 | 170 |
from cubicweb.view import View |
2613
5e19c2bb370e
R [all] logilab.common 0.44 provides only deprecated
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2381
diff
changeset
|
171 |
View.pagination = deprecated('.pagination is deprecated, use paginate')(limit_rset_using_paged_nav) |
0 | 172 |
|
1657
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
173 |
def paginate(view, show_all_option=True, w=None, page_size=None): |
0 | 174 |
limit_rset_using_paged_nav(view, view.req, view.rset, w or view.w, |
1657
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
175 |
not view.need_navigation, show_all_option, |
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
176 |
page_size=page_size) |
0 | 177 |
View.paginate = paginate |
178 |
||
179 |
class NextPrevNavigationComponent(EntityVComponent): |
|
180 |
id = 'prevnext' |
|
181 |
# register msg not generated since no entity implements IPrevNext in cubicweb |
|
182 |
# itself |
|
183 |
title = _('contentnavigation_prevnext') |
|
184 |
help = _('contentnavigation_prevnext_description') |
|
742
99115e029dca
replaced most of __selectors__ assignments with __select__
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
692
diff
changeset
|
185 |
__select__ = (one_line_rset() & primary_view() |
99115e029dca
replaced most of __selectors__ assignments with __select__
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
692
diff
changeset
|
186 |
& match_context_prop() & implements(IPrevNext)) |
0 | 187 |
context = 'navbottom' |
188 |
order = 10 |
|
189 |
def call(self, view=None): |
|
190 |
entity = self.entity(0) |
|
191 |
previous = entity.previous_entity() |
|
192 |
next = entity.next_entity() |
|
193 |
if previous or next: |
|
194 |
textsize = self.req.property_value('navigation.short-line-size') |
|
195 |
self.w(u'<div class="prevnext">') |
|
196 |
if previous: |
|
197 |
self.w(u'<div class="previousEntity left">') |
|
198 |
self.w(self.previous_link(previous, textsize)) |
|
199 |
self.w(u'</div>') |
|
200 |
self.req.html_headers.add_raw('<link rel="prev" href="%s" />' |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
201 |
% xml_escape(previous.absolute_url())) |
0 | 202 |
if next: |
203 |
self.w(u'<div class="nextEntity right">') |
|
204 |
self.w(self.next_link(next, textsize)) |
|
205 |
self.w(u'</div>') |
|
206 |
self.req.html_headers.add_raw('<link rel="next" href="%s" />' |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
207 |
% xml_escape(next.absolute_url())) |
0 | 208 |
self.w(u'</div>') |
209 |
self.w(u'<div class="clear"></div>') |
|
210 |
||
211 |
def previous_link(self, previous, textsize): |
|
212 |
return u'<a href="%s" title="%s"><< %s</a>' % ( |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
213 |
xml_escape(previous.absolute_url()), |
0 | 214 |
self.req._('i18nprevnext_previous'), |
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
215 |
xml_escape(cut(previous.dc_title(), textsize))) |
1657
14e95f7aa033
delete-trailing-whitespaces, add page_size argument to .paginate
sylvain.thenault@logilab.fr
parents:
873
diff
changeset
|
216 |
|
0 | 217 |
def next_link(self, next, textsize): |
218 |
return u'<a href="%s" title="%s">%s >></a>' % ( |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
219 |
xml_escape(next.absolute_url()), |
0 | 220 |
self.req._('i18nprevnext_next'), |
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2259
diff
changeset
|
221 |
xml_escape(cut(next.dc_title(), textsize))) |